Note this error originates from a subprocess and is likely not a problem with pip

Description

Starting with pip 22.1, including «pip» in the pyproject.toml [build-system] requires fails.

Example pyproject.toml:

[build-system]
requires = [
    "setuptools>=40.8.0", 
    "wheel",
    "pip"
]
build-backend = "setuptools.build_meta"

Error:

(venv) D:DevmyPyPackage>python -m pip install D:DevmyPyPackage
Looking in indexes: https://pypi.org/simple
Processing d:devmypypackage
  Installing build dependencies ... error
  error: subprocess-exited-with-error

  × pip subprocess to install build dependencies did not run successfully.
  │ exit code: 1
  ╰─> [9 lines of output]
      Looking in indexes: https://pypi.org/simple
      Collecting setuptools>=40.8.0
        Using cached setuptools-62.2.0-py3-none-any.whl (1.1 MB)
      Collecting wheel
        Using cached wheel-0.37.1-py2.py3-none-any.whl (35 kB)
      Collecting pip
        Using cached pip-22.1-py3-none-any.whl (2.1 MB)
      ERROR: To modify pip, please run the following command:
      D:DevmyPyPackagevenvScriptspython.exe -m pip install --ignore-installed --no-user --prefix C:UserscowlinatorAppDataLocalTemppip-build-env-upw4u049overlay --no-warn-script-location --no-binary :none: --only-binary :none: -i https://pypi.org/simple --trusted-host pypi.org -- setuptools>=40.8.0 wheel pip
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

Verified that this succeeds with pip 22.0.4

This error message repeatedly states that this is likely not a problem with pip… but it is the change from pip 22.0.4 to 22.1 that breaks it.

Expected behavior

I expect pip 22.1 to behave the same as pip 22.0.4; namely, that the installation succeeds.

Output when using pip 22.0.4:

(venv) D:DevmyPyPackage>python -m pip install D:DevmyPyPackage
Looking in indexes: https://pypi.org/simple
Processing d:devmypypackage
  Installing build dependencies ... done
  Getting requirements to build wheel ... done
  Preparing metadata (pyproject.toml) ... done
Building wheels for collected packages: hi
  Building wheel for hi (pyproject.toml) ... done
  Created wheel for hi: filename=hi-0.0.0-py3-none-any.whl size=1048 sha256=b5e4d2b574164c3e8c93ea425bd63f58876eb58087dedd259755a9326ddc84fd
  Stored in directory: C:UserscowlinatorAppDataLocalTemppip-ephem-wheel-cache-u03_8ou9wheels6a647bc6556dc063c160509a71a3f427d795bea205706ceccf1319ff
Successfully built hi
Installing collected packages: hi
Successfully installed hi-0.0.0
WARNING: You are using pip version 22.0.4; however, version 22.1 is available.
You should consider upgrading via the 'D:DevmyPyPackagevenvScriptspython.exe -m pip install --upgrade pip' command.

pip version

22.1

Python version

3.7.9

OS

Windows 11 (21H2)

How to Reproduce

1. Create a virtual environment and activate it
2. Install pip 22.1
3. Create a python package with a pyproject.toml containing:

[build-system]
requires = [
    "setuptools>=40.8.0", 
    "wheel",
    "pip"
]
build-backend = "setuptools.build_meta"

1. Install this python package from the local directory with python -m pip install <dir>
2. Observe the error

Output

D:DevmyPyPackage>python -m venv venv && venvScriptsactivate

(venv) D:DevmyPyPackage>python -m pip install --upgrade pip
Looking in indexes: https://pypi.org/simple
Collecting pip
  Using cached pip-22.1-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 20.1.1
    Uninstalling pip-20.1.1:
      Successfully uninstalled pip-20.1.1
Successfully installed pip-22.1

(venv) D:DevmyPyPackage>python -m pip install D:DevmyPyPackage
Looking in indexes: https://pypi.org/simple
Processing d:devmypypackage
  Installing build dependencies ... error
  error: subprocess-exited-with-error

  × pip subprocess to install build dependencies did not run successfully.
  │ exit code: 1
  ╰─> [9 lines of output]
      Looking in indexes: https://pypi.org/simple
      Collecting setuptools>=40.8.0
        Using cached setuptools-62.2.0-py3-none-any.whl (1.1 MB)
      Collecting wheel
        Using cached wheel-0.37.1-py2.py3-none-any.whl (35 kB)
      Collecting pip
        Using cached pip-22.1-py3-none-any.whl (2.1 MB)
      ERROR: To modify pip, please run the following command:
      D:DevmyPyPackagevenvScriptspython.exe -m pip install --ignore-installed --no-user --prefix C:UserscowlinatorAppDataLocalTemppip-build-env-upw4u049overlay --no-warn-script-location --no-binary :none: --only-binary :none: -i https://pypi.org/simple --trusted-host pypi.org -- setuptools>=40.8.0 wheel pip
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

Code of Conduct

• I agree to follow the PSF Code of Conduct.

Python provides you with a package installer called ‘pip.’ ‘Pip’ allows you to write a line of code to install packages and manage them. Although sometimes, when you are installing some packages, you might get an ‘error: legacy-install-failure.’ For example, if you are trying to install the gensim package in python. To know more about ‘pip’ check out this post.

Output:

note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> gensim

In this article, we will discuss how we can solve this error.

Pip is a package installer and manager, and the wheel is a way that pip prefers to install packages because the wheel allows fast and efficient installations and are smaller in comparison to eggs. Hence upgrading wheels might also solve the problem of ‘error: legacy-install-failure.’ The setuptools enhance the over-installation by enhancing the python standard library distribution utilities. Therefore if you update these modules, it might solve your error because this error can also arise if one of these modules is not up-to-date. Let us see how we can upgrade these modules.

• First, update your pip installer as shown below.

python - m pip install – upgrade pip

• Then upgrade your wheel by using:

pip install - upgrade wheel

• Then finally upgrade the setuptools.

pip install - upgrade setuptools

• And then again try to install the package which was throwing error in the first place.

Solve error: legacy-install-failure In Pandas

Pandas is an open-source library in python which allows users to perform high-level data manipulation. It is one of the most important libraries in python in the sense of data structure programming and data analysis because it provides flexible, fast and expressive data structures. However, sometimes when you try to install this library using pip, you can get an ‘error: legacy-install-failure,’ which can prevent us from using this very important library. Let us see how we can solve this error in python.

To solve this problem, you need to install ‘pipwin’ because it may happen that the ‘pandas’ wheel might not support the python version you are working on; therefore, first, install ‘pipwin’.

And further, when you install ‘pipwin,’ install ‘pandas’ using ‘pipwin.’

This should probably solve the ‘error: legacy-install-failure’ and allow you to install the pandas library and use it.

Solve error: legacy-install-failure For Basemap

Basemap is a tool in python that provides you to create maps in a very easy and simple way. It is an extension of the ‘matplotlib‘ library; therefore, it contains all the features for carrying out data visualization. It further adds geographical projections and some other additional data sets in order to enable plotting coastlines, countries, states, boundaries and etc., directly from the library. Similarly, when you try to install this library through ‘pip,’ you might face a Solve ‘ error: legacy-install-failure’. We will discuss how we can solve this error for the basemap library.

Solving For Windows Operating System

If you are using Windows operating system and encounter this error you need to follow some steps. The steps are as given below:

• First, go this path https://www.lfd.uci.edu/~gohlke/pythonlibs/#basemap
• You will be directed to the file directory. If you’re using python 3.10.x, download the file named ‘basemap‑1.3.2‑cp310‑cp310‑win_amd64.whl‘
• Now go to this wheel file and run the following command:

pip install basemap‑1.3.2‑cp310‑cp310‑win_amd64.whl

Doing this should solve the ‘error: legacy-install-failure’ error.

Solving For MAC Operating System

If you are using MAC Operating System and encounter this error, you need to follow some steps. The steps are as given below:

• First, make sure you install all the packages as shown below:

brew install geos
brew install matplotlib
brew install numpy
brew install proj

• Then you have to add GEOS_DIR = “/ user / local / Cellar / geos / 3.10.2 /” to your .bash profile and reload it via: source ~/.bash_profile. You can do that by :

git clone --depth 1 https://github.com/matplotlib/basemap.git

• Further, go to the basemap directory from the path: basemap/packages/ basemap. And finally, run the install code from that directory.

This should solve the ‘error: legacy-install-failure’ error.

Solving For Google Colab

To solve this error in google colab, you need to run the commands given below, and doing that should solve the ‘error: legacy-install-failure’ error.

!sudo apt-get install libgeos-3.6.2
!sudo apt-get install libgeos-dev
!pip install git+https://github.com/matplotlib/basemap#subdirectory=packages/basemap

Solve error: legacy-install-failure For MySQL

MySQL provides services for handling and managing databases. When you connect your python application to an active server, you can manage all your database using MySQL. Although when installing using an ‘Error: legacy-install-failure’ error might occur. It can display something like this.

  note: This error originates from a subprocess, and is likely not a problem with 
pip.
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> mysqlclient

note: This is an issue with the package mentioned above, not pip.
hint: See above for output from the failure.

To solve this following error, you will need to follow the steps given below:

• First, run the commands given below

xcode-select --install
brew install zstd
pip install pymysql
pip install wheel 
CFLAGS="-I$(brew --prefix)/include" LDFLAGS="-L$(brew --prefix)/lib" pip install mysqlclient==<version>

• Further, make some changes in the settings file if you are using some framework like Django or any other. To make this change run these commands.

import pymysql
pymysql.install_as_MySQLdb()

Further, install all other dependencies in the env/lib/python3.8/site-packages/django/db/backends/mysql/base.py directory. These dependencies can be installed like:

pip install mysql-connector-python
pip install cryptography

• Now try to install MySQL again, as following these steps should solve the error.

Solve error: legacy-install-failure For Wxpython

Wxpython is a cross-platform Graphical User Interface toolkit for python language. It enables the users to program independent and robust code, which provides a very high graphical user interface very easily and quite simply. This library, like many other libraries, is open source. Although sometimes, while installing ‘wxPython,’ you might face an ‘error: legacy-install-failure’ error.

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> wxPython

note: This is an issue with the package mentioned above, not pip.
hint: See above for output from the failure.

This error might occur because you might be using a python version that is not compatible with ‘wxPython.’ Therefore the easiest solution is to downgrade your python version to 3.9.13 because the last version of ‘wxPython’ came before python 3.10. There might be an alternative solution to this, but right now, this is the easiest solution.

Solve error: legacy-install-failure For Psycopg2-binary

To solve this error, you have to follow some steps. You can solve this problem by upgrading some packages.

pip uninstall psycopg2
pip list --outdated
pip install --upgrade wheel
pip install --upgrade setuptools
pip install psycopg2

This code will upgrade some outdated packages and might solve the problem.

Solve Error legacy-install-failure For Cffi

When you are programming on Django, you might get an error while installing libraries. You can solve this error by the following code.

RUN python -m venv /py && 
   /py/bin/pip install --upgrade pip && 
   apk add --update alpine-sdk && 
   apk add --update --no-cache postgresql-client && 
   apk add --update --no-cache --virtual .tmp-build-deps 
      build-base gcc python3-dev postgresql-dev musl-dev libffi-dev openssl-dev cargo  && 
   /py/bin/pip install -r /tmp/requirements.txt && 
   if [ $DEV = "true" ]; 
      then /py/bin/pip install -r /tmp/requirements.dev.txt ; 
   fi && 
   rm -rf /tmp && 
   apk del .tmp-build-deps && 
   adduser 
      --disabled-password 
      --no-create-home 
      django-user

Solve error: legacy-install-failure For Dlib

You can also get an error while installing the ‘dlib’ library through pip. To solve this error, try to install the library from scratch by following the steps.

• First, install ‘anaconda.’
• Further activate the virtual environment through a command prompt.
• Install ‘opencv’ using pip.
• Install ‘dlib’ using pip.

This will eventually solve your error.

Solve Error legacy-install-failure For Fbprophet

You can encounter an error while installing Facebook prophet using pip. This error occurs because you might not have installed dependencies for the wheel to be installed. You can solve this error by installing all the dependencies and then installing the ‘fbprophet’ using pip.

Solve error: legacy-install-failure For Horovod

When you are trying to install ‘horvord’ with ‘PyTorch,’ you might encounter an error of sort ‘error: legacy-install-failure’.

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

× Encountered error while trying to install package.
╰─> horovod

note: This is an issue with the package mentioned above, not pip.
hint: See above for output from the failure. 

This error occurs because an older version of ‘horovord’ than 0.24.0 is not compatible with PyTorch. Therefore you can solve this error by upgrading ‘horovord’ to newer versions.

FAQs on Error: legacy-install-failure

Conclusion

Finally conclude, we can say that we have discussed various methods in this article to solve the ‘error: legacy-install-failure’ error which occurs for different libraries and modules. You can use any of the methods according to your requirements and according to the library or modules, you want to install for your program.

Subprocess exited with error pip

The —use-deprecated option allows us to use the old resolver behavior when installing modules.

If the suggestions didn’t help, read toward the end of your error message.

It might contain information such as: «RuntimeError: Cannot install on Python version 3.11.0; only versions >=3.7, pip install the package from the error message before installing the other package.

When I am trying to install gensim python package via pip install gensim. Then I am facing note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure, this error.

In this article, we will discuss about this error: legacy-install-failure error in Python. And how to resolve the error all the possible solutions with examples.

How to error: legacy-install-failure Error Occurs?

I am just installed gensim python package via pip install gensim, then I am getting error looks like the below:

note: This error originates from a subprocess, and is likely not a problem with pip.
error: legacy-install-failure

How To Fix error: legacy-install-failure?

There are different ways to fix error: legacy-install-failure this error. Let us take a look at every solution.

• How To Fix error: legacy-install-failure?

To Solve error: legacy-install-failure If you are windows 110 OR 11(x64) and python 3.10 Then you should take this file: gensim‑4.1.2‑cp310‑cp310‑win_amd64.whl. I hope your error is now solved.

• error: legacy-install-failure

To Solve error: legacy-install-failure, you have to upgrade wheel with this Command Commandline pip install –upgrade wheel Now, Try to Upgrade your setuptools with this commandline pip install –upgrade setuptools Now, Try to install gensim again with this command: pip install gensim OR pip3 install gensim. I hope now your error will be solved.

Solution 1: Upgrade pip, wheel and setuptools

1. First you have to Upgrade your pip with this command line python -m pip install –upgrade pip
2. Then, Upgrade your wheel with this Commandline pip install –upgrade wheel
3. Now, Try to Upgrade your setuptools with this commandline pip install –upgrade setuptools
4. Now, Try to install gensim again with this command: pip install gensim OR pip3 install gensim.

Now, your error will be solved.

Solution 3: Download Microsoft c++ build tools

Try To Download Microsoft c++ build tools. And then Install It in Your system. Now, Make Sure to Check the Desktop development with C++ and install it.

You can also achieve the same automatically using the following command.

vs_buildtools.exe --norestart --passive --downloadThenInstall --includeRecommended --add Microsoft.VisualStudio.Workload.NativeDesktop --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools

as installation is complete you can install gensim again with this command: pip install gensim OR pip3 install gensim. Now, your error must be solved.

Conclusion

In this article, we have discussed what causes the error and we have discussed ways to fix the error.

we hope this article has been informative. Thank you for reading. Kindly comment and let us know if you found it helpful.