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

# AgentOS Runtime

> Configure the FastAPI runtime that serves your agents, teams, and workflows.

Platform teams use AgentOS to serve agents, teams, and workflows through one FastAPI application. The runtime provides execution APIs, persistent state, authorization, tracing, and operational endpoints.

```python agent_os.py theme={null}
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses
from agno.os import AgentOS

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

assistant = Agent(
    id="assistant",
    model=OpenAIResponses(id="gpt-5.4"),
)

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

app = agent_os.get_app()

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

The AgentOS database becomes the default for local agents, teams, and workflows that do not define their own database. In this example it stores the agent's sessions and the runtime's traces.

## Choose Runtime Capabilities

Add capabilities as the application needs them:

| Requirement                            | AgentOS configuration          | Guide                                                           |
| -------------------------------------- | ------------------------------ | --------------------------------------------------------------- |
| Serve agents, teams, and workflows     | `agents`, `teams`, `workflows` | [Using the API](/agent-os/using-the-api)                        |
| Use a shared default database          | `db`                           | [Database](/database/overview)                                  |
| Require JWT authorization              | `authorization=True`           | [Authorization](/agent-os/security/authorization/overview)      |
| Store execution traces                 | `tracing=True`                 | [Tracing](/agent-os/tracing/overview)                           |
| Expose an MCP server                   | `mcp_server=True`              | [AgentOS as MCP Server](/agent-os/mcp/mcp)                      |
| Mount product and messaging interfaces | `interfaces=[...]`             | [Interfaces](/agent-os/interfaces/overview)                     |
| Run cron schedules                     | `scheduler=True`               | [Scheduler](/agent-os/scheduler/overview)                       |
| Extend an existing FastAPI application | `base_app=app`                 | [Bring Your Own FastAPI App](/agent-os/custom-fastapi/overview) |

## Database Behavior

| Configuration                  | Behavior                                                        |
| ------------------------------ | --------------------------------------------------------------- |
| Set `db` on AgentOS            | Components without a database inherit the AgentOS database      |
| Set a database on a component  | That component keeps its own database                           |
| Set `db` and `tracing=True`    | AgentOS stores all traces in the AgentOS database               |
| Omit `db` with `tracing=True`  | AgentOS uses the first component database it discovers          |
| Keep `auto_provision_dbs=True` | AgentOS creates the required tables when the application starts |

Set an explicit AgentOS database when the runtime manages several component databases. This gives tracing, service accounts, and scheduled jobs a predictable store.

## Runtime Methods

| Method         | Purpose                                                                                                   |
| -------------- | --------------------------------------------------------------------------------------------------------- |
| `get_app()`    | Build and return the configured FastAPI application                                                       |
| `serve()`      | Start the application with Uvicorn                                                                        |
| `get_routes()` | Return the FastAPI routes mounted by AgentOS                                                              |
| `resync(app)`  | Discover, initialize, and configure agents, teams, workflows, databases, and knowledge on an existing app |

### Host and Port

`serve()` reads `AGENT_OS_HOST` and `AGENT_OS_PORT`. Environment variables take precedence over method arguments.

| Setting         | Default     |
| --------------- | ----------- |
| `AGENT_OS_HOST` | `localhost` |
| `AGENT_OS_PORT` | `7777`      |

```bash theme={null}
export AGENT_OS_HOST=0.0.0.0
export AGENT_OS_PORT=8000
python agent_os.py
```

## Next Steps

| Task                                   | Guide                                                           |
| -------------------------------------- | --------------------------------------------------------------- |
| Call the runtime from an application   | [Using the API](/agent-os/using-the-api)                        |
| Add AgentOS to an existing backend     | [Bring Your Own FastAPI App](/agent-os/custom-fastapi/overview) |
| Configure the Control Plane experience | [AgentOS Configuration](/agent-os/config)                       |
| Review every constructor parameter     | [AgentOS class reference](/reference/agent-os/agent-os)         |