> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-homepage-20260719-015142.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# What is AgentOS?

> The FastAPI runtime for serving agents, teams, and workflows.

**AgentOS is a FastAPI-powered runtime for serving multi-agent systems.**

The smallest AgentOS looks like this:

```python agno_assist.py theme={null}
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS

agent = Agent(
    name="Agno Assist",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
)

agent_os = AgentOS(agents=[agent])
app = agent_os.get_app()
```

This registers one agent, stores its sessions in a local SQLite database, and returns a FastAPI app that you can run locally or deploy to your cloud provider.

Engineering teams use AgentOS to serve agents, teams, and workflows through one backend. It provides REST endpoints for runs, sessions, memory, knowledge, evaluations, approvals, and schedules. Add MCP, messaging interfaces, tracing, and JWT authorization as your deployment needs them.

Build components with the [Agno SDK](/sdk/introduction) or supported adapters for the [Claude Agent SDK, LangGraph, DSPy, and Antigravity](/agent-os/multi-framework/overview). Register them with AgentOS to power product features, automations, and internal tools.

## What AgentOS Provides

| Capability        | What It Does                                                                                                          |
| ----------------- | --------------------------------------------------------------------------------------------------------------------- |
| API               | Exposes 80+ REST endpoints with SSE streaming for runs                                                                |
| Persistence       | Stores sessions and enabled memory, knowledge, evaluation, approval, schedule, and trace data in configured databases |
| Request isolation | Deep-copies native Agno components on core REST, MCP, and A2A run endpoints                                           |
| Authorization     | Supports JWT validation, endpoint permissions, service accounts, and opt-in per-user data isolation                   |
| Observability     | Writes OpenTelemetry traces to a configured database when tracing is enabled                                          |
| Interfaces        | Serves MCP, A2A, AG-UI, Slack, WhatsApp, and Telegram when configured                                                 |
| Multi-framework   | Runs native Agno components alongside Claude Agent SDK, LangGraph, DSPy, and Antigravity adapters                     |

## Architecture

AgentOS has two parts:

| Layer         | Role                                                                                 |
| ------------- | ------------------------------------------------------------------------------------ |
| Runtime       | Runs agents, teams, and workflows as a FastAPI service                               |
| Control Plane | Provides the web interface for testing, inspecting, and operating connected runtimes |

The runtime exposes the same APIs to your product and the [AgentOS Control Plane](/agent-os/control-plane).

<img className="block dark:hidden" src="https://mintcdn.com/agno-v2-codex-homepage-20260719-015142/tHUHyfGmYZ8fM1DC/images/agent-os/agentos-architecture-light.png?fit=max&auto=format&n=tHUHyfGmYZ8fM1DC&q=85&s=c223e2b68b540c32f698276af7fdb453" alt="Products and the AgentOS Control Plane connecting to an AgentOS runtime" width="2457" height="2670" data-path="images/agent-os/agentos-architecture-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/agno-v2-codex-homepage-20260719-015142/tHUHyfGmYZ8fM1DC/images/agent-os/agentos-architecture-dark.png?fit=max&auto=format&n=tHUHyfGmYZ8fM1DC&q=85&s=e2b4db0daf18e5340484e813dd9505c0" alt="Products and the AgentOS Control Plane connecting to an AgentOS runtime" width="2457" height="2670" data-path="images/agent-os/agentos-architecture-dark.png" />

## Where Data Flows

Your AgentOS runtime and configured databases run in infrastructure you control. The Control Plane sends requests directly from your browser to the selected runtime.

| Layer                         | Data Path                                                      |
| ----------------------------- | -------------------------------------------------------------- |
| Runtime                       | Runs in your infrastructure                                    |
| Stored application state      | Written to the databases you configure                         |
| Control Plane requests        | Travel from the browser to the selected runtime                |
| Models, tools, and interfaces | Call the external services you configure                       |
| Agno telemetry                | Sends usage metadata according to your telemetry configuration |

See [Telemetry](/telemetry) for the collected fields and configuration options. See [Security & Auth](/agent-os/security/overview) for runtime authentication and authorization.

## Next Steps

<CardGroup cols={2}>
  <Card title="Run AgentOS Locally" icon="play" href="/agent-os/run-your-os">
    Serve one agent and store its sessions in SQLite.
  </Card>

  <Card title="Connect the Control Plane" icon="link" href="/agent-os/connect-your-os">
    Connect a local or deployed runtime to the web interface.
  </Card>

  <Card title="Use the Control Plane" icon="desktop" href="/agent-os/control-plane">
    Run components, inspect execution, and operate the connected runtime.
  </Card>

  <Card title="Security & Auth" icon="shield" href="/agent-os/security/overview">
    Protect endpoints with a security key, JWTs, and scoped permissions.
  </Card>
</CardGroup>

## Developer Resources

* [Configure AgentOS](/agent-os/overview)
* [AgentOS class reference](/reference/agent-os/agent-os)
