When you use pip, Python's package manager, you may occasionally run into the error Could not find a version that satisfies the requirement. This error means that the package you asked for cannot be found, or that it cannot be installed.
This article analyzes what causes the error and offers step-by-step solutions.
Overview
ERROR: Could not find a version that satisfies the requirement (from versions: none)
ERROR: No matching distribution found for This error appears when pip cannot find a suitable version of the package you specified. It typically shows up in situations like these.
- The package does not exist on PyPI (the Python Package Index) — often because of a typo in the name.
- The Python version you are using is not supported by the package.
- A network problem or a misconfiguration.
What causes the error
There are several possible causes. The main ones are listed below.
The package does not exist
If the package you specified does not exist on PyPI, pip naturally cannot install it. This is most often a simple typo in the package name. For example, suppose you run the following command.
pip install nonexistent-packageIn this case, the error is raised.
A Python version mismatch
Some packages depend on a specific Python version. For example, trying to install a package that is not supported on Python 3.6 raises this error. To check your Python version, use the following command.
python --versionpip is out of date
If you are using an old version of pip, it may not recognize newer packages or their versions. To upgrade pip to the latest version, run the following command.
python -m pip install --upgrade pipA network problem
The error can also occur when there is a network connection problem or when access to the PyPI servers is restricted. On corporate or school networks in particular, a firewall or proxy may block access.
How to fix
Now let's look at concrete solutions for each of the causes above.
1. Confirm that the package exists
First, confirm that the package you are trying to install actually exists on PyPI. Open the following URL and search for the package name.
Note that the old pip search command no longer works, because PyPI has disabled its search API. Instead, search on the website above, or list the versions pip can see with the command below.
pip index versions requestsIf no versions are returned, double-check the spelling of the package name.
2. Check and change your Python version
Check whether the Python version you are using is supported by the package. If you are on an old version, consider upgrading Python. You can also read the required Python version on the package's PyPI page (under "Requires: Python").
For installation instructions, see the official site.
3. Upgrade pip
Upgrading pip to the latest version can clear the error. Run the following command to upgrade pip.
python -m pip install --upgrade pip4. Check your proxy settings
If a network problem is the cause, you need to check your proxy settings. When you are behind a proxy, pass it to the pip command as shown below.
pip install <package-name> --proxy http://proxy_address:port5. Check dependencies
When a package depends on other packages and those dependencies are not met, the error can occur. To inspect a package that is already installed, use the following command.
pip show <package-name>This command shows detailed information about the package, including its dependencies.
Troubleshooting
Using requirements.txt
When installing several packages at once, it is common to use a requirements.txt file. List the packages you need in this file and install them with the following command.
pip install -r requirements.txtWhen you do, make sure none of the package names or versions in requirements.txt contain a mistake.
Using a virtual environment
To manage different package versions per project, we recommend using a virtual environment. Create one and activate it with the following commands.
python -m venv myenv
source myenv/bin/activate # Linux/Mac
myenv\Scripts\activate # WindowsBy using pip inside a virtual environment, you can manage packages without affecting your other projects.
Summary
The Could not find a version that satisfies the requirement error can be caused by a variety of issues. You can resolve it by taking the right steps: confirming that the package exists, checking your Python and pip versions, and reviewing your network settings. Working through these steps will make package management with pip much smoother.