# DiceBear — card for AI agents

Avatar generator with 61 styles via a free HTTP API, JS library and CLI; self-hostable.

Category: Avatars and placeholders · maker Florian Koerner · checked 2026-10-19 · style: playful, abstract, pixel, hand-drawn

## Price
- Price: Free
- Free tier: Public HTTP API free for non-commercial use; library and self-hosting free.

## License
DiceBear per-style licenses (CC0, CC BY 4.0, MIT, artist terms); code MIT — https://www.dicebear.com/how-to-use/http-api/

- commercial: **conditions** (Commercial use with conditions)
  > Our API is free to use for non-commercial purposes, but please use it responsibly.
  (https://www.dicebear.com/how-to-use/http-api/)
- attribution: **varies** (Credit depends on the item)
  > each artist chooses the license for their own avatar style
  (https://www.dicebear.com/licenses/)
- in app: **conditions** (Ship inside your app with conditions)
  > Share — copy and redistribute the material in any medium or format for any purpose, even commercially.
  (https://www.dicebear.com/licenses/)
- bots: **allowed**
  > Our API is free to use for non-commercial purposes, but please use it responsibly.
  (https://www.dicebear.com/how-to-use/http-api/)

## Rules to follow
- Self-host or use the library for commercial use; the public API is for non-commercial use.
- Credit CC BY 4.0 styles (e.g. Adventurer, Big Ears, Big Smile, Micah, Personas).
- Use API 10.x; 5.x-8.x are deprecated and reach end of life on 30 Apr 2028.

## How an agent gets files
- HTTP API: https://api.dicebear.com/10.x/<styleName>/svg (style names lowercase, hyphenated); or the JS library @dicebear/core; or self-host. (sign-in: none)
- Formats: svg, png, jpg, webp, avif, json
- Not allowed: The public API is for non-commercial use; for commercial use or higher limits, set up your own instance.
- Not allowed: PNG, JPG, WebP and AVIF are capped at 256x256 px; limits are 50 req/s for SVG and 10 req/s for raster, then HTTP 429.
- Not allowed: 14 styles are CC BY 4.0 and need credit: Adventurer, Adventurer Neutral, Big Ears, Big Ears Neutral, Big Smile, Croodles, Croodles Neutral, Dylan, Fun Emoji, Glyphs, Micah, Miniavs, Personas, Toon Head.
- Not allowed: The Icons style is MIT (keep the notice); Avataaars and Bottts variants use the artists' own terms.

## How to connect
- Public API
- API docs: https://www.dicebear.com/how-to-use/http-api/
- API limits: 50 req/s SVG, 10 req/s raster (max 256px); HTTP 429; may change without notice.
- npm: `npm install @dicebear/core`
- Website: https://www.dicebear.com

## Notes
Also @dicebear/styles and the CLI (npx dicebear). The site has a 'For AI assistants' page (not read).

## Numbers (AgentGid data)
- Used in 3 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- DiceBear (Avatars and placeholders). Avatar generator with 61 styles via a free HTTP API, JS library and CLI; self-hostable. Price: free; commercial use with conditions; credit depends on the item; ship inside your app with conditions. Style: playful, abstract, pixel, hand-drawn.
  Connect: API docs https://www.dicebear.com/how-to-use/http-api/; npm @dicebear/core. Limits: 50 req/s SVG, 10 req/s raster (max 256px); HTTP 429; may change without notice.
  Get files: HTTP API: https://api.dicebear.com/10.x/<styleName>/svg (style names lowercase, hyphenated); or the JS library @dicebear/core; or self-host (svg, png, jpg, webp, avif, json).
  Not allowed: The public API is for non-commercial use; for commercial use or higher limits, set up your own instance.
  Not allowed: PNG, JPG, WebP and AVIF are capped at 256x256 px; limits are 50 req/s for SVG and 10 req/s for raster, then HTTP 429.
  Not allowed: 14 styles are CC BY 4.0 and need credit: Adventurer, Adventurer Neutral, Big Ears, Big Ears Neutral, Big Smile, Croodles, Croodles Neutral, Dylan, Fun Emoji, Glyphs, Micah, Miniavs, Personas, Toon Head.
  Not allowed: The Icons style is MIT (keep the notice); Avataaars and Bottts variants use the artists' own terms.
  Rule: Self-host or use the library for commercial use; the public API is for non-commercial use.
  Rule: Credit CC BY 4.0 styles (e.g. Adventurer, Big Ears, Big Smile, Micah, Personas).
  Rule: Use API 10.x; 5.x-8.x are deprecated and reach end of life on 30 Apr 2028.
  License: https://www.dicebear.com/how-to-use/http-api/ (checked 2026-10-19; details: https://agentgid.com/assets/dicebear/)
```

## Links
- AgentGid page: https://agentgid.com/assets/dicebear/
- Is it free for commercial use? https://agentgid.com/assets/dicebear/commercial-use/
- Source: https://www.dicebear.com/licenses/
- Source: https://www.dicebear.com/how-to-use/http-api/
- Source: https://www.dicebear.com/

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.