To make this codebase yours, run rm -rf .git and push to your own git repo.
2
Configure your environment
cp example.env .env
Open .env and set OPENAI_API_KEY. Everything else has sensible defaults.
3
Start the platform
docker compose up -d --build
This runs two containers: a FastAPI app on port 8000 and a Postgres database on port 5432. The first build takes a few minutes.
4
Verify it's running
Open http://localhost:8000/docs.You’ll see the OpenAPI spec: every agent action exposed as a REST endpoint.
AgentOS API
5
Verify end to end
./scripts/mcp_check.sh
This script prints MCP OK and a real agent answer through the MCP endpoint.
You now have an agent platform made of AgentOS on FastAPI and Postgres. The AgentOS server exposes 80+ endpoints for runs, sessions, memory, knowledge, and evals.AgentOS also comes with a UI at os.agno.com.
Click Connect OS, enter http://localhost:8000 as the URL, and name it Local AgentOS.
Click Connect.
You should see three agents:
Agent
Pattern
What it does
Agent Builder
Studio builder
Builds agents, teams, and workflows from a chat prompt.
Platform Manager
Context provider
Monitors the platform and answers questions about the codebase.
WebSearch
Direct tools
Searches the web and synthesizes answers grounded in citations.
Try a prompt against each:
“Build an agent that tracks AI news and writes a daily brief” → Agent Builder walks you through the agent development process.
“How healthy is the platform?” → Platform Manager answers from eval history, deployment checks, and schedules.
“What did Anthropic publish about agents recently?” → WebSearch returns a summary with citations.
Open Sessions and Traces in the sidebar. Every run is captured with full message history, tool calls, and timing. This is what powers the iteration loop on the next page.
