Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

This page gets the Agent Platform template running on your machine: a FastAPI service on port 8000, a Postgres for sessions and memory, and two reference agents (code_search, web_search).

Prerequisites

Run locally

1

Clone the template

git clone https://github.com/agno-agi/agentos-railway-template.git agent-platform
cd agent-platform
The remote stays at agentos-railway-template; the local directory is agent-platform because that’s the platform you’re building.
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
Two containers come up: a FastAPI app and a Postgres database. First run pulls the base image and builds the container. Subsequent starts are instant.
4

Verify it's running

curl http://localhost:8000/health
Expect {"status":"ok"}. If you get connection refused, the container is still starting; check docker compose logs -f and wait for the Agno banner.The OpenAPI spec is at http://localhost:8000/docs.

Connect the AgentOS UI

Open os.agno.com and log in. Click Add OS, choose Local, enter http://localhost:8000, click Connect. You should see two agents in the sidebar:
AgentWhat it does
code_searchReads files in the workspace and answers questions about the codebase.
web_searchSearches the web and synthesizes answers grounded in citations.
Try one prompt against each:
“What’s in this repo?”code_search lists the directory and explains the structure.
“What did Anthropic publish about agents recently?”web_search returns a summary with URLs.

What you have now

  • A FastAPI runtime on port 8000 with sessions, scheduling, and 50+ endpoints.
  • A Postgres database holding sessions, memory, and traces.
  • Two reference agents you can replace, extend, or use as patterns.
  • A docs/ folder of Claude Code prompts that build new agents for you.

Next

Create an agent →