Readme
Always keep an eye on https://dicebear.vhjan.me/ for updates and warnings about this packages!
dicebear is a Python API wrapper for https://dicebear.com. Using this wrapper you can get custom avatars for your program.
For an example go to examples/dicebear.py.
Find the changelog here: https://dicebear.vhjan.me/changelog
Run pip install -U dicebear
If that doesn't work try py -m pip install -U dicebear
Important note: Pillow is not a required dependency, it's only required when you want to be able to edit the avatar images (using DAvatar.pillow()).
When using a PIL function while it's not installed it will raise dicebear.errors.PILError.
When the environment variable ENABLE_PYTHON_DICEBEAR_USAGE_STATS is set to true, an API will be pinged on most function calls to update this package's usage stats. This will be used to analyse Dicebear's usage and improve your overall experience, but may have performance costs.
import PIL.Image
import os
from dicebear import DAvatar, DStyle, DOptions, DColor, DFormat, bulk_create
# Enable anonymous usage statistics
os.environ['ENABLE_PYTHON_DICEBEAR_USAGE_STATS'] = 'true'
# Creating options
options = DOptions(
backgroundColor=DColor("00ddd0"),
rotate=90
)
# Making a DAvatar object
av = DAvatar(
style=DStyle.pixel_art,
seed="John Apple",
options=options
)
print(av.url_svg) # Prints the svg url
# Editing the DAvatar object
av.edit(
extra_options=DOptions(backgroundColor=DColor("000000"))
)
# Using `extra_options` keep the `rotate` option but override the `backgroundColor` option
print(av.url_png) # Prints the png url
# Editing the style specific customisations
av.customise(
blank_options={
"face": "variant04"
}
)
# Using `blank_options` will delete your previous customisations for this DAvatar and generate new ones
print(av.url_jpg) # Prints the jpg url
# Saving an avatar to your device
av.save(
location=None, # Passing `None` will save it in the current working directory
file_name="dicebear_avatar",
file_format=DFormat.svg,
overwrite=True,
open_after_save=False
)
# Converting the DAvatar object into a PIL.Image.Image object
av_img: PIL.Image.Image = av.pillow()
# Opening and viewing the DAvatar image
av.open(use_pil=True) # or av.view()
# Creating multiple random avatars of the same style at once
avatars: list = bulk_create(style=DStyle.random(), amount=10)
Dicebear has a CLI package that uses Python to generate avatars quickly. You can't customize each avatar, to do that you'll need to use the Python module.
To use the CLI run pip install dicebear-cli in a terminal.
Documentation can be found here: https://github.com/jvherck/dicebear-cli.
Customize your avatars with these possibilities.
All the possible avatar styles.
https://dicebear.com/styles
adventureradventurer-neutralavataaarsavataaars-neutralbig-earsbig-ears-neutralbig-smilebotttsbottts-neutralcroodlescroodles-neutralfun-emojiiconsidenticoninitialsloreleilorelei-neutralmicahminiavsnotionistsnotionists-neutralopen-peepspersonaspixel-artpixel-art-neutralringsshapesthumbsAll the possible options for the avatar. These options work for all the styles.
seed (type: str) - the seed for the avatar generator, determine its basic looksflip (type: bool) - flips the image vertically (default False)rotate (type: int) - rotates the avatar (default 0, min 0, max 360)scale (type: int) - the scale of the avatar drawing itself (default 100, min 0, max 200)radius (type: int) - the radius of the avatar (default 0, min 0, max 50)size (type: int) - the size of the avatar (px) (default 256, min 1, max 256)backgroundColor (type: DColor("transparent") ) - the background color of the avatar. this can be a list of strings
if you have backgroundType set to "gradientLinear". (default transparent)backgroundType (type: str ) - set the background to either gradientLinear or solid (default solid)backgroundRotation (type: int ) - rotate the background if backgroundType is set to gradientLinear (default 0)translateX (type: int) - move the avatar horizontally (default 0, min -100, max 100)translateY (type: int) - move the avatar vertically (default 0, min -100, max 100)randomizeIds (type: bool) - randomize the IDs in the generated SVG/XML, can be useful if the avatars are included
directly in HTML and you want to avoid ID conflicts (default false)Specific options to get a more detailed avatar. This is different for every style.
Click the style to see its options.
These are the only supported formats.
If you have Pillow (PIL) installed you can convert DAvatar to a PIL.Image.Image object to get a
wider range of formats (Pillow doesn't support svg).
DFormat.svg (default)DFormat.pngDFormat.jpgDFormat.jsonSpecial thanks to DiceBear (Florian Körner) for making this amazing API and to all artists for creating these avatars!
FAQs
A python wrapper for DiceBear's avatar generating API.
We found that dicebear demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.