dicebear

<h1><img src="https://www.dicebear.com/logo-readme.svg" width="28" /> DiceBear Avatar Library</h1>

<p>
  <img src="https://www.dicebear.com/readme-hero.svg" alt="A grid of DiceBear avatars in twenty-four different styles" width="100%" />
</p>

[![npm](https://www.dicebear.com/badges/npm.svg)](https://www.npmjs.com/package/@dicebear/core)
[![stars](https://www.dicebear.com/badges/stars.svg)](https://github.com/dicebear/dicebear/stargazers)
[![license](https://www.dicebear.com/badges/license.svg)](./LICENSE)

DiceBear is an open source avatar library. It turns any seed string (a username
or an email address, for example) into an SVG avatar in one of 63 styles, from
hand-drawn characters to abstract patterns. The same seed always produces the
same avatar, so you store a string instead of an image and never ask users to
upload a profile picture.

Avatars are customizable through style options: colors, backgrounds, rotation,
individual features like hair or glasses.

[Playground](https://www.dicebear.com/playground) |
[Documentation](https://www.dicebear.com/start/what-is-dicebear/) |
[Editor](https://editor.dicebear.com)

## One library, seven languages

DiceBear 10 ships as native libraries for JavaScript, PHP, Python, Rust, Go,
Dart, and C#. Every port passes a shared test suite that requires byte-identical
SVG output to the JavaScript reference. Generate an avatar in the browser,
regenerate it later in a Go or PHP backend, and you get the same bytes.

| Language                | Package                                                                 | Install                                      |
| ----------------------- | ----------------------------------------------------------------------- | -------------------------------------------- |
| JavaScript / TypeScript | [`@dicebear/core`](https://www.npmjs.com/package/@dicebear/core)        | `npm install @dicebear/core`                 |
| PHP                     | [`dicebear/core`](https://packagist.org/packages/dicebear/core)         | `composer require dicebear/core`             |
| Python                  | [`dicebear-core`](https://pypi.org/project/dicebear-core/)              | `pip install dicebear-core`                  |
| Rust                    | [`dicebear-core`](https://crates.io/crates/dicebear-core)               | `cargo add dicebear-core`                    |
| Go                      | [`dicebear-go`](https://pkg.go.dev/github.com/dicebear/dicebear-go/v11) | `go get github.com/dicebear/dicebear-go/v11` |
| Dart                    | [`dicebear_core`](https://pub.dev/packages/dicebear_core)               | `dart pub add dicebear_core`                 |
| C#                      | [`DiceBear.Core`](https://www.nuget.org/packages/DiceBear.Core)         | `dotnet add package DiceBear.Core`           |

In JavaScript it looks like this; the
[documentation](https://www.dicebear.com/start/what-is-dicebear/) has the
equivalent for each language:

```js
import { Avatar, Style } from '@d