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

# Run Your AgentOS

> Run a local AgentOS in a few lines of code.

Save the following code to `agno_assist.py`:

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

agent = Agent(
    name="Agno Assist",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
)

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

<Check>
  An Agent served as a FastAPI application with persistent sessions.
</Check>

## Run Your AgentOS

<Steps>
  <Step title="Set up your virtual environment">
    <CodeGroup>
      ```bash Mac theme={null}
      uv venv --python 3.12
      source .venv/bin/activate
      ```

      ```bash Windows theme={null}
      uv venv --python 3.12
      .venv\Scripts\activate
      ```
    </CodeGroup>
  </Step>

  <Step title="Install dependencies">
    ```bash theme={null}
    uv pip install -U 'agno[os]' anthropic
    ```
  </Step>

  <Step title="Export your Anthropic API key">
    <CodeGroup>
      ```bash Mac theme={null}
      export ANTHROPIC_API_KEY=sk-***
      ```

      ```bash Windows theme={null}
      setx ANTHROPIC_API_KEY sk-***
      ```
    </CodeGroup>
  </Step>

  <Step title="Run your AgentOS">
    ```bash theme={null}
    python agno_assist.py
    ```
  </Step>
</Steps>

Your AgentOS is now running at `http://localhost:8000`.

| Endpoint                       | Description                   |
| ------------------------------ | ----------------------------- |
| `http://localhost:8000`        | Connect to the control plane  |
| `http://localhost:8000/docs`   | Interactive API documentation |
| `http://localhost:8000/config` | View AgentOS configuration    |

To manage your AgentOS in a UI, head to [os.agno.com](https://os.agno.com) and connect this runtime. See [Connect Your AgentOS](/agent-os/connect-your-os) for the steps.

For the full list of endpoints AgentOS exposes, see the [AgentOS API reference](/reference-api/overview).