# dicebear/dicebear

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/dicebear-dicebear).**

8,067 stars · 348 forks · TypeScript

## Links

- GitHub: https://github.com/dicebear/dicebear
- Homepage: https://dicebear.com
- awesome-repositories: https://awesome-repositories.com/repository/dicebear-dicebear.md

## Topics

`api` `avataaars` `avatar` `avatar-placeholder` `avatars` `bottts` `dicebear` `figma` `pixel-art`

## Description

DiceBear is an SVG avatar generation library and image API that creates deterministic profile pictures from seed strings. It provides a system for generating consistent visual outputs across different environments and programming languages using JSON style definitions.

The project distinguishes itself with a comprehensive design toolkit, including a visual style designer and a Figma integration plugin that converts design frames into JSON schemas. It supports sophisticated visual control through weighted probability distributions for components, contrast-aware color management for accessibility, and a transformation engine for randomized rotation and scaling.

Beyond basic generation, the system covers a broad range of capabilities including multi-format exports to raster images like PNG and WebP, a command line interface for batch asset production, and the ability to host a self-managed API for remote rendering. It also includes security features such as SVG output sanitization to prevent script injection.

## Tags

### Artificial Intelligence & ML

- [Seeded Generation](https://awesome-repositories.com/f/artificial-intelligence-ml/deterministic-generation-strategies/seeded-generation.md) — Transforms seed strings into repeatable random values to ensure consistent visual outputs across environments.
- [Visual Determinism](https://awesome-repositories.com/f/artificial-intelligence-ml/deterministic-generation-strategies/seeded-generation/visual-determinism.md) — Creates consistent profile pictures from seed strings to ensure the same input always produces the same visual result.

### Graphics & Multimedia

- [Deterministic Image APIs](https://awesome-repositories.com/f/graphics-multimedia/deterministic-image-apis.md) — Serves seed-based avatar images and style metadata via an HTTP service without requiring local installations.
- [Local Vector Generation](https://awesome-repositories.com/f/graphics-multimedia/local-vector-generation.md) — Enables the generation of consistent SVG avatars directly within local application code. ([source](https://dicebear.com/guides/use-the-library-with-flutter/))
- [Remote Image Generation](https://awesome-repositories.com/f/graphics-multimedia/remote-image-generation.md) — Enables the creation of consistent avatar images by passing seed strings and parameters through HTTP request URLs. ([source](https://dicebear.com/how-to-use/http-api/))
- [SVG Element Generators](https://awesome-repositories.com/f/graphics-multimedia/svg-element-generators.md) — Provides a library that generates consistent, deterministic profile pictures from seed strings using SVG and JSON.
- [Vector Rasterizers](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/rendering/vector-rendering-pipelines/vector-graphics-renderers/vector-rasterizers.md) — Transforms vector-based XML output into multiple raster formats like PNG and WebP.
- [Remote Rendering Servers](https://awesome-repositories.com/f/graphics-multimedia/remote-rendering-servers.md) — Produces images on a remote server via query parameters to provide assets without local libraries.
- [SVG Image Exports](https://awesome-repositories.com/f/graphics-multimedia/svg-image-exports.md) — Provides the ability to export generated avatars as XML-formatted SVG strings or data URIs. ([source](https://dicebear.com/how-to-use/dart-library/))
- [Multi-Format Asset Exports](https://awesome-repositories.com/f/graphics-multimedia/video-converters/multi-format-exporters/multi-format-asset-exports.md) — Outputs generated images as XML strings, JSON objects, or data URIs for different application contexts. ([source](https://dicebear.com/how-to-use/js-library/))

### Programming Languages & Runtimes

- [Deterministic](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/core-conceptual-frameworks/programming-language-concepts/random-number-generation/reproducible-randomizers/seeding-utilities/deterministic.md) — Generates independent, deterministic attribute values using keys to ensure consistency regardless of call order. ([source](https://dicebear.com/specification/implement-dicebear-core/))
- [Cross-Language Visual Consistency](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/core-conceptual-frameworks/programming-language-concepts/random-number-generation/reproducible-randomizers/seeding-utilities/deterministic/cross-language-visual-consistency.md) — Ensures that the same seed produces byte-identical avatar images regardless of the programming language used. ([source](https://dicebear.com/specification/implement-dicebear-core/))
- [Rendering Randomizers](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/core-conceptual-frameworks/programming-language-concepts/random-number-generation/animation-randomizers/random-value-generators/rendering-randomizers.md) — Applies randomized rotation, translation, and scaling to avatar components within defined ranges. ([source](https://dicebear.com/guides/create-an-avatar-style-from-scratch/))

### Software Engineering & Architecture

- [Avatar Style Schemas](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-formats-and-schemas/json-configuration-schemas/avatar-style-schemas.md) — Provides a declarative JSON schema for defining canvas size, elements, and color palettes for avatar generation. ([source](https://dicebear.com/guides/create-an-avatar-style-from-scratch/))
- [Visual Style Schemas](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-formats-and-schemas/json-configuration-schemas/visual-style-schemas.md) — Uses a structured JSON format to define canvas elements, visual components, and probability weights.
- [Visual Variant Weighting](https://awesome-repositories.com/f/software-engineering-architecture/content-schemas/schema-variants/variant-mappings/visual-variant-weighting.md) — Allows adjusting avatar appearance through style-specific options and weight maps to prefer or exclude variants. ([source](https://dicebear.com/how-to-use/js-library/))
- [Deterministic Attribute Derivation](https://awesome-repositories.com/f/software-engineering-architecture/deterministic-attribute-derivation.md) — Generates independent values for visual traits using keys to maintain consistency regardless of call order.

### User Interface & Experience

- [Avatar Appearance Configurators](https://awesome-repositories.com/f/user-interface-experience/avatars/avatar-appearance-configurators.md) — Enables the definition of visual styles and component probabilities to create unique sets of generated characters.
- [Probabilistic Component Sets](https://awesome-repositories.com/f/user-interface-experience/component-variant-sets/probabilistic-component-sets.md) — Uses a system of visual variants and probability ranges to determine avatar looks based on a seed. ([source](https://dicebear.com/specification/definition-schema/))
- [Declarative Style Objects](https://awesome-repositories.com/f/user-interface-experience/styling-theming-systems/content-styling/component-styling-tools/component-styling/declarative-style-objects.md) — Uses JSON definitions and map-based descriptors to declaratively configure avatar styles and options. ([source](https://dicebear.com/how-to-use/dart-library/))
- [SVG Export Pipelines](https://awesome-repositories.com/f/user-interface-experience/ui-architecture/design-utilities/design-assets/vector-graphic-assets/svg-export-pipelines.md) — Produces and exports scalable vector graphics in various formats for web and mobile user interfaces.
- [User Avatars](https://awesome-repositories.com/f/user-interface-experience/user-avatars.md) — Generates unique placeholder images and avatars for users via a local library or HTTP API.
- [Automatic Contrast Adjusters](https://awesome-repositories.com/f/user-interface-experience/contrast-validators/automatic-contrast-adjusters.md) — Dynamically computes and applies colors using contrast sorting to ensure visual accessibility.
- [Dynamic Text Interpolation](https://awesome-repositories.com/f/user-interface-experience/dynamic-text-interpolation.md) — Allows the insertion of seed-derived initials or user-defined font settings into text elements. ([source](https://dicebear.com/specification/definition-schema/))
- [Figma to JSON Style Conversion](https://awesome-repositories.com/f/user-interface-experience/figma-to-json-style-conversion.md) — Includes a Figma plugin that converts design frames into JSON style definitions, including probabilities. ([source](https://www.dicebear.com/guides/create-an-avatar-style-with-figma/))
- [Color Palette Management](https://awesome-repositories.com/f/user-interface-experience/ui-architecture/design-utilities/design-systems/color-system-utilities/color-palette-management.md) — Implements a system for resolving colors and managing palettes using contrast-based sorting for accessibility. ([source](https://dicebear.com/specification/definition-schema/))
- [Visual Element Transforms](https://awesome-repositories.com/f/user-interface-experience/visual-element-transforms.md) — Provides a system to adjust the position, scale, rotation, and flip of avatar components. ([source](https://dicebear.com/specification/implement-dicebear-core/))
- [Visual Style Customization](https://awesome-repositories.com/f/user-interface-experience/visual-style-customization.md) — Provides a graphical interface for browsing styles and modifying appearance options without writing code. ([source](https://dicebear.com/introduction/))
- [Style Editors](https://awesome-repositories.com/f/user-interface-experience/visual-style-customization/style-editors.md) — Ships a visual editor for creating custom style definitions and exporting them as JSON files. ([source](https://dicebear.com/guides/create-an-avatar-style-with-figma/))

### Content Management & Publishing

- [Raster Image Exports](https://awesome-repositories.com/f/content-management-publishing/content-formats-exporting/export-formats/raster-image-exports.md) — Transforms SVG images into raster formats such as PNG, JPEG, WebP, and AVIF. ([source](https://dicebear.com/how-to-use/js-library/converter/))

### DevOps & Infrastructure

- [Self-Hosted API Services](https://awesome-repositories.com/f/devops-infrastructure/infrastructure/private-enterprise-management/self-hosted-services/self-hosted-api-services.md) — Allows the deployment of private instances of the avatar generation service to control privacy and rate limits. ([source](https://dicebear.com/how-to-use/http-api/))

### Scientific & Mathematical Computing

- [Visual Variant Probabilities](https://awesome-repositories.com/f/scientific-mathematical-computing/numerical-mathematical-foundations/statistics-probability/probability-distributions/visual-variant-probabilities.md) — Determines the frequency of specific visual components in outputs using weights and probability percentages. ([source](https://dicebear.com/guides/create-an-avatar-style-from-scratch/))
- [Weighted Component Distribution](https://awesome-repositories.com/f/scientific-mathematical-computing/numerical-mathematical-foundations/statistics-probability/probability-distributions/weighted-component-distribution.md) — Assigns numerical weights to visual variants to control how frequently specific components appear.

### Web Development

- [Remote Avatar Embedding](https://awesome-repositories.com/f/web-development/remote-avatar-embedding.md) — Allows fetching and embedding avatar images via HTTP URLs in any environment without requiring local installations. ([source](https://dicebear.com/introduction))
- [Server-Side Rendering](https://awesome-repositories.com/f/web-development/server-side-rendering.md) — Supports generating avatars on the server to eliminate client-side JavaScript and hydration issues. ([source](https://dicebear.com/guides/use-the-library-with-next-js/))
- [Image Generation API Hosting](https://awesome-repositories.com/f/web-development/web-infrastructure-deployment/web-infrastructure-servers/web-server-hosting/headless-server-hosting/image-generation-api-hosting.md) — Provides a standalone server for exposing the avatar generation pipeline as a remote API. ([source](https://dicebear.com/guides/contribute-to-the-api/))