dicebear-styles 10.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. dicebear_styles-10.1.0/.gitignore +5 -0
  2. dicebear_styles-10.1.0/LICENSE.md +300 -0
  3. dicebear_styles-10.1.0/PKG-INFO +103 -0
  4. dicebear_styles-10.1.0/README.md +82 -0
  5. dicebear_styles-10.1.0/pyproject.toml +54 -0
  6. dicebear_styles-10.1.0/src/adventurer-neutral.json +2000 -0
  7. dicebear_styles-10.1.0/src/adventurer.json +4133 -0
  8. dicebear_styles-10.1.0/src/avataaars-neutral.json +839 -0
  9. dicebear_styles-10.1.0/src/avataaars.json +2995 -0
  10. dicebear_styles-10.1.0/src/big-ears-neutral.json +2651 -0
  11. dicebear_styles-10.1.0/src/big-ears.json +4316 -0
  12. dicebear_styles-10.1.0/src/big-smile.json +1284 -0
  13. dicebear_styles-10.1.0/src/bottts-neutral.json +1577 -0
  14. dicebear_styles-10.1.0/src/bottts.json +3701 -0
  15. dicebear_styles-10.1.0/src/croodles-neutral.json +1080 -0
  16. dicebear_styles-10.1.0/src/croodles.json +4019 -0
  17. dicebear_styles-10.1.0/src/disco.json +2272 -0
  18. dicebear_styles-10.1.0/src/dylan.json +422 -0
  19. dicebear_styles-10.1.0/src/fun-emoji.json +1463 -0
  20. dicebear_styles-10.1.0/src/glass.json +316 -0
  21. dicebear_styles-10.1.0/src/glyphs.json +729 -0
  22. dicebear_styles-10.1.0/src/icons.json +3025 -0
  23. dicebear_styles-10.1.0/src/identicon.json +225 -0
  24. dicebear_styles-10.1.0/src/initial-face.json +333 -0
  25. dicebear_styles-10.1.0/src/initials.json +186 -0
  26. dicebear_styles-10.1.0/src/lorelei-neutral.json +1359 -0
  27. dicebear_styles-10.1.0/src/lorelei.json +3469 -0
  28. dicebear_styles-10.1.0/src/micah.json +1429 -0
  29. dicebear_styles-10.1.0/src/miniavs.json +846 -0
  30. dicebear_styles-10.1.0/src/notionists-neutral.json +1316 -0
  31. dicebear_styles-10.1.0/src/notionists.json +4205 -0
  32. dicebear_styles-10.1.0/src/open-peeps.json +2711 -0
  33. dicebear_styles-10.1.0/src/personas.json +1396 -0
  34. dicebear_styles-10.1.0/src/pixel-art-neutral.json +2280 -0
  35. dicebear_styles-10.1.0/src/pixel-art.json +6897 -0
  36. dicebear_styles-10.1.0/src/rings.json +541 -0
  37. dicebear_styles-10.1.0/src/shape-grid.json +454 -0
  38. dicebear_styles-10.1.0/src/shapes.json +519 -0
  39. dicebear_styles-10.1.0/src/stripes.json +352 -0
  40. dicebear_styles-10.1.0/src/thumbs.json +388 -0
  41. dicebear_styles-10.1.0/src/toon-head.json +1220 -0
  42. dicebear_styles-10.1.0/src/triangles.json +473 -0
@@ -0,0 +1,5 @@
1
+ .idea
2
+ .DS_Store
3
+ dist
4
+ dist-python
5
+ node_modules
@@ -0,0 +1,300 @@
1
+ # License
2
+
3
+ The avatar styles are subject to different licences. You can find the licence in
4
+ the following list or in the individual files.
5
+
6
+ ## Adventurer Neutral
7
+
8
+ | File | [src/adventurer-neutral.json](./src/adventurer-neutral.json) |
9
+ | ------: | :----------------------------------------------------------------------------- |
10
+ | Artist | [Lisa Wischofsky](https://www.instagram.com/lischi_art/) |
11
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
12
+ | Source | [Adventurer Neutral](https://www.figma.com/community/file/1184595184137881796) |
13
+
14
+ ## Adventurer
15
+
16
+ | File | [src/adventurer.json](./src/adventurer.json) |
17
+ | ------: | :--------------------------------------------------------------------- |
18
+ | Artist | [Lisa Wischofsky](https://www.instagram.com/lischi_art/) |
19
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
20
+ | Source | [Adventurer](https://www.figma.com/community/file/1184595184137881796) |
21
+
22
+ ## Avataaars Neutral
23
+
24
+ | File | [src/avataaars-neutral.json](./src/avataaars-neutral.json) |
25
+ | ------: | :-------------------------------------------------------------- |
26
+ | Artist | [Pablo Stanley](https://twitter.com/pablostanley) |
27
+ | License | [Free for personal and commercial use.](https://avataaars.com/) |
28
+ | Source | [Avataaars](https://avataaars.com/) |
29
+
30
+ ## Avataaars
31
+
32
+ | File | [src/avataaars.json](./src/avataaars.json) |
33
+ | ------: | :------------------------------------------------------------- |
34
+ | Artist | [Pablo Stanley](https://twitter.com/pablostanley) |
35
+ | License | [Free for personal and commercial use](https://avataaars.com/) |
36
+ | Source | [Avataaars](https://avataaars.com/) |
37
+
38
+ ## Big Ears Neutral
39
+
40
+ | File | [src/big-ears-neutral.json](./src/big-ears-neutral.json) |
41
+ | ------: | :------------------------------------------------------------------------ |
42
+ | Artist | [The Visual Team](https://thevisual.team/) |
43
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
44
+ | Source | [Face Generator](https://www.figma.com/community/file/986078800058673824) |
45
+
46
+ ## Big Ears
47
+
48
+ | File | [src/big-ears.json](./src/big-ears.json) |
49
+ | ------: | :------------------------------------------------------------------------ |
50
+ | Artist | [The Visual Team](https://thevisual.team/) |
51
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
52
+ | Source | [Face Generator](https://www.figma.com/community/file/986078800058673824) |
53
+
54
+ ## Big Smile
55
+
56
+ | File | [src/big-smile.json](./src/big-smile.json) |
57
+ | ------: | :----------------------------------------------------------------------- |
58
+ | Artist | [Ashley Seo](http://www.ashleyseo.com/) |
59
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
60
+ | Source | [Custom Avatar](https://www.figma.com/community/file/881358461963645496) |
61
+
62
+ ## Bottts Neutral
63
+
64
+ | File | [src/bottts-neutral.json](./src/bottts-neutral.json) |
65
+ | ------: | :---------------------------------------------------------- |
66
+ | Artist | [Pablo Stanley](https://twitter.com/pablostanley) |
67
+ | License | [Free for personal and commercial use](https://bottts.com/) |
68
+ | Source | [Bottts](https://bottts.com/) |
69
+
70
+ ## Bottts
71
+
72
+ | File | [src/bottts.json](./src/bottts.json) |
73
+ | ------: | :---------------------------------------------------------- |
74
+ | Artist | [Pablo Stanley](https://twitter.com/pablostanley) |
75
+ | License | [Free for personal and commercial use](https://bottts.com/) |
76
+ | Source | [Bottts](https://bottts.com/) |
77
+
78
+ ## Croodles Neutral
79
+
80
+ | File | [src/croodles-neutral.json](./src/croodles-neutral.json) |
81
+ | ------: | :------------------------------------------------------------------------------------- |
82
+ | Artist | [vijay verma](https://vjy.me/) |
83
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
84
+ | Source | [Croodles - Doodle your face](https://www.figma.com/community/file/966199982810283152) |
85
+
86
+ ## Croodles
87
+
88
+ | File | [src/croodles.json](./src/croodles.json) |
89
+ | ------: | :------------------------------------------------------------------------------------- |
90
+ | Artist | [vijay verma](https://vjy.me/) |
91
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
92
+ | Source | [Croodles - Doodle your face](https://www.figma.com/community/file/966199982810283152) |
93
+
94
+ ## Disco
95
+
96
+ | File | [src/disco.json](./src/disco.json) |
97
+ | ------: | :------------------------------------------------------------ |
98
+ | Artist | [DiceBear](https://www.dicebear.com) |
99
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
100
+ | Source | [Disco](https://www.dicebear.com) |
101
+
102
+ ## Dylan
103
+
104
+ | File | [src/dylan.json](./src/dylan.json) |
105
+ | ------: | :-------------------------------------------------------------------------------------- |
106
+ | Artist | [Natalia Spivak](https://nataspvk.tilda.ws/) |
107
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
108
+ | Source | [Dylan! The Avatar Generator](https://www.figma.com/community/file/1356575240759683500) |
109
+
110
+ ## Fun Emoji
111
+
112
+ | File | [src/fun-emoji.json](./src/fun-emoji.json) |
113
+ | ------: | :----------------------------------------------------------------------- |
114
+ | Artist | [Davis Uche](https://www.instagram.com/davedirect3/) |
115
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
116
+ | Source | [Fun Emoji Set](https://www.figma.com/community/file/968125295144990435) |
117
+
118
+ ## Glass
119
+
120
+ | File | [src/glass.json](./src/glass.json) |
121
+ | ------: | :------------------------------------------------------------ |
122
+ | Artist | [DiceBear](https://www.dicebear.com) |
123
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
124
+ | Source | [Glass](https://www.dicebear.com) |
125
+
126
+ ## Glyphs
127
+
128
+ | File | [src/glyphs.json](./src/glyphs.json) |
129
+ | ------: | :-------------------------------------------------------------------------------------------------------- |
130
+ | Artist | [Matt Houser](https://x.com/mattkhouser) |
131
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
132
+ | Source | [Abstract Avatars for All Creative Profile Use](https://www.figma.com/community/file/1249154526125777853) |
133
+
134
+ ## Icons
135
+
136
+ | File | [src/icons.json](./src/icons.json) |
137
+ | ------: | :----------------------------------------------------- |
138
+ | Artist | [The Bootstrap Authors](https://getbootstrap.com/) |
139
+ | License | [MIT](https://github.com/twbs/icons/blob/main/LICENSE) |
140
+ | Source | [Bootstrap Icons](https://github.com/twbs/icons) |
141
+
142
+ ## Identicon
143
+
144
+ | File | [src/identicon.json](./src/identicon.json) |
145
+ | ------: | :------------------------------------------------------------ |
146
+ | Artist | [DiceBear](https://www.dicebear.com) |
147
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
148
+ | Source | [Identicon](https://www.dicebear.com) |
149
+
150
+ ## Initial Face
151
+
152
+ | File | [src/initial-face.json](./src/initial-face.json) |
153
+ | ------: | :------------------------------------------------------------ |
154
+ | Artist | [DiceBear](https://www.dicebear.com) |
155
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
156
+ | Source | [Initial Face](https://www.dicebear.com) |
157
+
158
+ ## Initials
159
+
160
+ | File | [src/initials.json](./src/initials.json) |
161
+ | ------: | :------------------------------------------------------------ |
162
+ | Artist | [DiceBear](https://www.dicebear.com) |
163
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
164
+ | Source | [Initials](https://www.dicebear.com) |
165
+
166
+ ## Lorelei Neutral
167
+
168
+ | File | [src/lorelei-neutral.json](./src/lorelei-neutral.json) |
169
+ | ------: | :-------------------------------------------------------------------------- |
170
+ | Artist | [Lisa Wischofsky](https://www.instagram.com/lischi_art/) |
171
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
172
+ | Source | [Lorelei Neutral](https://www.figma.com/community/file/1198749693280469639) |
173
+
174
+ ## Lorelei
175
+
176
+ | File | [src/lorelei.json](./src/lorelei.json) |
177
+ | ------: | :------------------------------------------------------------------ |
178
+ | Artist | [Lisa Wischofsky](https://www.instagram.com/lischi_art/) |
179
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
180
+ | Source | [Lorelei](https://www.figma.com/community/file/1198749693280469639) |
181
+
182
+ ## Micah
183
+
184
+ | File | [src/micah.json](./src/micah.json) |
185
+ | ------: | :------------------------------------------------------------------------------------ |
186
+ | Artist | [Micah Lanier](https://dribbble.com/micahlanier) |
187
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
188
+ | Source | [Avatar Illustration System](https://www.figma.com/community/file/829741575478342595) |
189
+
190
+ ## Miniavs
191
+
192
+ | File | [src/miniavs.json](./src/miniavs.json) |
193
+ | ------: | :--------------------------------------------------------------------------------------- |
194
+ | Artist | [Webpixels](https://webpixels.io/) |
195
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
196
+ | Source | [Miniavs - Free Avatar Creator](https://www.figma.com/community/file/923211396597067458) |
197
+
198
+ ## Notionists Neutral
199
+
200
+ | File | [src/notionists-neutral.json](./src/notionists-neutral.json) |
201
+ | ------: | :------------------------------------------------------------ |
202
+ | Artist | [Zoish](https://bio.link/heyzoish) |
203
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
204
+ | Source | [Notionists](https://heyzoish.gumroad.com/l/notionists) |
205
+
206
+ ## Notionists
207
+
208
+ | File | [src/notionists.json](./src/notionists.json) |
209
+ | ------: | :------------------------------------------------------------ |
210
+ | Artist | [Zoish](https://bio.link/heyzoish) |
211
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
212
+ | Source | [Notionists](https://heyzoish.gumroad.com/l/notionists) |
213
+
214
+ ## Open Peeps
215
+
216
+ | File | [src/open-peeps.json](./src/open-peeps.json) |
217
+ | ------: | :------------------------------------------------------------ |
218
+ | Artist | [Pablo Stanley](https://twitter.com/pablostanley) |
219
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
220
+ | Source | [Open Peeps](https://www.openpeeps.com/) |
221
+
222
+ ## Personas
223
+
224
+ | File | [src/personas.json](./src/personas.json) |
225
+ | ------: | :-------------------------------------------------------- |
226
+ | Artist | [Draftbit - draftbit.com](https://draftbit.com/) |
227
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
228
+ | Source | [Personas by Draftbit](https://personas.draftbit.com/) |
229
+
230
+ ## Pixel Art Neutral
231
+
232
+ | File | [src/pixel-art-neutral.json](./src/pixel-art-neutral.json) |
233
+ | ------: | :---------------------------------------------------------------------------- |
234
+ | Artist | [DiceBear](https://www.dicebear.com) |
235
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
236
+ | Source | [Pixel Art Neutral](https://www.figma.com/community/file/1198754108850888330) |
237
+
238
+ ## Pixel Art
239
+
240
+ | File | [src/pixel-art.json](./src/pixel-art.json) |
241
+ | ------: | :-------------------------------------------------------------------- |
242
+ | Artist | [DiceBear](https://www.dicebear.com) |
243
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
244
+ | Source | [Pixel Art](https://www.figma.com/community/file/1198754108850888330) |
245
+
246
+ ## Rings
247
+
248
+ | File | [src/rings.json](./src/rings.json) |
249
+ | ------: | :------------------------------------------------------------ |
250
+ | Artist | [DiceBear](https://www.dicebear.com) |
251
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
252
+ | Source | [Rings](https://www.dicebear.com) |
253
+
254
+ ## Shape Grid
255
+
256
+ | File | [src/shape-grid.json](./src/shape-grid.json) |
257
+ | ------: | :------------------------------------------------------------ |
258
+ | Artist | [DiceBear](https://www.dicebear.com) |
259
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
260
+ | Source | [Shape Grid](https://www.dicebear.com) |
261
+
262
+ ## Shapes
263
+
264
+ | File | [src/shapes.json](./src/shapes.json) |
265
+ | ------: | :------------------------------------------------------------ |
266
+ | Artist | [DiceBear](https://www.dicebear.com) |
267
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
268
+ | Source | [Shapes](https://www.dicebear.com) |
269
+
270
+ ## Stripes
271
+
272
+ | File | [src/stripes.json](./src/stripes.json) |
273
+ | ------: | :------------------------------------------------------------ |
274
+ | Artist | [DiceBear](https://www.dicebear.com) |
275
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
276
+ | Source | [Stripes](https://www.dicebear.com) |
277
+
278
+ ## Thumbs
279
+
280
+ | File | [src/thumbs.json](./src/thumbs.json) |
281
+ | ------: | :------------------------------------------------------------ |
282
+ | Artist | [DiceBear](https://www.dicebear.com) |
283
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
284
+ | Source | [Thumbs](https://www.dicebear.com) |
285
+
286
+ ## Toon Head
287
+
288
+ | File | [src/toon-head.json](./src/toon-head.json) |
289
+ | ------: | :------------------------------------------------------------------- |
290
+ | Artist | [Johan Melin](https://www.johanmelin.com) |
291
+ | License | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
292
+ | Source | [ToonHead](https://www.figma.com/community/file/1589627891082866389) |
293
+
294
+ ## Triangles
295
+
296
+ | File | [src/triangles.json](./src/triangles.json) |
297
+ | ------: | :------------------------------------------------------------ |
298
+ | Artist | [DiceBear](https://www.dicebear.com) |
299
+ | License | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) |
300
+ | Source | [Triangles](https://www.dicebear.com) |
@@ -0,0 +1,103 @@
1
+ Metadata-Version: 2.4
2
+ Name: dicebear-styles
3
+ Version: 10.1.0
4
+ Summary: Definition files of the DiceBear avatar styles.
5
+ Project-URL: Homepage, https://www.dicebear.com
6
+ Project-URL: Repository, https://github.com/dicebear/styles
7
+ Project-URL: Issues, https://github.com/dicebear/styles/issues
8
+ Author-email: Florian Körner <contact@florian-koerner.com>
9
+ License-File: LICENSE.md
10
+ Keywords: avatar,dicebear
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: Programming Language :: Python :: 3 :: Only
13
+ Classifier: Programming Language :: Python :: 3.10
14
+ Classifier: Programming Language :: Python :: 3.11
15
+ Classifier: Programming Language :: Python :: 3.12
16
+ Classifier: Programming Language :: Python :: 3.13
17
+ Classifier: Programming Language :: Python :: 3.14
18
+ Classifier: Topic :: Multimedia :: Graphics
19
+ Requires-Python: >=3.10
20
+ Description-Content-Type: text/markdown
21
+
22
+ # DiceBear Avatar Styles
23
+
24
+ This repository contains all official avatar style definitions for
25
+ [DiceBear](https://www.dicebear.com). An avatar style definition is a JSON file
26
+ that describes how to create an avatar. It contains all necessary information
27
+ like available elements and colors. The JSON files are ideal for creating
28
+ avatars in different programming languages with the corresponding DiceBear
29
+ wrapper. The JSON schema for the avatar style definitions can be found in the
30
+ [`@dicebear/schema`](https://github.com/dicebear/schema) package.
31
+
32
+ ## Generate definitions
33
+
34
+ Most of the JSON files were created using the
35
+ [DiceBear Exporter](https://www.dicebear.com/guides/create-an-avatar-style-with-figma/)
36
+ for Figma. The used Figma files are linked in the `figma` folder. Files created
37
+ with this plugin are marked accordingly and should not be adjusted manually, but
38
+ exported again with the Figma plugin.
39
+
40
+ ## Usage
41
+
42
+ **JavaScript**
43
+
44
+ ```bash
45
+ npm install @dicebear/styles
46
+ ```
47
+
48
+ ```js
49
+ import adventurer from '@dicebear/styles/adventurer.json' with { type: 'json' };
50
+ import lorelei from '@dicebear/styles/lorelei.json' with { type: 'json' };
51
+ ```
52
+
53
+ **PHP**
54
+
55
+ ```bash
56
+ composer require dicebear/styles
57
+ ```
58
+
59
+ ```php
60
+ $basePath = \Composer\InstalledVersions::getInstallPath('dicebear/styles');
61
+
62
+ $adventurer = json_decode(file_get_contents($basePath . '/src/adventurer.json'), true);
63
+ $lorelei = json_decode(file_get_contents($basePath . '/src/lorelei.json'), true);
64
+ ```
65
+
66
+ **Python**
67
+
68
+ ```bash
69
+ pip install dicebear-styles
70
+ ```
71
+
72
+ ```python
73
+ import json
74
+ from importlib.resources import files
75
+
76
+ adventurer = json.loads(files('dicebear_styles').joinpath('adventurer.json').read_text('utf-8'))
77
+ lorelei = json.loads(files('dicebear_styles').joinpath('lorelei.json').read_text('utf-8'))
78
+ ```
79
+
80
+ ## Contributing
81
+
82
+ See
83
+ [CONTRIBUTING.md](https://github.com/dicebear/definitions/blob/main/CONTRIBUTING.md)
84
+ for local development, testing, and the release process.
85
+
86
+ ## License
87
+
88
+ The avatar styles are licensed under different licenses. More information can be
89
+ found in the file
90
+ [LICENSE.md](https://github.com/dicebear/definitions/blob/main/LICENSE.md) or in
91
+ the definition files themselves.
92
+
93
+ ## Sponsors
94
+
95
+ Advertisement: Many thanks to our sponsors who provide us with free or discounted products.
96
+
97
+ <a href="https://bunny.net/" target="_blank" rel="noopener noreferrer">
98
+ <picture>
99
+ <source media="(prefers-color-scheme: dark)" srcset="https://www.dicebear.com/sponsors/bunny-light.svg">
100
+ <source media="(prefers-color-scheme: light)" srcset="https://www.dicebear.com/sponsors/bunny-dark.svg">
101
+ <img alt="bunny.net" src="https://www.dicebear.com/sponsors/bunny-dark.svg" height="64">
102
+ </picture>
103
+ </a>
@@ -0,0 +1,82 @@
1
+ # DiceBear Avatar Styles
2
+
3
+ This repository contains all official avatar style definitions for
4
+ [DiceBear](https://www.dicebear.com). An avatar style definition is a JSON file
5
+ that describes how to create an avatar. It contains all necessary information
6
+ like available elements and colors. The JSON files are ideal for creating
7
+ avatars in different programming languages with the corresponding DiceBear
8
+ wrapper. The JSON schema for the avatar style definitions can be found in the
9
+ [`@dicebear/schema`](https://github.com/dicebear/schema) package.
10
+
11
+ ## Generate definitions
12
+
13
+ Most of the JSON files were created using the
14
+ [DiceBear Exporter](https://www.dicebear.com/guides/create-an-avatar-style-with-figma/)
15
+ for Figma. The used Figma files are linked in the `figma` folder. Files created
16
+ with this plugin are marked accordingly and should not be adjusted manually, but
17
+ exported again with the Figma plugin.
18
+
19
+ ## Usage
20
+
21
+ **JavaScript**
22
+
23
+ ```bash
24
+ npm install @dicebear/styles
25
+ ```
26
+
27
+ ```js
28
+ import adventurer from '@dicebear/styles/adventurer.json' with { type: 'json' };
29
+ import lorelei from '@dicebear/styles/lorelei.json' with { type: 'json' };
30
+ ```
31
+
32
+ **PHP**
33
+
34
+ ```bash
35
+ composer require dicebear/styles
36
+ ```
37
+
38
+ ```php
39
+ $basePath = \Composer\InstalledVersions::getInstallPath('dicebear/styles');
40
+
41
+ $adventurer = json_decode(file_get_contents($basePath . '/src/adventurer.json'), true);
42
+ $lorelei = json_decode(file_get_contents($basePath . '/src/lorelei.json'), true);
43
+ ```
44
+
45
+ **Python**
46
+
47
+ ```bash
48
+ pip install dicebear-styles
49
+ ```
50
+
51
+ ```python
52
+ import json
53
+ from importlib.resources import files
54
+
55
+ adventurer = json.loads(files('dicebear_styles').joinpath('adventurer.json').read_text('utf-8'))
56
+ lorelei = json.loads(files('dicebear_styles').joinpath('lorelei.json').read_text('utf-8'))
57
+ ```
58
+
59
+ ## Contributing
60
+
61
+ See
62
+ [CONTRIBUTING.md](https://github.com/dicebear/definitions/blob/main/CONTRIBUTING.md)
63
+ for local development, testing, and the release process.
64
+
65
+ ## License
66
+
67
+ The avatar styles are licensed under different licenses. More information can be
68
+ found in the file
69
+ [LICENSE.md](https://github.com/dicebear/definitions/blob/main/LICENSE.md) or in
70
+ the definition files themselves.
71
+
72
+ ## Sponsors
73
+
74
+ Advertisement: Many thanks to our sponsors who provide us with free or discounted products.
75
+
76
+ <a href="https://bunny.net/" target="_blank" rel="noopener noreferrer">
77
+ <picture>
78
+ <source media="(prefers-color-scheme: dark)" srcset="https://www.dicebear.com/sponsors/bunny-light.svg">
79
+ <source media="(prefers-color-scheme: light)" srcset="https://www.dicebear.com/sponsors/bunny-dark.svg">
80
+ <img alt="bunny.net" src="https://www.dicebear.com/sponsors/bunny-dark.svg" height="64">
81
+ </picture>
82
+ </a>
@@ -0,0 +1,54 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "dicebear-styles"
7
+ version = "10.1.0"
8
+ description = "Definition files of the DiceBear avatar styles."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ # Per-style licenses (see LICENSE.md); shipped as a license file rather than a
12
+ # single SPDX expression because the styles carry different licenses.
13
+ license-files = ["LICENSE.md"]
14
+ authors = [{ name = "Florian Körner", email = "contact@florian-koerner.com" }]
15
+ keywords = ["avatar", "dicebear"]
16
+ classifiers = [
17
+ "Intended Audience :: Developers",
18
+ "Programming Language :: Python :: 3 :: Only",
19
+ "Programming Language :: Python :: 3.10",
20
+ "Programming Language :: Python :: 3.11",
21
+ "Programming Language :: Python :: 3.12",
22
+ "Programming Language :: Python :: 3.13",
23
+ "Programming Language :: Python :: 3.14",
24
+ "Topic :: Multimedia :: Graphics",
25
+ ]
26
+
27
+ # Data-only distribution: no runtime dependencies and no Python code. The style
28
+ # definitions ship as JSON resources under the `dicebear_styles` import name and
29
+ # are read by the consumer via the standard library, mirroring how
30
+ # `@dicebear/styles` (npm) and `dicebear/styles` (Composer) ship pure data:
31
+ #
32
+ # import json
33
+ # from importlib.resources import files
34
+ #
35
+ # style = json.loads(
36
+ # files("dicebear_styles").joinpath("adventurer.json").read_text("utf-8")
37
+ # )
38
+
39
+ [project.urls]
40
+ Homepage = "https://www.dicebear.com"
41
+ Repository = "https://github.com/dicebear/styles"
42
+ Issues = "https://github.com/dicebear/styles/issues"
43
+
44
+ # Ship the committed `src/*.json` definitions as the `dicebear_styles` namespace
45
+ # package (a directory of JSON resources, no `__init__.py`). `bypass-selection`
46
+ # tells hatchling there are no Python packages to discover — by design.
47
+ # Using `src/` (not the generated, gitignored `dist/`) keeps the package in sync
48
+ # with the PHP usage and needs no build step before packaging.
49
+ [tool.hatch.build.targets.wheel]
50
+ bypass-selection = true
51
+ force-include = { "src" = "dicebear_styles" }
52
+
53
+ [tool.hatch.build.targets.sdist]
54
+ include = ["src/*.json", "README.md", "LICENSE.md", "pyproject.toml"]