Run Your First AgentOS

Serve an agent through FastAPI with persistent sessions and a local REST API.

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

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

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

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

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

Your agent now has a FastAPI API and persistent sessions.

Run it locally

1. Set up your virtual environment

   Mac

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

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U 'agno[os]' anthropic
   
3. Export your Anthropic API key

   Mac

   export ANTHROPIC_API_KEY=sk-***
   

   $env:ANTHROPIC_API_KEY = "sk-***"
   
4. Run your AgentOS

   python agno_assist.py
   

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

Endpoint	Description
http://localhost:7777/health	Runtime health check
http://localhost:7777/docs	Interactive API documentation
http://localhost:7777/info	Runtime information and registered component counts
http://localhost:7777/config	Registered components and runtime capabilities

Use http://localhost:7777 as the endpoint when connecting this runtime to the Control Plane.

This local quickstart runs without authentication. Configure Security & Auth before deploying it.

Next steps

Task	Guide
Manage and monitor the runtime	Connect Your AgentOS
Call agents through REST	Using the API
Explore every endpoint	AgentOS API reference
Protect the runtime	Security & Auth