# vercel/avatar

💎   Beautiful avatars as a microservice

Repository: https://github.com/vercel/avatar
Canonical: https://ross.abutalabs.com/products/vercel-avatar
Homepage: https://avatar.vercel.sh
Language: TypeScript
License: MIT
License Family: permissive
Topics: svg-avatar, avatar, random-avatars, avatar-placeholder, beautiful-avatars, vercel
Last push: 2026-07-28T15:48:43+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 35, longevity 100
- inputs: {"age_days": 3492, "days_push": 36, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1389, forks 92 (observed 2026-08-28T04:04:35.479831+00:00)

## What it is
A microservice that generates beautiful gradient avatars from any username or email via simple URL parameters, returning PNG or SVG images. It supports custom size, roundness, and initials text, and can be self-hosted.

## Use cases
- generate placeholder avatars for user profiles
- get a gradient avatar image from a username via URL
- serve SVG avatars with initials for my app
- self-host an avatar generation service
- create unique deterministic avatars per email
- add default profile pictures to a web app

## When to choose
- you need lightweight, deterministic gradient avatars from usernames
- you want a simple URL-based image API with PNG and SVG output
- you prefer a self-hostable microservice over a client-side library

## When to avoid
- you need photographic or illustrated avatars
- you require client-side rendering without an HTTP service
- you need rich customization like uploaded images or themes

## Facets
- artifact type: service
- maturity: stable
- function: image-processing, http-server, sdk
- domain: web-development, frontend, apis
- platform: self-hosted
- tags: avatar-generator, gradient-avatars, svg, placeholder-images, microservice, web-server, nodejs

## Member repositories
- vercel/avatar (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:35.479831+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:39:44.236660+00:00, confidence not recorded.
  - readme: https://github.com/vercel/avatar (fetched 2026-08-28T04:04:35.479831+00:00, sha 7dfd593873f9)
  - homepage: https://avatar.vercel.sh (fetched 2026-08-29T11:55:15.045611+00:00, sha 82f36985876a)
- Data as of 2026-08-30T08:39:29.467469+00:00.