anima · docs
Get startedQuickstart
Overview
Get started
Concepts
Reference
Operate

Run your first live agent.#

Three commands. The init wizard does the on-chain work in the background. By the end your agent has an iNFT, a wallet, a brain envelope, an encrypted memory partition, and a .anima.0g subname.

Prerequisites#

bun version 1.1 or newer. The CLI shebangs bun directly and preloads @opentui/solid/preload to run .tsx files without a build step. npm install works for putting the binary on PATH but the binary will exit if bun is missing.

A funded 0G operator wallet. The init wizard shows a live cost summary before the wallet signs anything; the breakdown comes from packages/cli/src/commands/init/cost.ts. Order of magnitude:

  • mint + setApprovalForAll: about 0.01 0G of gas.
  • storage upload of the keystore: about 0.005 0G of gas.
  • agent infra float: 0.1 0G. Funds the agent EOA; the agent pays its own subname claim (about 0.03 0G) from this.
  • compute ledger deposit: 3, 10, or 30 0G depending on the tier you pick in step 5.

So a Starter (3 0G ledger) mint costs the operator around 3.12 0G total. Standard (10 0G ledger) is around 10.12 0G. Extended (30 0G ledger) is around 30.12 0G. Testnet (Galileo) is free from the faucet.

Install#

bun add -g @s0nderlabs/anima

That installs the CLI binary as anima on your PATH and pulls every workspace package (@s0nderlabs/anima-core, anima-plugin-onchain, anima-plugin-comms, anima-plugin-system, anima-plugin-telegram, anima-gateway) as transitive deps.

Init#

anima init

The wizard runs in four phases. Phase A asks six questions locally. Phase B gates on the operator wallet. Phase C executes the on-chain work. Phase D writes config.

Phase A. Local prompts.

  1. Pick network. Mainnet (0g-mainnet, chainId 16661) or testnet (0g-testnet, chainId 16602).
  2. Pick where the agent runs. Two choices.
    • Local (default). The harness runs on this machine while the CLI is open, plus a standalone gateway daemon at ~/.anima/agents/<id>/gateway.sock for ambient triggers (Telegram, A2A) when the TUI is closed. No extra cost beyond the operator spend in step 5.
    • 0G Sandbox. The harness runs in a TDX TEE container on 0G Sandbox. Persistent across laptop closures. Today the Sandbox is Galileo testnet only, so this is a hybrid path: identity, wallet, Storage, and Compute live on whichever main network you picked in step 1, the container lives on Galileo testnet. Mainnet sandbox launches when 0G ships it; the CLI will switch automatically. Sandbox adds three cost components on top of the mainnet operator spend.
      1. Initial provider deposit. About 1 0G testnet, sent to the Galileo SandboxBilling contract at init time. The deposit is the runway from which the per-hour runtime fee is drawn. Refundable once the sandbox is fully retired.
      2. Hourly runtime fee. Scales with the sandbox size you run. The default snapshot daytonaio/sandbox:0.5.0-slim is 1 CPU and 1 GB at about 0.09 0G per hour, so a 1 0G deposit lasts roughly 11 hours of always-on runtime. The provider also supports larger configurations (e.g. openclaw at 2 CPU and 4 GB), priced per CPU-minute plus per-memory-GB-minute; the SandboxResources class option (small, medium, large) lets you trade size for cost. Today the init wizard always provisions the slim default; set sandbox.snapshotName in anima.config.ts post-init to override. Refill any time with anima topup --sandbox N.
      3. Pause to save. anima pause archives the container (stops the burn) without losing identity. anima resume brings the same sandbox back in 2 to 5 minutes. Twelve hours idle per day saves around 1.1 0G per day on runtime fees.
  3. Pick a subname under anima.0g (optional). The wizard checks on-chain availability at pick time.
  4. Pick a brain model from the live 0G Compute catalog. Per-token pricing shown.
  5. Pick a compute ledger deposit size. Starter 3 0G, Standard 10 0G, Extended 30 0G, or Custom.
  6. Set a keystore passphrase. This protects the encrypted agent privkey blob anchored on 0G Storage.

Phase B. Wallet gate.

  1. Pick operator wallet source. WalletConnect (mobile), macOS Keychain, keystore file, or raw private key.
  2. Review the cost summary in 0G and USD.
  3. If the operator balance is below the threshold, the wizard renders the operator address as a QR and polls the balance until you fund it (or you skip the ledger deposit or cancel).

Phase C. Execute.

The wizard writes .anima-init-state.json after each completed step so anima init --resume can pick up from a failure.

  1. Generate a fresh agent EOA. Save the encrypted keystore locally.
  2. Operator signs one transaction: mint(operatorAddress, intelligentDataEntries) plus setApprovalForAll(agentAddress, true). The agent EOA is now pre-approved to call update() on subsequent memory syncs without re-signing.
  3. Operator funds the agent EOA with about 10.1 0G. 0.1 covers infra gas, 10 covers the ledger deposit.
  4. Agent uploads the encrypted keystore blob to 0G Storage and anchors the root hash in the keystore IntelligentData slot. This is what makes anima restore work on a new machine.
  5. Agent opens a 0G Compute ledger via broker.ledger.addLedger.
  6. If a subname was chosen, agent claims <subname>.anima.0g via the permissionless AnimaSubnameRegistrar and writes the address plus pubkey text records.

Phase D. The wizard writes anima.config.ts with identity.iNFT, identity.operator, identity.agent, brain.provider, brain.model populated.

Chat#

anima

Drops you into the TUI. The status bar at the bottom shows perms: prompt (the default approval mode), the current brain model, and the agent's mainnet address. Type something the brain can answer. Try a tool call: "save a note that I prefer dark mode" or "what's my 0G balance".

Every turn syncs to 0G Storage and anchors the changed slot hashes on chain. Slash commands: /sync, /yolo, /perms <off|prompt|strict>, /reset, /jobs, /model, /exit, /help. Type / to open the autocomplete popup.

Escape aborts the current turn mid-flight. Control-U and Control-D scroll the history without leaving the input bar.

Walk away#

The agent is fully sovereign once init completes. You do not need to keep the CLI open. Two paths to ambient access:

  • Telegram bridge. Run anima telegram setup and pair a bot. Any DM hits the same brain, same tools, same approval modal. Approval prompts arrive as inline-keyboard buttons.
  • 0G Sandbox. Run anima deploy to migrate the harness to a persistent TDX enclave on Galileo testnet. The laptop CLI becomes a thin client over HTTP and SSE. Burn rate is about 0.09 0G per hour on testnet runtime fees.

Read Architecture next to understand how the layers fit together.

Source: packages/cli/src/commands/init.ts, packages/cli/src/commands/init.

Source: packages/cli/src/commands/init.ts

Quickstart · anima docs