mirror of
https://github.com/Aider-AI/aider.git
synced 2025-06-02 18:54:59 +00:00
51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
---
|
|
parent: Troubleshooting
|
|
nav_order: 28
|
|
---
|
|
|
|
# Import errors
|
|
|
|
Aider expects to be installed via `pip` or `pipx`, which will install
|
|
all of its required dependencies.
|
|
If aider reports `ImportErrors`, this probably means it has been installed
|
|
incorrectly.
|
|
|
|
## Install with pipx
|
|
|
|
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.
|
|
|
|
## Package managers like Homebrew, AUR, ports
|
|
|
|
Package managers often install aider with the wrong dependencies, leading
|
|
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).
|
|
|
|
## 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).
|
|
These versions are pinned because aider is known not to work with the
|
|
latest versions of these libraries.
|
|
|
|
Also be wary of upgrading `litellm`, as it changes versions frequently
|
|
and sometimes introduces bugs or backwards incompatible changes.
|
|
|
|
## Replit
|
|
|
|
You can `pip install aider-chat` on replit.
|
|
|
|
Or you can install aider with
|
|
pipx as follows:
|
|
|
|
{% include replit-pipx.md %}
|