Skip to main content

​
What is Extra?

Extra is an open-source platform for building and running AI agent systems declaratively. You describe your agents, orchestrators, tools, MCP servers, and their connections in a YAML file. Extra validates, compiles, and runs that system — without you writing plumbing code. Because each agent is strictly scoped to its own domain — with its own tools, prompts, and data sources — the system produces accurate, grounded responses with no hallucination bleeding between domains. One spec file can orchestrate agents across any number of domains, all routing correctly with no coordination code.

​
Why Extra?

Most agent frameworks give you primitives and leave the hard parts to you: routing logic, prompt wiring, tool access control, auth, and tracing — all written by hand, every time. Extra moves that into a reusable runtime. You declare what your system is. Extra handles how it runs.

​
From spec to production

orchestrators:
  router:
    description: "Routes customer requests to the right department."
    prompts:
      orchestrator: "prompts/router.md"

agents:
  orders_agent:
    description: "Handles order status and tracking."
    tools: [get_order_status]
    mcps: [orders_api]

  returns_agent:
    description: "Handles return requests and refunds."
    tools: [create_return]

graph:
  router:
    orders_agent:
    returns_agent:
That’s your entire system. Extra generates the plugin stubs — you fill in the business logic. We validate, compile, and run it. Production-ready.
1

Write your spec

Declare agents, tools, and connections in YAML.
2

Generate

Run generate via Docker — Extra creates the plugin stubs from your spec. Fill them in with your business logic.
3

Fill in your logic

Implement the stubs — your APIs, your data, your auth.
4

Run

Extra validates, compiles, and serves. Done.

​
Key benefits

No coordination code

Define agents and their connections in YAML. Extra handles routing, scoping, and execution.

Domain isolation

Each agent is scoped to its domain. No hallucination bleeds between agents.

Any data source

Connect agents to remote MCP servers, local tools, or your own APIs — in any language.

Lifecycle hooks

Run trusted Python at fixed runtime points — MCP auth, env validation, auditing — without touching the engine.

Drop-in widget

Embed a full chat interface into any web app with a single HTML tag.

​
Next Steps

Quickstart

Run your first agent in 5 minutes.

Architecture

Understand how Extra routes and executes requests.