Pick your integration
DiceBear runs as an API, as a library in seven languages, as a CLI, and as a browser-based editor. They all produce identical avatars from the same seed, so this is not a decision you can get wrong, and you can switch later without your avatars changing. It's only a question of what fits your project best.
Three questions narrow it down:
Can you point an <img> tag at a URL? Then the HTTP API is the shortest path. It's free, needs no installation, and works from any language and platform.
Do you want avatars generated on your own infrastructure? Use a library. Your user data stays on your systems and there's no external request per avatar. Pick your language below.
Do you need image files rather than running code? The CLI exports batches to SVG, PNG, JPEG, and more. And for a single avatar, say a default profile picture for your app, the Editor is the no-code way.
HTTP API
One URL in an img tag, nothing to install. The fastest route, and enough for most apps.
A library
Avatars generated in your own code, in seven languages. No external requests, works offline.
CLI
Export avatars as files from the command line, including PNG, JPEG, and WebP. Made for batch jobs.
Editor
Click an avatar together in the browser and download it. No code involved.
The libraries
| Language | Package(s) | Guide |
|---|---|---|
| JavaScript | @dicebear/core + @dicebear/styles | JS library |
| PHP | dicebear/core + dicebear/styles | PHP library |
| Python | dicebear-core + dicebear-styles | Python library |
| Rust | dicebear-core + dicebear-styles | Rust library |
| Go | dicebear/dicebear-go + dicebear/styles | Go library |
| Dart | dicebear_core + dicebear_styles | Dart library |
| C# | DiceBear.Core + DiceBear.Styles | C# library |
Frameworks build on these: guides exist for React, React Native, Vue, Svelte, Angular, Next.js, Nuxt, Flutter, Unity, and Godot.
Still unsure?
Start with the HTTP API. It requires the least setup, and because every integration renders the same avatars, moving to a library later is a refactor, not a redesign.