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

# Installation

> System requirements and install options for mage-agent.

## Requirements

* Python **3.10** or newer
* A Mage Pro cluster (URL + account credentials)

## Download from Mage Pro

In Mage Pro, open **Settings** > **Platform** > **Mage Agent** to download the latest Mage Agent installer for Codex or Claude Code.

The page lists the latest GitHub release assets for macOS and Windows, including file sizes and checksums. Download links use GitHub's stable latest-release asset URLs, so Mage Pro does not need source changes when release tags or asset URLs change. Use the download that matches your operating system and AI coding client, then follow the prompts from the installer.

## Install from PyPI

```bash theme={"system"}
pip install mage-agent
```

We recommend installing inside a virtual environment:

```bash theme={"system"}
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install mage-agent
```

Verify:

```bash theme={"system"}
mage-agent --version
```

## Install from source

```bash theme={"system"}
git clone https://github.com/mage-ai/mage-agent.git
cd mage-agent
python -m venv .venv
source .venv/bin/activate
pip install -e .
```

## IDE PATH requirement

When you configure your IDE to launch `mage-agent mcp`, the IDE may use a different `PATH` than your terminal. If the MCP server fails to start, use the absolute path to the executable:

```bash theme={"system"}
which mage-agent   # e.g. /Users/you/.venv/bin/mage-agent
```

Then update your IDE config:

```json theme={"system"}
{
  "mcpServers": {
    "mage-agent": {
      "command": "/Users/you/.venv/bin/mage-agent",
      "args": ["mcp"]
    }
  }
}
```