Skip to content
On this page
Sponsor

CLI

With the CLI you can create thousands of avatars in no time!

Installation

Make sure you have Node.js and NPM installed.

npm install dicebear --global

Upgrade

For the latest features and avatar styles, make sure you update the CLI regularly.

npm install dicebear --global

Usage

Create an avatar

Replace <style> with an avatar style name (camelCase) and [outputPath] with a target directory. If [outputPath] is omitted, the current directory is used as target directory.

dicebear <style> [outputPath]

For example, to create an avatar with the lorelei avatar style, use the following command:

dicebear lorelei .

INFO

We provide a large number of avatar styles from different designers. The designs are licensed under different licenses that the designers can choose themselves. Some licenses require attribution. For a quick overview we have created an license overview for you.

Create multiple avatars

You can also create multiple avatars at once! Just use the --count option. Replace <count> with the number of avatars to create.

dicebear <style> [outputPath] --count <count>

WARNING

The seed option has no effect in combination with the count option. If count is greater than 1, random values are generated and used as seed to make the avatars differ from each other.

Passing options

You can find out what options are available with --help. Besides the options provided by the avatar styles, there are the following additional options:

--count      Defines how many avatars to create.          [number]
--format                                                  [string] [choices: "svg", "png", "jpg", "jpeg", "json"]
--exif       Include Exif Metadata                        [boolean]
--json       Save JSON file in addition to image file     [boolean]

As you can see, you can also create the avatars in a format other than SVG. For example, to create a PNG avatar of the avatar style lorelei, use the following command:

dicebear lorelei . --format png

Show help

For each command you can ask for help.

dicebear --help
dicebear <command>

Commands:
  dicebear adventurer [outputPath]         Generate "adventurer" avatar(s)
  dicebear adventurerNeutral [outputPath]  Generate "adventurerNeutral" avatar(s)
  dicebear avataaars [outputPath]          Generate "avataaars" avatar(s)
  dicebear avataaarsNeutral [outputPath]   Generate "avataaarsNeutral" avatar(s)
  dicebear bigEars [outputPath]            Generate "bigEars" avatar(s)
  dicebear bigEarsNeutral [outputPath]     Generate "bigEarsNeutral" avatar(s)
  dicebear bigSmile [outputPath]           Generate "bigSmile" avatar(s)
  dicebear bottts [outputPath]             Generate "bottts" avatar(s)
  dicebear botttsNeutral [outputPath]      Generate "botttsNeutral" avatar(s)
  dicebear croodles [outputPath]           Generate "croodles" avatar(s)
  dicebear croodlesNeutral [outputPath]    Generate "croodlesNeutral" avatar(s)
  dicebear funEmoji [outputPath]           Generate "funEmoji" avatar(s)
  dicebear icons [outputPath]              Generate "icons" avatar(s)
  dicebear identicon [outputPath]          Generate "identicon" avatar(s)
  dicebear initials [outputPath]           Generate "initials" avatar(s)
  dicebear lorelei [outputPath]            Generate "lorelei" avatar(s)
  dicebear loreleiNeutral [outputPath]     Generate "loreleiNeutral" avatar(s)
  dicebear micah [outputPath]              Generate "micah" avatar(s)
  dicebear miniavs [outputPath]            Generate "miniavs" avatar(s)
  dicebear openPeeps [outputPath]          Generate "openPeeps" avatar(s)
  dicebear personas [outputPath]           Generate "personas" avatar(s)
  dicebear pixelArt [outputPath]           Generate "pixelArt" avatar(s)
  dicebear pixelArtNeutral [outputPath]    Generate "pixelArtNeutral" avatar(s)
  dicebear shapes [outputPath]             Generate "shapes" avatar(s)
  dicebear thumbs [outputPath]             Generate "thumbs" avatar(s)

Options:
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]