Run AgentOS Locally

Run a local AgentOS with one agent and persistent session history. Save the following code as 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)

This creates a FastAPI application with one agent and SQLite-backed session storage.

Requires uv.

Start the Server

Create a virtual environment

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

uv venv --python 3.12
.venv\Scripts\Activate.ps1

Install dependencies

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

Set your Anthropic API key

export ANTHROPIC_API_KEY="sk-***"

$env:ANTHROPIC_API_KEY="sk-***"

Start AgentOS

python agno_assist.py

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

Endpoint	Description
`http://localhost:7777`	AgentOS API information
`http://localhost:7777/health`	Runtime health check
`http://localhost:7777/docs`	Interactive API documentation
`http://localhost:7777/config`	Runtime configuration and registered capabilities

Run the Agent

curl -X POST http://localhost:7777/agents/agno-assist/runs \
  -F 'message=What can you help me with?' \
  -F 'stream=false'

curl.exe -X POST http://localhost:7777/agents/agno-assist/runs `
  -F "message=What can you help me with?" `
  -F "stream=false"

AgentOS creates a session, runs the agent, and stores the session in agno.db.

Next Steps

Task	Guide
Manage the runtime in a web interface	Connect Your AgentOS
Call agents from your application	Using the AgentOS API
Browse every endpoint	AgentOS API reference

Get Started

AgentOS

Example Usage

Run AgentOS Locally

Start the Server

Run the Agent

Next Steps

​Start the Server

​Run the Agent

​Next Steps

Start the Server

Run the Agent

Next Steps