Introduction
Add deterministic kawaii avatars to your app. No API call required.
Same seed, same avatar
Pass the same seed and you get the same avatar, every time. Pass a user id, an email, or a username — anything stable you already have.
<Avatar assets={humation1} seed="felix" size={112} />No API to call
Rendering happens entirely in your app. The asset package includes embedded SVG strings, so nothing is fetched from Humation or anywhere else. Offline, in Node, in a Cloudflare Worker, inside a test — the output is the same.
There is no image generation involved. The artwork is drawn by people, and a seed only decides which parts are combined.
Install
For React apps, install the component together with the asset package. Outside React, install @humation/core instead of @humation/react — see Core.
bun add @humation/react @humation/assets-humation-1pnpm add @humation/react @humation/assets-humation-1npm install @humation/react @humation/assets-humation-1yarn add @humation/react @humation/assets-humation-1@humation/react
React component
Use this to render avatars in React. It wraps core.
@humation/core
Renderer and helpers
Use this for raw SVG output or to build a picker UI.
@humation/assets-humation-1
Assets
Required either way. It holds the artwork itself.
License
The packages and the artwork are MIT licensed. See the repository for the license text.