{"id":38174582,"url":"https://github.com/jvherck/dicebear-py","last_synced_at":"2026-05-30T20:00:53.220Z","repository":{"id":40000633,"uuid":"403260839","full_name":"jvherck/dicebear","owner":"jvherck","description":"dicebear is an API wrapper for https://dicebear.com. Using the API you can get custom avatars for your projects.","archived":false,"fork":false,"pushed_at":"2026-01-15T17:10:16.000Z","size":7665,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-15T20:04:58.182Z","etag":null,"topics":["api","api-wrapper","avatar","avatar-generator","dicebear","python","python3","wrapper","wrapper-api"],"latest_commit_sha":null,"homepage":"https://dicebear.vhjan.me","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jvherck.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-09-05T08:59:51.000Z","updated_at":"2026-01-15T16:53:58.000Z","dependencies_parsed_at":"2024-04-24T18:17:08.584Z","dependency_job_id":"01bf1db9-ef77-429a-821e-ee849e299ebf","html_url":"https://github.com/jvherck/dicebear","commit_stats":{"total_commits":119,"total_committers":3,"mean_commits":"39.666666666666664","dds":"0.39495798319327735","last_synced_commit":"f9ad14bc943c424263efd9381e180793a46c3542"},"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/jvherck/dicebear","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvherck%2Fdicebear","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvherck%2Fdicebear/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvherck%2Fdicebear/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvherck%2Fdicebear/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jvherck","download_url":"https://codeload.github.com/jvherck/dicebear/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvherck%2Fdicebear/sbom","scorecard":{"id":544797,"data":{"date":"2025-08-11","repo":{"name":"github.com/jvherck/dicebear","commit":"99b82dbfaf610d6bda70b49ccd5325e3a874320b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.9,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":9,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:28","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:29","Warn: no topLevel permission defined: .github/workflows/codeql-analysis.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":10,"reason":"SAST tool detected: CodeQL","details":["Info: SAST configuration detected: CodeQL","Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/jvherck/dicebear/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/jvherck/dicebear/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/jvherck/dicebear/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/jvherck/dicebear/codeql-analysis.yml/main?enable=pin","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-20T09:12:28.102Z","repository_id":40000633,"created_at":"2025-08-20T09:12:28.102Z","updated_at":"2025-08-20T09:12:28.102Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28487586,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T22:54:02.790Z","status":"ssl_error","status_checked_at":"2026-01-16T22:50:10.344Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","avatar","avatar-generator","dicebear","python","python3","wrapper","wrapper-api"],"created_at":"2026-01-16T23:30:14.317Z","updated_at":"2026-05-30T20:00:53.092Z","avatar_url":"https://github.com/jvherck.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DiceBear Py Wrapper  \n![Downloads](https://static.pepy.tech/personalized-badge/dicebear?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=blue\u0026left_text=Downloads)\n![Downloads](https://static.pepy.tech/personalized-badge/dicebear?period=month\u0026units=international_system\u0026left_color=grey\u0026right_color=orange\u0026left_text=Downloads/Month) \\\n![PyPI](https://img.shields.io/pypi/v/dicebear)\n![GitHub issues](https://img.shields.io/github/issues/jvherck/dicebear)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/dicebear)\n![GitHub](https://img.shields.io/github/license/jvherck/dicebear)\n![Maintenance](https://img.shields.io/maintenance/yes/2025)\n![PyPI - Status](https://img.shields.io/pypi/status/dicebear)\n\nAlways keep an eye on https://dicebear.vhjan.me/ for updates and warnings about this packages!\n\n[`dicebear`](https://pypi.org/project/dicebear/) is a Python API wrapper for https://dicebear.com. Using this wrapper you can get custom avatars for your program. \\\nFor an example go to [`examples/dicebear.py`](https://github.com/jvherck/dicebear/tree/main/examples).\n\n## Other languages\nIf you want to use Dicebear avatars but don't use Python, you can use the \n[dicebear Golang package](https://github.com/jvherck/dicebear-go) or the \n[official JS/TS package](https://github.com/dicebear/dicebear).\n\n## Useful links  \n* Official Dicebear: [https://dicebear.com/](https://dicebear.com/)\n* PyPI: [https://pypi.org/project/dicebear/](https://pypi.org/project/dicebear/)\n* Docs: [https://dicebear.vhjan.me/](https://dicebear.vhjan.me/)  \n* GitHub: [https://github.com/jvherck/dicebear](https://github.com/jvherck/dicebear)  \n* Dicebear Python CLI: [https://github.com/jvherck/dicebear-cli](https://github.com/jvherck/dicebear-cli)  \n* Golang package: [https://github.com/jvherck/dicebear-go](https://github.com/jvherck/dicebear-go)\n* JS/TS library: [https://github.com/dicebear/dicebear](https://github.com/dicebear/dicebear)\n\n## Changelog\nFind the changelog here: https://dicebear.vhjan.me/changelog\n\n## How to install  \nRun `pip install -U dicebear` \\\nIf that doesn't work try `py -m pip install -U dicebear`  \nIf that still does not work, try replacing `py` with `python` or `python3`\n\n## Usage  \nImportant 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()`).\nWhen using a `PIL` function while it's not installed it will raise `dicebear.errors.PILError`.  \n\nWhen 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.\n\n```py  \nimport PIL.Image\nimport os\nfrom dicebear import DAvatar, DStyle, DOptions, DColor, DFormat, bulk_create\n\n# Enable anonymous usage statistics\nos.environ['ENABLE_PYTHON_DICEBEAR_USAGE_STATS'] = 'true'\n\n# Creating options\noptions = DOptions(\n    backgroundColor=DColor(\"00ddd0\"),\n    rotate=90\n)\n\n# Making a DAvatar object\nav = DAvatar(\n    style=DStyle.pixel_art,\n    seed=\"John Apple\",\n    options=options\n)\nprint(av.url_svg)  # Prints the svg url\n\n# Editing the DAvatar object\nav.edit(\n    extra_options=DOptions(backgroundColor=DColor(\"000000\"))\n)\n# Using `extra_options` keep the `rotate` option but override the `backgroundColor` option\n\nprint(av.url_webp)  # Prints the webp url\n\n# Editing the style specific customisations\nav.customise(\n    blank_options={\n        \"face\": \"variant04\"\n    }\n)\n# Using `blank_options` will delete your previous customisations for this DAvatar and generate new ones\n\nprint(av.url_png)  # Prints the png url\n\n# Saving an avatar to your device\nav.save(\n    location=None,  # Passing `None` will save it in the current working directory\n    file_name=\"dicebear_avatar\",\n    file_format=DFormat.svg,\n    overwrite=True,\n    open_after_save=False\n)\n\n# Converting the DAvatar object into a PIL.Image.Image object\nav_img: PIL.Image.Image = av.pillow()\n\n# Opening and viewing the DAvatar image\nav.open(use_pil=True)  # or av.view()\n\n# Creating multiple random avatars of the same style at once\navatars: list = bulk_create(style=DStyle.random(), amount=10)\n```\n\n## CLI Usage  \nDicebear has a CLI package that uses Python to generate avatars quickly.\nYou can't customize each avatar, to do that you'll need to use the Python module.\n\nTo use the CLI run `pip install dicebear-cli` in a terminal. \nDocumentation can be found here: https://github.com/jvherck/dicebear-cli.\n\n## Customization\nCustomize your avatars with these possibilities.  \n\n\n### Styles  \nAll the possible avatar styles. \\\nhttps://dicebear.com/styles  \n  \n* `adventurer`  \n* `adventurer-neutral`  \n* `avataaars`  \n* `avataaars-neutral`  \n* `big-ears`  \n* `big-ears-neutral`  \n* `big-smile`  \n* `bottts`  \n* `bottts-neutral`  \n* `croodles`  \n* `croodles-neutral`  \n* `dylan`\n* `fun-emoji`  \n* `glass`\n* `icons`  \n* `identicon`  \n* `initials`  \n* `lorelei`  \n* `lorelei-neutral`  \n* `micah`  \n* `miniavs`  \n* `notionists`\n* `notionists-neutral`\n* `open-peeps`  \n* `personas`  \n* `pixel-art`  \n* `pixel-art-neutral`\n* `rings`\n* `shapes`\n* `thumbs`\n* `toon-head`\n\n\n### Base Options  \nAll the possible options for the avatar. These options work for all the styles.  \n\n* `seed` (type: `str`) - the seed for the avatar generator, determine its basic looks  \n* `flip` (type: `bool`) - flips the image vertically (default False)  \n* `rotate` (type: `int`) - rotates the avatar (default 0, min 0, max 360)  \n* `scale` (type: `int`) - the scale of the avatar drawing itself (default 100, min 0, max 200)  \n* `radius` (type: `int`) - the radius of the avatar (default 0, min 0, max 50)  \n* `size` (type: `int`) - the size of the avatar (px) (default 256, min 1, max 256)  \n* `backgroundColor` (type: `DColor(\"transparent\")` ) - the background color of the avatar. this can be a list of strings\nif you have *backgroundType* set to \"gradientLinear\". (default transparent)  \n* `backgroundType` (type: `str` ) - set the background to either `gradientLinear` or `solid` (default solid)  \n* `backgroundRotation` (type: `int` ) - rotate the background if backgroundType is set to `gradientLinear` (default 0)  \n* `translateX` (type: `int`) - move the avatar horizontally (default 0, min -100, max 100)  \n* `translateY` (type: `int`) - move the avatar vertically (default 0, min -100, max 100)  \n* `randomizeIds` (type: `bool`) - randomize the IDs in the generated SVG/XML, can be useful if the avatars are included \ndirectly in HTML and you want to avoid ID conflicts (default false)  \n\n\n### Specific Style Options   \nSpecific options to get a more detailed avatar. This is different for every style. \\\nClick the style to see its options.  \n\n* [adventurer](https://dicebear.com/styles/adventurer#options)  \n* [adventurer-neutral](https://dicebear.com/styles/adventurer-neutral#options)  \n* [avataaars](https://dicebear.com/styles/avataaars#options)  \n* [avataaars-neutral](https://dicebear.com/styles/avataaars-neutral#options)  \n* [big-ears](https://dicebear.com/styles/big-ears#options)  \n* [big-ears-neutral](https://dicebear.com/styles/big-ears-neutral#options)  \n* [big-smile](https://dicebear.com/styles/big-smile#options)  \n* [bottts](https://dicebear.com/styles/bottts#options)  \n* [bottts-neutral](https://dicebear.com/styles/bottts-neutral#options)  \n* [croodles](https://dicebear.com/styles/croodles#options)  \n* [croodles-neutral](https://dicebear.com/styles/croodles-neutral#options)  \n* [dylan](https://dicebear.com/styles/dylan#options)  \n* [fun-emoji](https://dicebear.com/styles/fun-emoji#options)  \n* [glass](https://dicebear.com/styles/glass#options)  \n* [icons](https://dicebear.com/styles/icons#options)  \n* [identicon](https://dicebear.com/styles/identicon#options)  \n* [initials](https://dicebear.com/styles/initials#options)  \n* [lorelei](https://dicebear.com/styles/lorelei#options)  \n* [lorelei-neutral](https://dicebear.com/styles/lorelei-neutral#options)  \n* [micah](https://dicebear.com/styles/micah#options)  \n* [miniavs](https://dicebear.com/styles/miniavs#options)  \n* [notionists](https://dicebear.com/styles/notionists#options)  \n* [notionists-neutral](https://dicebear.com/styles/notionists-neutral#options)  \n* [open-peeps](https://dicebear.com/styles/open-peeps#options)  \n* [personas](https://dicebear.com/styles/personas#options)  \n* [pixel-art](https://dicebear.com/styles/pixel-art#options)  \n* [pixel-art-neutral](https://dicebear.com/styles/pixel-art-neutral#options)  \n* [rings](https://www.dicebear.com/styles/rings#options)\n* [shapes](https://dicebear.com/styles/shapes#options)  \n* [thumbs](https://dicebear.com/styles/thumbs#options)  \n* [toon-head](https://dicebear.com/styles/toon-head#options)  \n\n\n### Formats   \nThese are the only supported formats. \\\nIf you have Pillow (PIL) installed you can convert `DAvatar` to a `PIL.Image.Image` object to get a\nwider range of formats (Pillow doesn't support svg).  \n  \n* `DFormat.svg` (default)  \n* `DFormat.webp`  \n* `DFormat.avif`  \n* `DFormat.png`  \n* `DFormat.jpg`  \n* `DFormat.jpeg`  \n* `DFormat.json`\n\n## Credits  \nSpecial thanks to [DiceBear](https://github.com/dicebear) ([Florian Körner](https://github.com/FlorianKoerner)) for \nmaking this amazing API and to [all artists](https://dicebear.com/licenses) for creating these avatars!  \n\nDisclaimer: this repository and its owner are not affiliated with DiceBear.\n\n## Licenses and privacy policy  \n- Dicebear **Licenses**: https://dicebear.com/licenses  \n- Dicebear **Privacy Policy**: https://dicebear.com/legal/privacy-policy  \n- Dicebear Python API wrapper (this project): https://dicebear.vhjan.me/license\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvherck%2Fdicebear-py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjvherck%2Fdicebear-py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvherck%2Fdicebear-py/lists"}