PHPackages                             dicebear/styles - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. dicebear/styles

ActiveLibrary[Image & Media](/categories/media)

dicebear/styles
===============

Official DiceBear avatar styles.

v10.2.0(1mo ago)511.6k↑132.1%1ShellCI passing

Since Sep 29Pushed 3w ago2 watchersCompare

[ Source](https://github.com/dicebear/styles)[ Packagist](https://packagist.org/packages/dicebear/styles)[ RSS](/packages/dicebear-styles/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)DependenciesVersions (23)Used By (0)

DiceBear avatar styles
======================

[](#dicebear-avatar-styles)

This repository contains all official avatar style definitions for [DiceBear](https://www.dicebear.com). An avatar style definition is a JSON file that describes how to create an avatar. It contains all necessary information like available elements and colors. The JSON files are ideal for creating avatars in different programming languages with the corresponding DiceBear wrapper. The JSON schema for the avatar style definitions can be found in the [`@dicebear/schema`](https://github.com/dicebear/schema) package.

Generate definitions
--------------------

[](#generate-definitions)

Most of the JSON files were created using the [DiceBear Exporter](https://www.dicebear.com/guides/create-an-avatar-style-with-figma/)for Figma. The used Figma files are linked in the `figma` folder. Files created with this plugin are marked accordingly and should not be adjusted manually, but exported again with the Figma plugin.

Usage
-----

[](#usage)

**JavaScript**

```
npm install @dicebear/styles
```

```
import adventurer from '@dicebear/styles/adventurer.json' with { type: 'json' };
import lorelei from '@dicebear/styles/lorelei.json' with { type: 'json' };
```

**PHP**

```
composer require dicebear/styles
```

```
$basePath = \Composer\InstalledVersions::getInstallPath('dicebear/styles');

$adventurer = json_decode(file_get_contents($basePath . '/src/adventurer.json'), true);
$lorelei    = json_decode(file_get_contents($basePath . '/src/lorelei.json'), true);
```

**Python**

```
pip install dicebear-styles
```

```
import json
from importlib.resources import files

adventurer = json.loads(files('dicebear_styles').joinpath('adventurer.json').read_text('utf-8'))
lorelei    = json.loads(files('dicebear_styles').joinpath('lorelei.json').read_text('utf-8'))
```

**Rust**

Each style is gated behind a feature of the same name, so a binary only embeds the styles it opts into (use the `all` feature to pull in every style):

```
cargo add dicebear-styles --features adventurer,lorelei
```

The enabled styles are embedded at compile time and exposed as raw JSON (`&'static str`). Parse them with `serde_json`:

```
use dicebear_styles::{ADVENTURER, LORELEI};

let adventurer: serde_json::Value = serde_json::from_str(ADVENTURER)?;
let lorelei: serde_json::Value = serde_json::from_str(LORELEI)?;

// Or look one up by name at runtime (None if unknown or its feature is off):
let style = dicebear_styles::get("adventurer");

// all() lists every style compiled into this build.
let all = dicebear_styles::all();
```

**Go**

```
go get github.com/dicebear/styles/v10
```

Every style is embedded at compile time and exposed as raw JSON (`string`), both as an exported variable and by name via `Get`. Parse it with `encoding/json`:

```
import (
	"encoding/json"

	styles "github.com/dicebear/styles/v10"
)

var adventurer map[string]any
_ = json.Unmarshal([]byte(styles.Adventurer), &adventurer)

// Or look one up by name (ok is false if the style is unknown):
raw, ok := styles.Get("lorelei")

// All() lists every embedded style.
all := styles.All()
```

**Dart**

```
dart pub add dicebear_styles
```

Each style is a Dart string constant in its own library, so a compiled app only embeds the styles it imports. Parse the raw JSON with `dart:convert`:

```
import 'dart:convert';

import 'package:dicebear_styles/adventurer.dart';
import 'package:dicebear_styles/lorelei.dart';

final adventurerStyle = jsonDecode(adventurer);
final loreleiStyle = jsonDecode(lorelei);
```

Or import the umbrella library, which pulls in every style and adds a runtime lookup by name:

```
import 'package:dicebear_styles/dicebear_styles.dart' as styles;

// null if the style is unknown:
final raw = styles.get('adventurer');

// `all` lists every embedded style.
final names = styles.all;
```

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](https://github.com/dicebear/definitions/blob/main/CONTRIBUTING.md)for local development, testing, and the release process.

License
-------

[](#license)

The avatar styles are licensed under different licenses. More information can be found in the file [LICENSE.md](https://github.com/dicebear/definitions/blob/main/LICENSE.md) or in the definition files themselves.

Sponsors
--------

[](#sponsors)

Advertisement: Many thanks to our sponsors who provide us with free or discounted products.

[    ![bunny.net](https://camo.githubusercontent.com/4ae34db3dad914c12edc4dc985f9c62d3d4cde77d4d6de3471bd9211c42ac5c2/68747470733a2f2f7777772e64696365626561722e636f6d2f73706f6e736f72732f62756e6e792d6461726b2e737667) ](https://bunny.net/)

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance93

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~30 days

Recently: every ~6 days

Total

22

Last Release

33d ago

Major Versions

v0.1.2 → v10.0.0-rc.12026-04-06

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/647303?v=4)[Florian Körner](/maintainers/FlorianKoerner)[@FlorianKoerner](https://github.com/FlorianKoerner)

---

Top Contributors

[![FlorianKoerner](https://avatars.githubusercontent.com/u/647303?v=4)](https://github.com/FlorianKoerner "FlorianKoerner (158 commits)")

---

Tags

dicebear

### Embed Badge

![Health badge](/badges/dicebear-styles/health.svg)

```
[![Health](https://phpackages.com/badges/dicebear-styles/health.svg)](https://phpackages.com/packages/dicebear-styles)
```

###  Alternatives

[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

495240.6k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph

Generates SVG graphs

135911.1k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

12653.6k2](/packages/gravatarphp-gravatar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)