# Humation Docs

> Deterministic hand-drawn avatars from local SVG assets. No API call required.

## Guides

- [Introduction](https://docs.humation.app/): Add deterministic kawaii avatars to your app. No API call required.
- [React](https://docs.humation.app/react): The Avatar component renders an <svg> element directly. It is the shortest path for product UI.
- [Core](https://docs.humation.app/core): @humation/core renders avatars to SVG without React. Use it in Node, Cloudflare Workers, export jobs, tests, or a framework of your own.
- [Customizing](https://docs.humation.app/customizing): How part selections resolve, which colors are recolorable, and how to build a picker UI on top of the manifest.
- [Saving state](https://docs.humation.app/state): What to persist when a user edits their avatar.

## Reference

- [Parts](https://docs.humation.app/parts): Every part in the Humation 1 asset package. Click one to copy its name for use in selections.
- [Options](https://docs.humation.app/options): Everything you can pass to the React component and to createAvatar, with the helpers and types that support them.
- [For LLMs](https://docs.humation.app/llms): Humation is small enough for a coding agent to use correctly from a short brief. This page is that brief.
- [Changelog](https://docs.humation.app/changelog): What changed in each stable Humation release, including upgrade notes for the packages and artwork.

## Agent resources

- [llms-full.txt](https://docs.humation.app/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.humation.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.humation.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.humation.app/openapi.json.
- [API catalog](https://docs.humation.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://docs.humation.app/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://docs.humation.app/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.humation.app/sitemap.xml): Every indexable page URL with its last-modified date.