pip no matching distribution
ERROR: No matching distribution found for package==1.0.0
Traceback
Traceback (most recent call last):
File "main.py", line 1, in <module>
pip install nonexistent-package==99.99.99
ERROR: No matching distribution found for package==1.0.0What causes this error
No package version matches the specified requirements, Python version, or platform. The package name may be wrong, the version may not exist, or no compatible binary is available.
How to fix it
Check the package exists on PyPI. Verify the version number. Check Python version compatibility. Try without a version pin. For platform issues, build from source with: `pip install package --no-binary :all:`.
Code that causes this error
pip install nonexistent-package==99.99.99
Fixed code
# Check available versions: pip install nonexistent-package== # Install latest compatible: pip install package-name # Or specify a valid version: pip install package-name>=1.0,<2.0
About pip no matching distribution
This error occurs when pip cannot find a package version that matches your requirements and platform. Common causes include requesting a version that does not exist, using a Python version that the package does not support, being on a platform (OS/architecture) without a compatible binary wheel and no source distribution available, typos in the package name, and accessing a private package index without authentication. The error can also appear when the package has been removed from PyPI (rare but possible).
To diagnose, check the package on PyPI (pypi.org) to see available versions and supported platforms. Some packages only provide wheels for specific Python versions and platforms, so upgrading Python or using a different platform may be necessary. For private packages, ensure your pip configuration includes the correct index URL and credentials.
Common scenarios
Installing packages in a different virtual environment than the one in use
Circular imports between modules that depend on each other
Typos in module or package names in import statements
Naming a local file the same as a standard library module