Appearance
What is Suils?
Suils turns any string — a username, an email, a user ID — into a unique, good‑looking avatar. The same seed always produces the same avatar, on every device and every request, so it's a perfect default profile picture for users who haven't uploaded a photo.
Everything is served from a single HTTP endpoint. There's nothing to install — you build a URL and drop it into an <img> tag.
https://avatars.suils.es/suils/svg?seed=AnnaWays to use Suils
HTTP API
Embed avatars anywhere with a plain URL — no SDK, no install. Works in every language and platform.
Editor
Browse all 175 styles, pick a seed and background, and download — no code required.
Self-hostable
Run the whole stack with one docker compose command. Your infrastructure, your data.
175 styles
Characters, professions, mythology, animals, sci-fi and abstract patterns — all authored in-house.
How it works
Each of the 175 styles is a library of hand‑authored SVG parts — heads, eyes, mouths, hats, and so on. When you request an avatar, Suils hashes the seed deterministically and uses it to pick one part from each category, then composes them into a single SVG. Because the choice comes only from the seed, the result is completely reproducible: same style + same seed → byte‑for‑byte the same avatar.
Avatars are generated as SVG, so they're tiny and scale to any size. Raster formats (PNG, JPG, WebP, AVIF) are rendered on demand from the same SVG.
Privacy & ownership
Suils is privacy‑friendly by design: no accounts, no tracking, no cookies — just image requests. Only the seed you put in the URL is ever sent. If you need full control over data and availability, you can self‑host the entire stack.
All 175 styles are original works, © Suils, MIT licensed — free for personal and commercial use with no attribution required. See the licenses.
Ready? Head to the quick start.