> ## 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.

# Manual Installation

> Step-by-step guide to manually install AgentSystems

## Prerequisites

### 1. Python 3.11 or Higher

AgentSystems requires Python 3.11+. Check your version:

```bash theme={null}
python3 --version
```

If you need to upgrade, see the [Python downloads page](https://www.python.org/downloads/).

### 2. Docker

Docker is required to run AgentSystems containers.

* **macOS**: Install [Docker Desktop](https://www.docker.com/products/docker-desktop/)
* **Linux**: Follow the [official Docker Engine installation guide](https://docs.docker.com/engine/install/)

Verify Docker is running:

```bash theme={null}
docker ps
```

## Installation Steps

### 1. Install pipx

Install [pipx](https://pipx.pypa.io/stable/installation/) using your system's package manager or pip:

```bash theme={null}
python3 -m pip install --user pipx
python3 -m pipx ensurepath
```

Restart your terminal, then verify:

```bash theme={null}
pipx --version
```

### 2. Install agentsystems-sdk

```bash theme={null}
pipx install agentsystems-sdk
agentsystems --version
```

## Initialize and Start

```bash theme={null}
agentsystems init agent-platform
cd agent-platform
agentsystems up
```

Open your browser to `http://localhost:3001`