Configure AgentOS

AgentOS gives engineering teams building agent-powered products one FastAPI runtime for agents, teams, and workflows. The runtime provides stable APIs for runs, sessions, memory, knowledge, traces, schedules, and approvals.

product_os.py

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS

db = SqliteDb(db_file="agentos.db")

agent = Agent(
    id="product-agent",
    model=Claude(id="claude-sonnet-4-5"),
)

agent_os = AgentOS(
    id="product-platform",
    agents=[agent],
    db=db,
    tracing=True,
)

app = agent_os.get_app()

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

db supplies the default storage for the registered agent and stores its traces. get_app() returns the configured FastAPI application.

Choose What to Enable

Start with the capabilities your application needs. Add the rest as the platform moves toward production.

Requirement	Configuration	Guide
Serve agents, teams, and workflows	`agents=[...]`, `teams=[...]`, `workflows=[...]`	Use the API
Persist sessions and enabled memory	`db=...`	Databases
Inspect production runs	`tracing=True` with a database	Tracing
Protect API endpoints	`authorization=True` with a JWT verification source	Authorization
Isolate user data	JWT authorization plus `AuthorizationConfig(user_isolation=True)`	Per-user isolation
Connect MCP clients	`mcp_server=True`; add `mcp_auth=...` for OAuth	MCP
Add chat and protocol surfaces	`interfaces=[...]`	Interfaces
Run recurring jobs	`scheduler=True` with an AgentOS database	Scheduler
Extend an existing FastAPI service	`base_app=app`	Custom FastAPI

Python and YAML Configuration

Register live components through the AgentOS constructor. Set config to a YAML path or an AgentOSConfig object for quick prompts, display names, and database mappings used by the Control Plane.

agent_os = AgentOS(
    agents=[agent],
    db=db,
    config="config.yaml",
)

See AgentOS Configuration for the YAML schema and typed configuration options.

Developer Resources

Task	Guide
Run a local AgentOS	Run Your AgentOS
Call agents from an application	Use the AgentOS API
Review every constructor parameter and method	AgentOS class reference

Get Started

AgentOS

Example Usage

Configure AgentOS

Choose What to Enable

Python and YAML Configuration

Developer Resources

​Choose What to Enable

​Python and YAML Configuration

​Developer Resources

Choose What to Enable

Python and YAML Configuration

Developer Resources