2.9 KiB
| title | has_children | nav_order | description |
|---|---|---|---|
| Installation | true | 20 | 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 you could consider. See the usage instructions 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.
Windows
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:
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
Install with uv
A recommended way to install aider is with uv:
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.
Install with pipx
A recommended way to install aider is 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.
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 to keep aider's dependencies separated.
You can use pip to install aider with python versions 3.9-3.12.
# 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 you could consider. See the usage instructions to start coding with aider.