https://github.com/vercel/avatar

💎 Beautiful avatars as a microservice
https://github.com/vercel/avatar

avatar avatar-placeholder beautiful-avatars random-avatars svg-avatar vercel

Last synced: 10 days ago
JSON representation

💎 Beautiful avatars as a microservice

• Host: GitHub
• URL: https://github.com/vercel/avatar
• Owner: vercel
• License: mit
• Created: 2017-02-09T21:18:45.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2025-04-03T20:35:28.000Z (19 days ago)
• Last Synced: 2025-04-06T09:30:41.055Z (17 days ago)
• Topics: avatar, avatar-placeholder, beautiful-avatars, random-avatars, svg-avatar, vercel
• Language: TypeScript
• Homepage: https://avatar.vercel.sh
• Size: 193 KB
• Stars: 1,241
• Watchers: 10
• Forks: 80
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# avatar ![](https://avatar.vercel.sh/rauchg?size=20) ![](https://avatar.vercel.sh/leerob?size=20) ![](https://avatar.vercel.sh/vercel?size=20) ![](https://avatar.vercel.sh/party?size=20) ![](https://avatar.vercel.sh/edge?size=20)

Generate beautiful gradient avatars for your application.

## Usage

Provide a username to generate an avatar. Each name will generate a unique `avatar`. Just replace `rauchg` with an `username` or `email`:

```

https://avatar.vercel.sh/rauchg

```

You will receive a `png` image with a size of 120\*120px

![Avatar for rauchg](https://avatar.vercel.sh/rauchg)

### Adjust Roundness

```

https://avatar.vercel.sh/rauchg?rounded=60

```

![Avatar for rauchg](https://avatar.vercel.sh/rauchg?rounded=60)

### Custom Size

```

https://avatar.vercel.sh/rauchg?size=30

```

![Avatar for rauchg](https://avatar.vercel.sh/rauchg?size=30)

### SVG

Add the extension `.svg`:

```

https://avatar.vercel.sh/rauchg.svg

```

### Add Initials

Add the `text` parameter (requires SVG):

```

https://avatar.vercel.sh/rauchg.svg?text=GR

```

![Avatar for rauchg](https://avatar.vercel.sh/rauchg.svg?text=GR)