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

## 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"]
    }
  }
}
```