The Deterministic Avatar API

Generate beautiful, unique SVG avatars for your users instantly. No signup, no tracking, just names to images.

Get Started Try it out
<img src="https://uavatar.cosmicfi.dev/v1/username" />

Try it out

Configuration

The text displayed on the avatar.

Different seed = different colors/shapes.

Avatar for Cosmic
GET /v1/Cosmic

How it Works

01

Choose a Name

Use a username, email, or any unique string (e.g., "Alice").

02

Request the API

Call our endpoint: https://uavatar.cosmicfi.dev/v1/Alice

03

Get an Avatar

Receive a beautiful, deterministic SVG image instantly.

Why µAvatar?

Deterministic

The same name always generates the exact same avatar. No caching required.

Lightweight

Generates pure SVG code. No external images, no heavy libraries, blazingly fast.

Universal

Works in Node.js, the browser, and any framework (React, Vue, Svelte, etc.).

Beautiful

Uses polished gradients, aesthetic color palettes, and subtle noise textures.

Popular Avatars

Cosmic
Avatar for Cosmic
Osydian
Avatar for Osydian
Apollo
Avatar for Apollo
Kora
Avatar for Kora
Po
Avatar for Po
Morgan
Avatar for Morgan
Brave
Avatar for Brave
Ralph
Avatar for Ralph
Avery
Avatar for Avery
Sam
Avatar for Sam
John
Avatar for John
Brian
Avatar for Brian
Avalon
Avatar for Avalon
Jade
Avatar for Jade
Alpha
Avatar for Alpha

Frequently Asked Questions

Is it free to use?

Yes, µAvatar is open source and free to use for personal and commercial projects.

Can I use it offline?

Absolutely. The logic is entirely self-contained and requires no internet connection.

How are colors chosen?

Colors are deterministically generated using a seeded random number generator based on HSL color space.