> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentsystems.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Deploy AgentSystems in 5 minutes

## System Requirements

AgentSystems requires:

* **Python 3.11 or higher**
* **Docker** (Docker Desktop on macOS, Docker Engine on Linux)
* **Operating System**: macOS or Ubuntu Linux

<Steps>
  <Step title="Install AgentSystems">
    Run the installation script:

    ```bash theme={null}
    curl -fsSL https://github.com/agentsystems/agentsystems/releases/latest/download/install.sh | sh
    ```
  </Step>

  <Step title="Initialize Deployment">
    Create and enter your deployment directory:

    ```bash theme={null}
    agentsystems init my-deployment
    cd my-deployment
    ```

    The init command prompts for:

    * Langfuse credentials for observability
    * Admin credentials for the UI
  </Step>

  <Step title="Start the Platform">
    Launch all platform services:

    ```bash theme={null}
    agentsystems up
    ```

    This starts:

    * Agent Control Plane (Gateway)
    * AgentSystems UI at [http://localhost:3001](http://localhost:3001)
    * PostgreSQL database
  </Step>

  <Step title="Pull a Local Model">
    Download a small model for local testing:

    ```bash theme={null}
    docker exec agentsystems-ollama-1 ollama pull gemma3:1b
    ```

    This downloads a local AI model without needing API keys.
  </Step>

  <Step title="Open the UI">
    Open [http://localhost:3001](http://localhost:3001) in your browser to execute your first local agent.
  </Step>
</Steps>

## Stop the Platform

When you're done:

```bash theme={null}
agentsystems down
```