Squishmoji
by Space UI
React and TypeScript library that generates deterministic, animated squishy SVG avatars and emojis from a seed string.
Avatars and placeholders Code libraryOpen source

1. Price: github.com/usespaceui/squishmoji
Free and open source under the MIT license.
github.com/usespaceui/squishmojiNo quote yet: price is read from the official pages.
2. Commercial use: github.com/usespaceui/squishmoji
“MIT — Free for personal and commercial projects.”
Free for personal and commercial projects under MIT.
github.com/usespaceui/squishmoji3. Credit the author: LICENSE on GitHub
“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.”
No credit on screen. Keep the license notice inside the code you ship.
LICENSE on GitHub4. Agent access: github.com/usespaceui/squishmoji
An agent can install it by itself with npm install @usespaceui/squishmoji. No key or account is needed.
github.com/usespaceui/squishmojiLicense checked Nov 4, 2026 against 2 official pages. Tap a verdict to see its source. How we checked Report an error
Squishmoji: cute animated avatars made from any name
Squishmoji is a free code library that draws a small squishy character with eyes from any text, such as a user name. The same name always gives the same character, so every user gets a stable picture without uploading a photo. The pictures are SVG drawings made in the browser or on your server, can breathe and blink, and work best in React apps.
Where you can use it
Profile pictures without uploads
Give every account its own picture from the user name or ID. It stays the same on every visit, and nobody has to upload a photo.
Avatars made on your server
Make the picture as a ready file on the server, for an email, a server-rendered page or a link preview. No React is needed for this.
A mascot that reacts
Put a small character on a login screen or an empty page. It can look surprised when the pointer is over it and change its face when clicked.
Moods and reactions in chat
Show a mood next to a message or a status, such as happy, sleepy or angry. The same character keeps its colors while its eyes change.
Faces for AI helpers and bots Idea
Give each AI assistant or bot in your app its own face, for example with the bot or alien shape, so people can tell them apart.
Placeholder people in mockups Idea
Fill demo lists, team pages and screenshots with friendly faces instead of stock photos of real people.
As reported by Space UI: 100% deterministic: the same seed and options always give the same picture.
Squishmoji popularity
Downloads not confirmed by community. 2 GitHub stars for 17.7K downloads a week. Bots and CI installs can inflate npm counts.
GitHub stars stayed at 2 since Nov 7, 2026, so there is no stars chart.
Downloads from api.npmjs.org, stars from GitHub, checked Nov 19, 2026. How the Gid Score is calculated
How to start
Tell your AI assistant
“Install @usespaceui/squishmoji at version 0.1.0 and show a Squishmoji avatar for each user, using the user ID as the seed, with animation turned off when the user prefers reduced motion.”
Or install it yourself. It pulls in its color helper by itself; only the React part needs React 18 or newer.
npm install @usespaceui/squishmoji
Show codeReact or Without React
In a React app, put the component where the avatar should appear and pass the user name or ID as the seed.
import { Squishmoji } from '@usespaceui/squishmoji/react'
export default function UserProfile() {
return (
<Squishmoji
seed="space-explorer"
shape="cat"
expression="loving"
size={120}
className="rounded-full"
animate
animOnClick
animOnHover
/>
)
}
Without React, or on the server, call createAvatar to get the finished drawing as text.
import { createAvatar, resolveLayout, renderLayout, SquishOutputFormat } from '@usespaceui/squishmoji'
// 1. Generate raw SVG markup (default)
const svg = createAvatar('space-explorer', {
shape: 'ufo',
expression: 'amazed',
size: 256,
backgroundStyle: 'solid',
})
Mistakes to avoid
import { Squishmoji } from '@usespaceui/squishmoji'import { Squishmoji } from '@usespaceui/squishmoji/react' (the root import only has createAvatar and helpers)The React component lives in the /react entry; in 0.1.0 the root file exports no Squishmoji or Avatar.
With no seed every user gets the default "Space UI" avatar, and a renamed user would get a new picture.
By default only the colors follow the seed; the shape stays circle and the face neutral (our sign-up demo with a fixed shape shows only color changes).
The library imports @usespaceui/gradients by its bare name; our no-bundler demo page only loaded after an import map pointed that name at the file.
The component animates by default (breathing, gaze drift, blinking).
License
MIT license. Free to use in personal and paid products, and you may change and share the code. When you ship copies of the code, keep its copyright and license notice with them.
“MIT — Free for personal and commercial projects.” github.com/usespaceui/squishmoji
“The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.” LICENSE on GitHub
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” LICENSE on GitHub
You may copy, publish and sell copies of the code if the MIT notice goes with them.
“to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software” LICENSE on GitHub
AllowedWith conditionsNot allowedNot stated or not checked yet
Is Squishmoji free for commercial use? The full answer Not legal advice. Check the license page before you ship.
For your agent
License rules tell your agent what it may do with Squishmoji. Paste them into your prompt or AGENTS.md.
- Squishmoji (Avatars and placeholders). React and TypeScript library that generates deterministic, animated squishy SVG avatars and emojis from a seed string. Price: free; commercial use OK; no credit needed.
Connect: npm @usespaceui/squishmoji.
Rule: Keep the MIT license file and copyright notice with any copies or substantial portions you ship.
Rule: Install via npm (@usespaceui/squishmoji) and generate avatars locally; no remote images or API calls are needed.
Rule: Use createAvatar for static SVG in Node, SSR or vanilla JS; use the /react entry only with React 18+.
License: https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE (checked 2026-11-04; details: https://agentgid.com/assets/squishmoji/)
Agent installs a package or loads it from a CDN.
npm install @usespaceui/squishmojiAvatars: Squishmoji by Space UI (MIT)Alternatives
Squishmoji This page
Pick DiceBear when you want many different avatar styles or a ready image link from a free web service instead of a code library.
Pick Boring Avatars for calmer, abstract shapes and colors in React instead of characters with faces.
Pick Avvvatars when you want simple placeholders with initials or shapes made from a name.
Free open-source React component that renders deterministic generative mesh-gradient or dither avatars on a canvas from any seed.
Curated registry of free 3D VRM avatars (rigged characters for web 3D, VR, games) with direct download links; CC0.
Questions
Will a user get the same avatar every time?
Yes. The same seed, for example a user ID, with the same options always gives the same shape, colors and outline.
How many looks are there?
21 body shapes (from circle to cat, ghost, bot and alien), 22 eye expressions and 6 background styles; pass "all" to let the seed choose.
Do I need React?
Only for the ready-made animated component, which needs React 18 or newer. The createAvatar function works without React, also on a server.
Can I get a still image instead of an animation?
Yes. Set animate to false, freeze the animation at a moment with frozenAt, or use createAvatar for a still drawing.
Can I use it in a paid app?
Yes. It is MIT licensed and free for personal and commercial projects.