Overview

Engineering teams building agents need a shared runtime for runs, sessions, memory, knowledge, authentication, traces, and evals. Building that foundation once gives every agent the same API, state, security, and operating model. AgentOS runs that foundation as a FastAPI application in your cloud. Every registered agent, team, and workflow gets a REST API, an MCP interface, and a place in the AgentOS UI. Postgres stores runtime state. The Railway starter used in this guide also includes six coding-agent skills for setup, creation, extension, improvement, evaluation, and maintenance.

Build with a coding agent

Pick a cloud, then give the setup prompt to your favorite coding agent. The prompt starts the platform and uses the skills in .agents/skills to build the first agent.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-railway into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Railway.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-docker into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on self-hosted Docker.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-aws into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on AWS.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-fly into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Fly.io.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-gcp into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Google Cloud Run.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-helm into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Kubernetes.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-azure into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Azure Container Apps.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-render into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Render.

Help me set up my agent platform and build my first agent.

Clone https://github.com/agno-agi/agentos-modal into a folder called agent-platform, cd in, and run the setup-platform skill (in .agents/skills/).

See AgentOS on Modal.

Build it step by step

We learn by building, so the rest of this guide walks through each part of the platform using the AgentOS on Railway template. The development loop is shared across Agno’s deployment templates. When it is time to deploy, follow the guide for your cloud provider.

Step	What happens
Run Locally	Start AgentOS and Postgres with Docker.
Create an Agent	Use a coding-agent skill to add and verify an agent.
Improve an Agent	Probe live behavior and make focused changes.
Evals	Turn expected behavior into regression cases.
Run on Railway	Deploy with JWT authorization enabled.
Next Steps	Add teams, workflows, schedules, and interfaces.

Welcome

Get Started

Features

Use Cases

Build with a coding agent

Build it step by step

​Build with a coding agent

​Build it step by step

Build with a coding agent

Build it step by step