Reigner

A single agent that answers from your compiled corpus — every claim cited.

Reigner is a toolkit for building citation-faithful question-answering agents over a knowledge corpus. First you ingest your sources — a one-time compile step that reads your raw documents (PDF, text, HTML) and extracts the facts you care about into a structured store, its artifacts. A single retrieval agent then answers questions over that store — never touching your raw files at query time — with every factual claim traced back to its source. It is a library first: not a chat app, not a coding-agent harness, not a multi-agent orchestrator.

Reach for Reigner when you want a Q&A agent shaped to your corpus and use case — not a fixed product. It's a library you tune end to end: the instructions, the tools, the schema, the model are all yours to change. Within that flexibility it keeps two things hard — citation-faithfulness is a testable property (the eval fails uncited claims), and a cheap model handles the routine work so cost stays bounded.

One core, three surfaces

Reigner is a library: you write one agent and reach it three ways as it grows from an idea to a running service. The agent is a small project folder — a REIGNER.md of instructions, a schema, and your tools — and it stays the same folder at every step.

• Build — Write your agent as code. reigner init scaffolds the project folder for you: the REIGNER.md instructions, a schema and extractor (how your documents become searchable), plus any @tools or plugins you add. This folder is your agent.
• Test — Run it from your terminal. ingest compiles your documents, chat asks questions, and session fork / replay / export / eval let you A/B/C different instructions, tools, or models — so you tune without starting over.
• Ship — Serve it over HTTP. serve exposes that same folder through a FastAPI + SSE endpoint, so your apps consume it with no rewrite.

MCP export is planned

reigner serve --http works today. reigner serve --mcp is scaffolded but not yet wired — it exits with a clear "not yet implemented" message. The "ship" surface is FastAPI/SSE for now.

Where to go next

• Usage guide — hands-on, install → scaffold → ingest → chat, with a per-feature status flag on everything.
• Architecture — the harness: the agent loop, oracle escalation, and the G1–G11 context-management guardrails.
• Observability — turn the agent loop into OpenTelemetry spans.
• Principles — why Reigner exists and the rationale behind each design decision.
• API reference — the typed public API.

Install

uv add 'reigner[anthropic,ingestion]'      # model adapter + PDF/URL loaders

Reigner ships a thin core; each capability is an opt-in extra — see the usage guide for the full extras table.