Run Your AgentOS

Save the following code to agno_assist.py:

agno_assist.py

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()

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

An Agent served as a FastAPI application with persistent sessions.

Run Your AgentOS

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

uv venv --python 3.12
.venv\Scripts\activate

Install dependencies

uv pip install -U 'agno[os]' anthropic

Export your Anthropic API key

export ANTHROPIC_API_KEY=sk-***

setx ANTHROPIC_API_KEY sk-***

Run your AgentOS

python agno_assist.py

Your AgentOS is now running at http://localhost:7777.

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

To manage your AgentOS in a UI, head to os.agno.com and connect this runtime. See Connect Your AgentOS for the steps. For the full list of endpoints AgentOS exposes, see the AgentOS API reference.

Introduction Connect Your AgentOS

⌘I

Get Started

AgentOS

Example Usage

Run Your AgentOS

Run Your AgentOS

​Run Your AgentOS

Run Your AgentOS