# Squishmoji — card for AI agents

React and TypeScript library that generates deterministic, animated squishy SVG avatars and emojis from a seed string.

Category: Avatars and placeholders · maker Space UI · checked 2026-11-04

## Price
- Price: Free
- Free tier: Free and open source under the MIT license

## License
MIT — https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE

- commercial: **yes** (Commercial use OK)
  > MIT — Free for personal and commercial projects.
  (https://github.com/usespaceui/squishmoji)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
  (https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE)
- in app: **yes** (Can ship inside your app)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software
  (https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE)

## Rules to follow
- Keep the MIT license file and copyright notice with any copies or substantial portions you ship.
- Install via npm (@usespaceui/squishmoji) and generate avatars locally; no remote images or API calls are needed.
- Use createAvatar for static SVG in Node, SSR or vanilla JS; use the /react entry only with React 18+.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How to connect
- Package (npm/PyPI)
- npm: `npm install @usespaceui/squishmoji`
- Repository: https://github.com/usespaceui/squishmoji
- Website: https://github.com/usespaceui/squishmoji

## Notes
Added automatically. License read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 29
- GitHub stars: 2
- Downloads last week: 17,697

## Lines to paste 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/)
```

## Links
- AgentGid page: https://agentgid.com/assets/squishmoji/
- Is it free for commercial use? https://agentgid.com/assets/squishmoji/commercial-use/
- Source: https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE
- Source: https://github.com/usespaceui/squishmoji


## 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 to 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: 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. (idea, not from the official pages)
- Placeholder people in mockups: Fill demo lists, team pages and screenshots with friendly faces instead of stock photos of real people. (idea, not from the official pages)

### How to start
- Install the package. It pulls in its color helper by itself; only the React part needs React 18 or newer.

```
npm install @usespaceui/squishmoji
```

- 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',
})
```


### 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.

### Good to know
- Only one version, 0.1.0, has been released so far. Pin that exact version, because early versions can change without warning.
- The ready-made component needs React 18 or newer. In other setups you use the plain createAvatar function instead.
- Avatars move by default: they breathe, look around and blink. Turn this off for still pictures or for people who prefer less motion.
- Everything is drawn on your side. No account, no key and no outside image service is needed.

Checked 2026-11-09 against: https://github.com/usespaceui/squishmoji, https://github.com/usespaceui/squishmoji/blob/HEAD/README.md, https://github.com/usespaceui/squishmoji/blob/HEAD/LICENSE, https://registry.npmjs.org/@usespaceui/squishmoji, https://registry.npmjs.org/@usespaceui/gradients, https://www.spaceui.one/tools/avatars?type=squishmoji, https://squishmoji.spaceui.one

### Mistakes to avoid
- Don't: import { Squishmoji } from '@usespaceui/squishmoji' → Do: 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.)
- Don't: Calling createAvatar() or <Squishmoji /> without a seed, or with a display name that users can change → Do: Always pass a stable seed such as the user ID (With no seed every user gets the default "Space UI" avatar, and a renamed user would get a new picture.)
- Don't: Expecting different seeds to give different shapes and faces with default options → Do: Pass shape: 'all', expression: 'all' and backgroundStyle: 'all' for a full mix, or set them on purpose (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).)
- Don't: Loading node_modules/@usespaceui/squishmoji/dist/index.mjs in a plain <script type="module"> page → Do: Use a bundler (Vite, Next) or add an import map entry for @usespaceui/gradients (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.)
- Don't: Using the animated React component for still images in emails or previews → Do: Use createAvatar, frozenAt or animate={false} for still output (The component animates by default (breathing, gaze drift, blinking).)

### 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
