ERROR
pip
resolution_error
ai_generated
true
ERROR: No matching distribution found for package
ID: pip/no-matching-distribution
88%Fix Rate
90%Confidence
310Evidence
2023-01-01First Seen
Version Compatibility
| Version | Status | Introduced | Deprecated | Notes |
|---|---|---|---|---|
| 24 | active | — | — | — |
Root Cause
No wheel or sdist matches your Python version, OS, or architecture. Common with native extensions.
genericWorkarounds
-
92% success Check if the package supports your Python version and platform
python --version # check your Python version pip debug --verbose # shows compatible tags # Visit https://pypi.org/project/PACKAGE/#files to see available wheels
Sources: https://pypi.org/
-
88% success Use a different Python version that the package supports
pyenv install 3.11.8 pyenv local 3.11.8 python -m venv .venv && source .venv/bin/activate pip install package-name
-
85% success Specify --platform and --python-version flags if building for a different target
pip download --platform manylinux2014_x86_64 \ --python-version 3.11 \ --only-binary=:all: \ package-name
Dead Ends
Common approaches that don't work:
-
Force install with --no-binary :all:
65% fail
If no source distribution exists either, build will fail with missing C headers
-
Upgrade pip to latest version
60% fail
Rarely the issue — usually a platform or Python version mismatch
Error Chain
Preceded by:
Frequently confused with: