mirror of
https://github.com/Aider-AI/aider.git
synced 2025-06-03 19:24:59 +00:00
118 lines
2.9 KiB
Markdown
118 lines
2.9 KiB
Markdown
---
|
|
title: Installation
|
|
has_children: true
|
|
nav_order: 20
|
|
description: How to install and get started pair programming with aider.
|
|
---
|
|
|
|
# Installation
|
|
{: .no_toc }
|
|
|
|
|
|
## Get started quickly with aider-install
|
|
|
|
{% include get-started.md %}
|
|
|
|
If needed,
|
|
aider-install will automatically install a separate version of python3.12 to use with aider.
|
|
|
|
There are some [optional install steps](/docs/install/optional.html) you could consider.
|
|
See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider.
|
|
|
|
## One-liners
|
|
|
|
These one-liners will install aider, along with python3.12 if needed.
|
|
They are based on the
|
|
[uv installers](https://docs.astral.sh/uv/getting-started/installation/).
|
|
|
|
#### Windows
|
|
|
|
```powershell
|
|
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
|
|
```
|
|
|
|
#### Mac and Linux
|
|
|
|
Use curl to download the script and execute it with sh:
|
|
|
|
```bash
|
|
curl -LsSf https://aider.chat/install.sh | sh
|
|
```
|
|
|
|
If your system doesn't have curl, you can use wget:
|
|
|
|
```bash
|
|
wget -qO- https://aider.chat/install.sh | sh
|
|
```
|
|
|
|
|
|
## Install with uv
|
|
|
|
A recommended way to install aider is with uv:
|
|
|
|
```bash
|
|
python -m pip install uv # If you need to install uv
|
|
uv tool install --force --python python3.12 aider-chat@latest
|
|
```
|
|
|
|
You can use uv to install aider with your existing python versions 3.8-3.13.
|
|
If needed,
|
|
uv will automatically install a separate version of python3.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
|
|
|
|
A recommended way to install aider is with pipx:
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
# Install aider
|
|
python -m pip install -U --upgrade-strategy only-if-needed aider-chat
|
|
|
|
# To work with GPT-4o:
|
|
aider --4o --openai-api-key sk-xxx...
|
|
|
|
# To work with Claude 3.5 Sonnet:
|
|
aider --sonnet --anthropic-api-key sk-xxx...
|
|
```
|
|
|
|
{% include python-m-aider.md %}
|
|
|
|
#### 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](/docs/install/optional.html) you could consider.
|
|
See the [usage instructions](https://aider.chat/docs/usage.html) to start coding with aider.
|
|
|