Installation
Adding Cersei to your Rust project.
From crates.io
Cersei is published on crates.io — the standard install path:
[dependencies]
cersei = "0.1"
tokio = { version = "1", features = ["full"] }
anyhow = "1"Or via the CLI:
cargo add cersei
cargo add tokio --features full
cargo add anyhowOptional: Graph Memory
Enable the Grafeo graph backend for relationship-aware recall:
cersei-memory = { version = "0.1", features = ["graph"] }Optional: Individual Crates
Use specific crates if you only need parts of the SDK — every crate is published independently:
cersei-types = "0.1" # Core types only
cersei-provider = "0.1" # LLM providers
cersei-tools = "0.1" # Tool system
cersei-tools-derive = "0.1" # #[derive(Tool)] proc macro
cersei-agent = "0.1" # Agent runtime
cersei-memory = "0.1" # Memory backends
cersei-hooks = "0.1" # Hooks / middleware
cersei-mcp = "0.1" # MCP client
cersei-lsp = "0.1" # LSP client
cersei-embeddings = "0.1" # Embeddings + vector index
cersei-compression = "0.1" # Token-killer compression
cersei-skills = "0.1" # agentskills.io registry
cersei-vms = "0.1" # Sandbox / VM isolationAbstract CLI
Install the reference CLI tool built on Cersei directly from crates.io:
cargo install abstract-cliThis installs the abstract binary — a complete coding agent CLI.
One-line installer
Prefer not to manage a Rust toolchain? On macOS or Linux:
curl -fsSL https://cersei.pacifio.dev/install-abstract.sh | bashDetects your OS, installs Rust if needed, builds from source, and drops the binary on your PATH.
Tracking main
If you need an unreleased fix, point at the GitHub repo instead:
cersei = { git = "https://github.com/pacifio/cersei" }Environment Variables
| Variable | Provider | Required |
|---|---|---|
ANTHROPIC_API_KEY | Anthropic | For Claude models |
OPENAI_API_KEY | OpenAI | For GPT models |
At least one provider key is needed. Both can be set simultaneously.
System Requirements
- Rust 1.75+ (edition 2021)
rg(ripgrep) — optional, Grep tool falls back to systemgrep- macOS, Linux, or Windows