What is AgentOS?

AgentOS is the FastAPI for agents. It serves agents as an API, an MCP server, and through chat interfaces like Slack, Telegram, and WhatsApp. Here’s the simplest possible example:

workbench.py

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.os import AgentOS
from agno.tools.workspace import Workspace

workbench = Agent(
    name="Workbench",
    model="openai:gpt-5.5",
    db=SqliteDb(db_file="workbench.db"),  # session storage
    tools=[Workspace(".")],               # read/write in this directory
    add_history_to_context=True,          # add past 3 runs to context
)

# Serve via AgentOS, get streaming, session isolation, API endpoints
agent_os = AgentOS(
    agents=[workbench],
    tracing=True,
    scheduler=True,
    mcp_server=True,
    db=SqliteDb(db_file="workbench.db"),
)
app = agent_os.get_app()

if __name__ == "__main__":
    agent_os.serve(app="workbench:app", reload=True)

AgentOS covers the valley of death between an agent definition and a live service. It gives agents a durable runtime, multi-user RBAC, background execution, checkpointing, session management, tracing, evals, guardrails, and more. Build agents, teams, and workflows with the Agno SDK. Run them with AgentOS. Manage and monitor them using the Control Plane.

What AgentOS gives you

Need	AgentOS capability
Product API	REST endpoints for running agents and managing sessions, memory, knowledge, traces, evaluations, schedules, and approvals
Interfaces	Built-in REST, SSE, and workflow WebSocket endpoints, plus configurable MCP, A2A, AG-UI, Slack, Telegram, and WhatsApp interfaces
Persistent state	Sessions, memory, knowledge, and runtime data stored in databases you configure
Long-running work	Background execution, buffered stream reconnection after client disconnects, human-in-the-loop, run cancellation, and persisted run history
Operations	Metrics, evaluations, opt-in tracing, approvals, schedules, and component versions
Access control	JWT authorization with RBAC, a shared security key, and scoped service accounts
Framework support	Native Agno components plus adapters for the Claude Agent SDK, LangGraph, DSPy, and Antigravity

Build, run, and manage

Layer	Role
SDK	Build agents, teams, and workflows with memory, knowledge, guardrails, and 100+ integrations
AgentOS	Run your agent platform in production with a stateless, secure FastAPI backend
Control Plane	Manage and monitor AgentOS runtimes from one web interface

The runtime exposes the APIs that power the Control Plane and your products.

Your runtime, your data

AgentOS runs in your infrastructure and writes runtime state to databases you configure. The Control Plane connects directly from your browser to the runtime endpoint. Model providers, tools, telemetry, and other external services follow the configuration of your application. See Security & Auth for authentication modes, service accounts, and endpoint permissions.

Next steps

Run your first AgentOS

Serve an agent through FastAPI and inspect its local API.

Deploy to your cloud

Start from a template with deployment, Postgres, and evals already wired in.

Connect the Control Plane

Manage and monitor a local or deployed runtime.

Use the API

Run components and manage runtime data over REST.

Run agents from a client

Use streaming, background execution, and buffered reconnection.

Secure your runtime

Configure authentication, permissions, and user isolation.

Get Started

AgentOS

Example Usage

What is AgentOS?

What AgentOS gives you

Build, run, and manage

Your runtime, your data

Next steps

Run your first AgentOS

Deploy to your cloud

Connect the Control Plane

Use the API

Run agents from a client

Secure your runtime

​What AgentOS gives you

​Build, run, and manage

​Your runtime, your data

​Next steps

Run your first AgentOS

Deploy to your cloud

Connect the Control Plane

Use the API

Run agents from a client

Secure your runtime

What AgentOS gives you

Build, run, and manage

Your runtime, your data

Next steps