Privacy-first avatars for
your internal tools
Generate consistent, unique avatars for your users without tracking them. Open source, self-hostable, and built for enterprise ERPs.
Interactive Playground
Design, test, and integrate your privacy-first avatars.
Responsive Variants
List Item
64px
Comment
48px
Menu
32px
https://private-avatar.vercel.app/api/avatar?name=John+Doe&email=john.doe%40example.com&style=circle&size=128&gradient=true&border=0&format=svg&apiKey=free-demo-keyEverything you need for user avatars
A comprehensive solution for handling user representations in your applications.
Privacy First
We don't store any user data. Avatars are generated statelessly on the fly using deterministic hashing algorithms.
Lightning Fast
Built on high-performance edge infrastructure with aggressive caching strategies for sub-millisecond response times.
Developer Friendly
Simple REST API that integrates into any stack. Support for SVG and PNG formats with infinite scalability.
Deterministic
The same email always generates the same avatar color and pattern, ensuring consistency across your application.
Customizable
Control size, shape, colors, initials, and more via simple query parameters to match your brand.
Self-Hostable
Run it on your own infrastructure. Docker images available for enterprise compliance requirements.
API Documentation
Endpoint
Parameters
| Parameter | Type | Description |
|---|---|---|
| name | string | User name for initials and badge generation. |
| string | Email address for consistent color hashing (fallback for initials). | |
| style | string | Avatar shape: circle, square, or rounded. |
| size | number | Size in pixels (16-512). Default: 128. |
| gradient | boolean | Enable gradient background. Default: false. |
| badge | boolean | Show name badge (Pro tier). |
| color | string | Custom hex or HSL color override. |
| format | string | Output format: svg or png. |
Examples
Basic usage
<img src="/api/avatar?name=John+Doe&size=64" />Gradient circle with overrides
<img src="/api/avatar?email=jane@company.com&style=circle&gradient=true" />