> ## 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.

# Configure AgentOS

> Configure persistence, tracing, authentication, MCP, interfaces, and scheduling for an AgentOS runtime.

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.

```python product_os.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

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](/agent-os/using-the-api)                                |
| Persist sessions and enabled memory | `db=...`                                                          | [Databases](/database/overview)                                       |
| Inspect production runs             | `tracing=True` with a database                                    | [Tracing](/agent-os/tracing/overview)                                 |
| Protect API endpoints               | `authorization=True` with a JWT verification source               | [Authorization](/agent-os/security/authorization/quickstart)          |
| Isolate user data                   | JWT authorization plus `AuthorizationConfig(user_isolation=True)` | [Per-user isolation](/agent-os/security/authorization/user-isolation) |
| Connect MCP clients                 | `mcp_server=True`; add `mcp_auth=...` for OAuth                   | [MCP](/agent-os/mcp/mcp)                                              |
| Add chat and protocol surfaces      | `interfaces=[...]`                                                | [Interfaces](/agent-os/interfaces/overview)                           |
| Run recurring jobs                  | `scheduler=True` with an AgentOS database                         | [Scheduler](/agent-os/scheduler/overview)                             |
| Extend an existing FastAPI service  | `base_app=app`                                                    | [Custom FastAPI](/agent-os/custom-fastapi/overview)                   |

## 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.

```python theme={null}
agent_os = AgentOS(
    agents=[agent],
    db=db,
    config="config.yaml",
)
```

See [AgentOS Configuration](/agent-os/config) for the YAML schema and typed configuration options.

## Developer Resources

| Task                                          | Guide                                                   |
| --------------------------------------------- | ------------------------------------------------------- |
| Run a local AgentOS                           | [Run Your AgentOS](/agent-os/run-your-os)               |
| Call agents from an application               | [Use the AgentOS API](/agent-os/using-the-api)          |
| Review every constructor parameter and method | [AgentOS class reference](/reference/agent-os/agent-os) |