DOCSOverview
Run a policy-aware agent on Sui.
A few commands take you from install to a live chat. The chapters that follow walk the four-gate write pipeline, the CLI and config reference, and the operator console at /console.
- Architecture
A Bun monorepo. An advisory brain, a deterministic control layer, and a four-gate write pipeline on Sui.
- Identity
The agent is a Sui address derived from a local Ed25519 keypair, kept in an encrypted keystore. No on-chain mint required to start.
- Memory
Local files — markdown notes plus an index, kept on the operator's machine. No database, nothing uploaded.
- Brain
Any OpenAI-compatible model. Advisory only, never the safety boundary.
- Tools
The Sui limbs plus the host harness. Reads run freely; every write crosses the gates.
- CLI
The lyra binary. Init an agent, chat, bridge Telegram, run the gateway.
- Configuration
Configure the brain and the fund-control policy entirely from the environment. No code changes.
- For Agents
How AI agents (Claude Code, Codex, Cursor) install and operate Lyra for a human. What works, what to hand back, what never to claim.