> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Locally

> Run AgentOS and Postgres locally with Docker.

Today we're going to run an agent platform made of:

* AgentOS on FastAPI
* Postgres + pgvector

## Prerequisites

* [Docker Desktop](https://docs.docker.com/desktop/) installed and running
* An [OpenAI API key](https://platform.openai.com/api-keys) for models and embeddings

## Run your agent platform

<Steps>
  <Step title="Clone the template">
    ```bash theme={null}
    git clone https://github.com/agno-agi/agentos-railway.git agent-platform
    cd agent-platform
    ```

    <Tip>
      To make this codebase yours, run `rm -rf .git` and push to your own git repo.
    </Tip>
  </Step>

  <Step title="Configure your environment">
    ```bash theme={null}
    cp example.env .env
    ```

    Open `.env` and set `OPENAI_API_KEY`. Everything else has sensible defaults.
  </Step>

  <Step title="Start the platform">
    ```bash theme={null}
    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.
  </Step>

  <Step title="Verify it's running">
    Open [http://localhost:8000/docs](http://localhost:8000/docs).

    You'll see the OpenAPI spec: every agent action exposed as a REST endpoint.

    <Frame caption="AgentOS API">
      <img src="https://mintcdn.com/agno-v2-codex-docs-audit-20260719-0149/pW8PmtN5WDvNK9a4/videos/first-agent-api.gif?s=4902072fc62c0a38df1147aaeff151e0" alt="AgentOS API" width="800" height="524" data-path="videos/first-agent-api.gif" />
    </Frame>
  </Step>
</Steps>

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](https://os.agno.com).

## Connect the AgentOS UI

1. Open [os.agno.com](https://os.agno.com) and sign in.
2. Click **Connect OS**, enter `http://localhost:8000` as the URL, and name it **Local AgentOS**.
3. 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.

## Summary

We now have a locally running agent platform with:

* Our agent runtime (AgentOS) running on port 8000 with request isolation, session management, scheduling, and 80+ endpoints.
* A Postgres database for storing sessions, memory, knowledge, and traces.
* Six coding-agent skills in `.agents/skills/` covering the agent development lifecycle: setup, create, improve, extend, eval, and review.

<Tip>
  Hot-reload is on. Edits to Python files in the source (`agents/`, `app/`, `db/`, `evals/`, `workflows/`) are live in \~2s.
</Tip>

## Next

[Create an agent →](/agent-platform/create-agent)