ℹ️Changelog

To find the full documentation go to https://dicebear.vhjan.me/ You can click certain blocks to go to its documentation page. If you encounter any bugs or errors, please open an issue.

---

v3.9.4

2026-01-15

Added

• New style toon-head

---

v3.9.3

2025-03-03

Changed

• DAvatar now has a new parameter save_to_cache (default True) to choose whether to save avatars to the cache or not. Caching them will make it easier and quicker to access the avatars again, and will reduce outgoing API calls.

---

v3.9.2

2025-01-04

Back-end

The back-end has been reworked a lot to make the whole framework faster and more efficient. The package now also supports caching to avoid making redundant requests.

A safer way of making requests to avoid hanging indefinitely or raising generic/unnecessary errors has been implemented.

---

v2.9.2

2024-07-28

Added

• New styles dylan and glass

• New modern alternative file formats webp and avif (use these instead of png or jp(e)g)

---

v2.7.5

2024-07-06

Back-end

• Dicebear version upgrade to 9.x

Improvements

• Added tox for code quality automation

Changed

• Moved style metadata to separate file dicebear.metadata.Metadata

---

v2.7.4

2024-04-24

Back-end

• Back-end cleanup

• Dicebear version upgrade to 8.x (API bug fixes)

---

v2.7.3

2024-03-09

Added

• styles_metadata (models.py) to directly get metadata of every style

Back-end

• Made usage stats opt-in with environment variable ENABLE_PYTHON_DICEBEAR_USAGE_STATS set to true

Fixed

• notionists and notionists-neutral were not implemented but have been added now

---

v2.7.2

2023-12-12

Added

• New attribute schema for DAvatar class

Back-end

• Removed test parameter on all functions

• Improved type hinting and imports

---

v2.7.1

2023-12-12

Added

• New attribute schema for DAvatar class

Back-end

• Removed test parameter on all functions

• Improved type hinting and imports

---

v2.7.0

2023-08-29

Added

• New style rings

• New function DStyle.get_schema(style: str) to get the schema (all properties) of the given avatar style

Back-end

• Upgrade to Dicebear new API version 7.0

---

v2.6.1

2023-04-11

Added

• New style notionists

• New style notionists-neutral

Back-end

• Upgrade to Dicebear new API version 6.0

---

v2.5.2

2023-03-21

Back-end

• The package now pings an API to update the usage statistics (nothing personal is stored, it simply increments the amount of times certain functions have been used)

---

v2.5.1

2023-03-16

Removed

• Properties DAvatar.text and DAvatar.bytes

Added

• Methods DAvatar.text(format) and DAvatar.bytes(format)

Fixed

• DAvatar.pillow() no longer raises error for no reason