[](https://github.com/dicebear/dicebear/stargazers)
[](https://github.com/dicebear/dicebear/blob/10.x/LICENSE)
JavaScript implementation of the DiceBear avatar library. Generates
deterministic SVG avatars from style definitions and a seed string.
DiceBear is available for multiple languages. All implementations share the same
PRNG and rendering pipeline, producing identical SVG output for the same seed,
style, and options, regardless of the language used.
[Playground](https://www.dicebear.com/playground) |
[Documentation](https://www.dicebear.com/how-to-use/js-library/)
## Installation
```sh
npm install @dicebear/core
```
Requires Node.js 22+ or any modern browser.
## Usage
```js
import { Avatar } from '@dicebear/core';
// From a style definition (here from the @dicebear/styles package)
import definition from '@dicebear/styles/lorelei.json' with { type: 'json' };
const avatar = new Avatar(definition, {
seed: 'John Doe',
size: 128,
});
avatar.toString(); // SVG string
avatar.toDataUri(); // data:image/svg+xml;charset=utf-8,...
```
### Using the Style class
```js
import { Style, Avatar } from '@dicebear/core';
const style = new Style(definition);
// Create multiple avatars from the same style
const avatar1 = new Avatar(style, { seed: 'Alice' });
const avatar2 = new Avatar(style, { seed: 'Bob' });
```
## Sponsors
Advertisement: Many thanks to our sponsors who provide us with free or
discounted products.
---
_Source: https://npm.io/package/@dicebear/core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
DiceBear Core (JavaScript)