Deterministic avatar generation API. No accounts. No rate limits.
| GET /avatar/:name | Generate an identicon avatar for any name or identifier |
| GET /truchet/:name | Generate a truchet tile pattern for any name or identifier |
| GET /health | Health check |
/avatar/alice
/avatar/alice?size=400
/avatar/alice?format=png&size=200
/avatar/alice?format=bmp&size=200
/truchet/alice
/truchet/alice?size=400
/truchet/alice?format=png&size=200
/truchet/alice?format=bmp&size=200
| param | default | description |
|---|---|---|
| format | svg |
Output format. One of svg, png,
bmp.
|
| size | 200 |
Total image width & height in px. The same across all formats
size=200 always produces a 200x200 image.
|
The input name is hashed to produce a deterministic seed. That seed drives a 5x5 symmetric grid of filled and empty cells, plus a foreground and background colour drawn from a fixed palette. The same name always produces the same avatar.
For truchet patterns, the same hash drives a 6x6 grid of classic Smith truchet tiles, each cell gets one of two quarter-circle arc orientations, producing a seamless, deterministic tile pattern unique to each name.
Both are suitable as placeholder profile images, identicons for user accounts, or anywhere you need a unique visual identity derived from a string.