DiceBear 10.1 - Release Notes

[FlorianKoerner]

With version 10.0 we promised that DiceBear wouldn't stop at JavaScript and PHP - and that further language implementations were on the way. Version 10.1 makes good on that promise: DiceBear now speaks Python 🐍

This release also brings a batch of cross-language parity fixes that landed in the 10.0.1 and 10.0.2 patches, so that every official implementation produces truly byte-identical output for the same style and options.

🐍 Python Support

DiceBear is now available for Python (3.10+)! The API is identical to the JavaScript and PHP libraries, and the same seed and style definition produce byte-identical SVGs across all three implementations.

You need two packages: the core library dicebear-core and the avatar style definitions dicebear-styles.

• https://www.dicebear.com/how-to-use/python-library/
• https://pypi.org/project/dicebear-core/
• https://pypi.org/project/dicebear-styles/

Example:

pip install dicebear-core dicebear-styles

import json
from importlib.resources import files

from dicebear import Avatar

definition = json.loads(
    files("dicebear_styles").joinpath("lorelei.json").read_text("utf-8")
)

avatar = Avatar(definition, {
    "seed": "Felix",
    # ... other options
})

svg = avatar.to_string()

🤝 Cross-Language Parity

A big part of this release is making sure JavaScript, PHP, and Python agree down to the last byte. The following fixes (from the 10.0.1 and 10.0.2 patches) are now part of 10.1:

• Consistent SVG number rounding: Numeric values in rendered SVGs are now rounded to at most 5 decimal places everywhere. Previously, fractional or very small/large values — a fractional borderRadius or translateX, component transforms, gradient stop offsets — could be stringified differently between languages (scientific notation, differing precision). Avatars built from whole-number options were unaffected.

• PHP rounding parity: Prng::float now rounds halves toward +Infinity (matching JavaScript's Math.round) instead of PHP's native round(). The two diverged for negative values landing exactly on a .5 boundary, so a PHP-rendered avatar could differ from the JavaScript one by 0.0001 in a transform or color angle for certain seeds.

• Multibyte initials in PHP: Initials are now derived correctly from seeds containing multibyte letters such as ü or ô. A missing Unicode flag previously corrupted those letters — e.g. über and côté produced wrong or empty initials instead of ÜB / CÔ.

• Single-element range arrays: Range options (scale, borderRadius, rotate, translateX/translateY, per-color angle/fill-stops) given as a single-element array [n] are now treated as the fixed value n, and an empty array [] falls back to the option's default. Previously JavaScript emitted NaN while PHP dropped [n] to the default. All three now agree.

• Schema upper bound: The bundled @dicebear/schema was bumped to 1.1.0, adding an upper bound of 1000000 to the canvas and component width/height. This prevents the language ports' number-to-string formatting from diverging at extreme values. Official styles use ~100, so no real avatar is affected.

💻 CLI Fix

dicebear --version and dicebear --help no longer fail by trying to read a file named --version/--help. The definition path is now resolved via the argument parser, so flags before the path are handled correctly — e.g. dicebear --json my-style.json and dicebear --count 2 my-style.json.