# Installation

## Get started quickly with aider-install

If you already have python 3.8-3.13 installed, you can get started quickly like this.

First, install aider:

```
python -m pip install aider-install
aider-install
```

Start working with aider on your codebase:

```
# Change directory into your codebase
cd /to/your/project

# DeepSeek
aider --model deepseek --api-key deepseek=<key>

# Claude 3.7 Sonnet
aider --model sonnet --api-key anthropic=<key>

# o3-mini
aider --model o3-mini --api-key openai=<key>
```

This will install aider in its own separate python environment.
If needed,
aider-install will also install a separate version of python 3.12 to use with aider.

Once aider is installed,
there are also some [optional install steps](/content/docs/install/optional.html).

See the [usage instructions](/content/docs/usage.html) to start coding with aider.

## One-liners

These one-liners will install aide, along with python 3.12 if needed.
They are based on the
[uv installers](https://docs.astral.sh/uv/getting-started/installation/).

#### Mac & Linux

Use curl to download the script and execute it with sh:

```
curl -LsSf https://aider.chat/install.sh | sh
```

If your system doesn’t have curl, you can use wget:

```
wget -qO- https://aider.chat/install.sh | sh
```

#### Windows

```
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
```

## Install with uv

You can install aider with uv:

```
python -m pip install uv  # If you need to install uv
uv tool install --force --python python3.12 --with pip aider-chat@latest
```

This will install uv using your existing python version 3.8-3.13,
and use it to install aider.
If needed,
uv will automatically install a separate python 3.12 to use with aider.

Also see the
[docs on other methods for installing uv itself](https://docs.astral.sh/uv/getting-started/installation/).

## Install with pipx

You can install aider with pipx:

```
python -m pip install pipx  # If you need to install pipx
pipx install aider-chat
```

You can use pipx to install aider with python versions 3.9-3.12.

Also see the
[docs on other methods for installing pipx itself](https://pipx.pypa.io/stable/installation/).

## Other install methods

You can install aider with the methods described below, but one of the above
methods is usually safer.

#### Install with pip

If you install with pip, you should consider
using a
[virtual environment](https://docs.python.org/3/library/venv.html)
to keep aider’s dependencies separated.

You can use pip to install aider with python versions 3.9-3.12.

```
python -m pip install -U --upgrade-strategy only-if-needed aider-chat
```

In some environments you may get “aider command not found” errors.
You can try `python -m aider` or
[see here for more info](/content/docs/troubleshooting/aider-not-found.html).

#### Installing with package managers

It’s best to install aider using one of methods
recommended above.
While aider is available in a number of system package managers,
they often install aider with incorrect dependencies.

## Next steps…

There are some [optional install steps](/content/docs/install/optional.html) you could consider.
See the [usage instructions](/content/docs/usage.html) to start coding with aider.

* * *

## Table of contents

- [Optional steps](/content/docs/install/optional.html)
- [Aider with docker](/content/docs/install/docker.html)
- [GitHub Codespaces](/content/docs/install/codespaces.html)
- [Replit](/content/docs/install/replit.html)