This commit is contained in:
Paul Gauthier 2024-09-11 08:18:07 -07:00
parent 0a3b4147fa
commit 007f841328

View file

@ -10,22 +10,39 @@ all of its required dependencies.
If aider reports `ImportErrors`, this probably means it has been installed If aider reports `ImportErrors`, this probably means it has been installed
incorrectly. incorrectly.
## Install with pipx
## Dependency versions If you are having problems with import errors you should consider
[installing aider using pipx](/docs/install/pipx.html).
This will ensure that aider is installed in its own python environment,
with the correct set of dependencies.
Aider pins its dependencies and is tested to work with those specific versions. ## Package managers like Homebrew, AUR, ports
You should be careful about upgrading or downgrading other python libraries that
aider uses.
If you need other versions of packages for your project, Package managers often install aider with the wrong dependencies, leading
consider to import errors and other problems.
It is not recommended to install aider with these tools.
Instead, consider
[installing aider using pipx](/docs/install/pipx.html). [installing aider using pipx](/docs/install/pipx.html).
## Dependency versions matter
Aider pins its dependencies and is tested to work with those specific versions.
If you are installing aider with pip (rather than pipx),
you should be careful about upgrading or downgrading the python packages that
aider uses.
In particular, be careful with the packages with pinned versions
noted at the end of
[aider's requirements.in file](https://github.com/paul-gauthier/aider/blob/main/requirements/requirements.in).
Also be wary of upgrading `litellm`, as it changes versions frequently
and sometimes introduces bugs or backwards incompatible changes.
## Replit ## Replit
You can `pip install aider-chat` on replit, or you can install it via You can `pip install aider-chat` on replit.
pipx.
Or you can install aider with
pipx as follows:
{% include replit-pipx.md %} {% include replit-pipx.md %}