Change language
Get Started
Architecture

Engineered for Scale

8 purpose-built modules, hierarchical orchestration, battle-tested persistence

8 modules, one agent

Each layer is purpose-built. Together they form a research engine that scales from one query to thousands.

CoreConfig & bootstrap
LLMProvider abstraction
AgentParallel orchestration
Tools44+ built-in
MCPExternal protocol
PersistenceSQLite WAL
ServerSSE event stream
TUITerminal interface

6 pillars of the architecture

🔀

Multi-Agent Orchestration

A coordinator agent decomposes complex research tasks into parallel sub-tasks. Specialized researcher agents run concurrently, each exploring a different data source. A writer agent synthesizes findings into a unified, structured report.

Coordinator → Researcher × N → Writer
🧠

Context Management

Two-phase compaction keeps context windows clean: micro-deduplication removes redundant tool outputs, then LLM-powered summarization compresses long histories. An anti-thrashing cooldown prevents rapid token oscillation between turns.

Micro dedup → LLM summarize → Cooldown
🛡️

Safety & Security

Built-in SSRF guards block internal network access. Prompt injection detection neutralizes adversarial inputs. Destructive command blocking prevents accidental data loss. Doom loop detection halts runaway agents.

SSRF · Injection · Destructive · Doom loop
💾

Persistent State

SQLite with WAL mode provides crash-safe persistence. All contacts, messages, and research artifacts survive restarts. TOCTOU-safe contact deduplication ensures no duplicates even under concurrent writes.

SQLite WAL · Crash recovery · TOCTOU-safe
🔌

Extensibility

MCP (Model Context Protocol) lets you plug in external tools and data sources. Lifecycle hooks let you intercept agent actions. Custom search backends swap in your proprietary knowledge bases.

MCP · Hooks · Custom backends
📊

Observability

Prometheus-compatible metrics expose latency, token usage, and success rates. Structured JSON logging captures every agent action. SSE event streaming gives real-time visibility into running tasks.

Prometheus · Structured logs · SSE
49
built-in tools
7
search backends
128K
context window
parallel agents

Battle-tested Rust stack

tokioaxumratatuirusqlite (WAL)tokio-postgresscraperquick-xmltiktoken-rslopdfphonenumberlettrereqwest-eventsourceschemarsuuid v7

Rust 1.82 · edition 2021 · ~62k LOC · 1082 tests · release with LTO + strip · MIT

Ready to go deeper?

Explore the full technical documentation — architecture decisions, API reference, and deployment guides.