Quickstart
Self-hosted aeqi, running locally in under 5 minutes. For the hosted platform, start with Getting started. MCP is a developer integration path after your TRUST exists.
1. Install
Install script (Linux, macOS, WSL):
curl -fsSL https://raw.githubusercontent.com/aeqiai/aeqi/main/scripts/install.sh | sh
Or build from source (requires Rust stable):
git clone https://github.com/aeqiai/aeqi.git
cd aeqi
cargo build --release
# binary at target/release/aeqi
See Installation for Cargo, Docker, and manual source builds.
2. Configure
aeqi setup
The wizard detects your environment: inside a git repo it configures the current workspace, otherwise it writes to ~/.aeqi/. SQLite databases are created on first run.
Set an LLM provider key:
aeqi secrets set OPENROUTER_API_KEY sk-or-...
OpenRouter, Anthropic, and Ollama are supported.
3. Start
aeqi start
Runs the daemon, REST API, and dashboard in one process. Default port is 8400.
4. Open the Dashboard
http://127.0.0.1:8400
Sign in and hire your first agent.
Next Steps
- Concepts: Agents — the agent tree and identity model
- Concepts: Quests — how work gets dispatched
- MCP Integration — drive your hosted TRUST from Codex, Claude Code, or another MCP client
- Claude Code + aeqi — Claude-specific setup and hooks