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

# What is AgentOS?

> The production runtime and control plane for multi-agent systems.

**AgentOS turns your agents into a production service you can deploy anywhere.**

* **Production API**: 50+ ready to use endpoints with SSE-compatible streaming.
* **Data Ownership**: Sessions, memory, knowledge, and traces stored in your database.
* **Request Isolation**: No state bleed between users, agents, or sessions.
* **Security**: JWT-based RBAC with hierarchical scopes.
* **Observability**: Traces stored in your database with no third-party egress or vendor lock-in.
* **Governance**: Guardrails, human-in-the-loop, and approval flows for full control.

Here's a minimal example of the AgentOS serving an Agent with memory, state and MCP:

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

agno_assist = Agent(
    name="Agno Assist",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
    tools=[MCPTools(url="https://docs.agno.com/mcp")],
    add_datetime_to_context=True,
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

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

## Architecture

AgentOS consists of two parts:

1. **Runtime**: Runs agents built with the Agno SDK (using FastAPI).
2. **Control plane**: UI for managing, monitoring, and debugging your system.

The runtime exposes a set of APIs that powers both, the control plane and your AI products.

<img className="block dark:hidden" src="https://mintcdn.com/agno-v2-update-deprecated-models/pmcAegusM2TuIVwq/images/agent-os/agentos-architecture-light.png?fit=max&auto=format&n=pmcAegusM2TuIVwq&q=85&s=43aebdbb8b6be27be75ea8b74840e31c" alt="AgentOS Architecture" width="2457" height="2670" data-path="images/agent-os/agentos-architecture-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/agno-v2-update-deprecated-models/pmcAegusM2TuIVwq/images/agent-os/agentos-architecture-dark.png?fit=max&auto=format&n=pmcAegusM2TuIVwq&q=85&s=562835751a5eab18d436813a2bc867b3" alt="AgentOS Architecture" width="2457" height="2670" data-path="images/agent-os/agentos-architecture-dark.png" />

The AgentOS runs as a container in your cloud. The UI connects directly from the browser. No proxies. No data relays. Your data stays completely private.

<Frame>
  <video autoPlay muted loop playsInline controls style={{ borderRadius: "0.5rem", width: "100%", height: "auto" }}>
    <source src="https://mintcdn.com/agno-v2-update-deprecated-models/k7Ga90os6iR27gjy/videos/agentos-agent-chat.mp4?fit=max&auto=format&n=k7Ga90os6iR27gjy&q=85&s=5186bb97ed40861d46ae6b606baa2d11" type="video/mp4" data-path="videos/agentos-agent-chat.mp4" />
  </video>
</Frame>

## Private by Design

Most AI tooling stores your data on their servers. You pay retention costs, deal with egress fees, and depend on their security. AgentOS runs entirely in your infrastructure:

* **Your database**: Sessions, memory, knowledge, traces. All stored where you control it.
* **Zero transmission**: No conversations, logs, or metrics sent to Agno.
* **From browser to runtime**: The control plane connects from your browser to the runtime. Agno stores no data except for your runtime endpoint. All data resides in your database.

See [AgentOS Security](/agent-os/security) for more details.

<Frame>
  <img src="https://mintcdn.com/agno-v2-update-deprecated-models/pmcAegusM2TuIVwq/images/agentos-secure-infra-illustration.png?fit=max&auto=format&n=pmcAegusM2TuIVwq&q=85&s=e0067818ced3c9287e47a6aaa2714796" alt="AgentOS Security and Privacy Architecture" style={{ borderRadius: "0.5rem" }} width="3258" height="1938" data-path="images/agentos-secure-infra-illustration.png" />
</Frame>

## Next Steps

<CardGroup cols={2}>
  <Card title="Run Your First AgentOS" icon="plus" href="/agent-os/run-your-os">
    Initialize and serve a basic agent.
  </Card>

  <Card title="Connect AgentOS to UI" icon="link" href="/agent-os/connect-your-os">
    Manage AgentOS using a Web UI.
  </Card>

  <Card title="Control Plane" icon="desktop" href="/agent-os/control-plane">
    Inspect sessions and debug traces.
  </Card>

  <Card title="Learn More" icon="book" href="/agent-os/overview">
    Learn more about AgentOS
  </Card>
</CardGroup>
