1.9 KiB
parent, nav_order
| parent | nav_order |
|---|---|
| Troubleshooting | 28 |
Dependency versions
Dev expects to be installed with the correct versions of all of its required dependencies.
If you've been linked to this doc from a GitHub issue,
or if dev is reporting ImportErrors
it is likely that your
dev install is using incorrect dependencies.
Avoid package conflicts
If you are using dev to work on a python project, sometimes your project will require specific versions of python packages which conflict with the versions that dev requires. If this happens, you may see errors like these when running pip installs:
dev-chat 0.23.0 requires somepackage==X.Y.Z, but you have somepackage U.W.V which is incompatible.
Install with dev-install, uv or pipx
If you are having dependency problems you should consider installing dev using dev-install, uv or pipx. This will ensure that dev is installed in its own python environment, with the correct set of dependencies.
Package managers like Homebrew, AUR, ports
Package managers often install dev with the wrong dependencies, leading to import errors and other problems.
It is recommended to install dev using dev-install, uv or pipx.
Dependency versions matter
Dev pins its dependencies and is tested to work with those specific versions. If you are installing dev directly with pip you should be careful about upgrading or downgrading the python packages that dev uses.
In particular, be careful with the packages with pinned versions noted at the end of dev's requirements.in file. These versions are pinned because dev 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
{% include replit-pipx.md %}