# anima

> First fully on-chain sovereign agent harness on 0G. CLI-hosted agent with identity (ERC-7857 iNFT), memory (0G Storage), brain (0G Compute TeeML), and wallet anchored to 0G's decentralized infrastructure. Operator runs `anima init` once; the agent persists on chain and survives operator death.

## Install

bun is REQUIRED. The CLI shebangs `#!/usr/bin/env bun`. `npm install -g` puts the binary on PATH but it exits at runtime without bun.

```
curl -fsSL https://bun.sh/install | bash
bun add -g @s0nderlabs/anima
anima init
```

Current version: 0.26.0. Requires bun >=1.1. Published as `@s0nderlabs/anima` on npm; binary name is `anima`.

## For AI agents

`anima init` is interactive (8 blocking prompts, no env-var bypass except `ANIMA_OPERATOR_PRIVKEY`). Two paths: guide the human through the wizard, OR puppet the TUI via `tmux send-keys` if you have shell access (Claude Code, Codex). Naive `echo y | anima init` will hang. No one-shot chat mode; drive the TUI in tmux or hit the standalone gateway daemon. Full install model, anti-patterns, common errors, state layout: https://anima.s0nderlabs.xyz/docs/agents.md

- Full single-file dump: https://anima.s0nderlabs.xyz/llms-full.txt
- Per-page raw markdown: https://anima.s0nderlabs.xyz/docs/<slug>.md (e.g. https://anima.s0nderlabs.xyz/docs/quickstart.md)

## Docs

- [Introduction](https://anima.s0nderlabs.xyz/docs/introduction.md): A sovereign agent harness with no central operator. Six layers, all on 0G.
- [Quickstart](https://anima.s0nderlabs.xyz/docs/quickstart.md): Install, init, chat. From zero to a live agent in three commands.
- [Architecture](https://anima.s0nderlabs.xyz/docs/architecture.md): Six layers, each anchored to a 0G primitive. One gateway, six event sources, two deployment modes.
- [Identity](https://anima.s0nderlabs.xyz/docs/identity.md): The iNFT is the agent. Six slots, two wallets, one subname.
- [Memory](https://anima.s0nderlabs.xyz/docs/memory.md): Two partitions, one index, end-to-end encryption. Memory is markdown, not a vector store.
- [Brain](https://anima.s0nderlabs.xyz/docs/brain.md): 0G Compute via the serving-broker. TeeML attested inference. Fail loud, never fall back.
- [Tools](https://anima.s0nderlabs.xyz/docs/tools.md): Dumb limbs the brain calls. Every dangerous call passes through an approval gate.
- [CLI](https://anima.s0nderlabs.xyz/docs/cli.md): Every anima command, every flag. The CLI is the single orchestration plane.
- [Configuration](https://anima.s0nderlabs.xyz/docs/configuration.md): One TS module, fully typed via defineConfig. Every key, every default.
- [Console](https://anima.s0nderlabs.xyz/docs/console.md): A browser-side operator dashboard plus the web-app gateway. SIWE, keystore unlock, encrypted memory browsing, and live web chat with your agent.
- [For Agents](https://anima.s0nderlabs.xyz/docs/agents.md): How AI agents (Claude Code, Codex, Cursor) install and operate anima for a human user. What works headless, what does not, what to never claim.

## Reference

- README: https://github.com/s0nderlabs/anima#readme
- Console: https://anima.s0nderlabs.xyz/console
- Releases: https://github.com/s0nderlabs/anima/releases
- Networks: mainnet chainId 16661 (https://evmrpc.0g.ai), testnet Galileo chainId 16602 (https://evmrpc-testnet.0g.ai)
- AnimaAgentNFT (ERC-7857): 0x9e71d79f06f956d4d2666b5c93dafab721c84721 (mainnet + Galileo testnet via CREATE2)
- AnimaSubnameRegistrar: 0x33d9f4ec2bd7e7cb4e288c3bbc3a76be472fdd98 (mainnet)
- AnimaInbox: 0xcd92844cc0ec6Be0607B330D4BaCC707339f2589 (mainnet)
- AnimaMarket: 0x3ebD21f5dd67acDeF199fACF28388627212bA2aB (mainnet)