Run Your AgentOS

Run a local AgentOS in 20 lines of code.

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
from agno.tools.mcp import MCPTools

agno_assist = Agent(
    name="Agno Assist",
    model=Claude(id="claude-sonnet-4-5"),
    db=SqliteDb(db_file="agno.db"),
    tools=[MCPTools(url="https://docs.agno.com/mcp")],
    add_datetime_to_context=True,
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

agent_os = AgentOS(agents=[agno_assist])
app = agent_os.get_app()

In ~20 lines: an Agent with memory, state and MCP, served as a FastAPI application.

Run Your AgentOS

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 mcp
   
3. Export your Anthropic API key

   Mac

   export ANTHROPIC_API_KEY=sk-***
   

   setx ANTHROPIC_API_KEY sk-***
   
4. Run your AgentOS

   fastapi dev agno_agent.py
   

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