Do I need to install pip?¶
pip is already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4 downloaded from python.org or if you are working in a Virtual Environment created by virtualenv or venv. Just make sure to upgrade pip.
Use the following command to check whether pip is installed:
$ python -m pip --version pip X.Y.Z from .../site-packages/pip (python X.Y)
C:\> py -m pip --version pip X.Y.Z from ...\site-packages\pip (python X.Y)
Using Linux Package Managers¶
If you installed Python from a package manager on Linux, you should always install pip for that Python installation using the same source.
See pypug:Installing pip/setuptools/wheel with Linux Package Managers in the Python Packaging User Guide.
Here are ways to contact a few Linux package maintainers if you run into problems:
pip developers do not have control over how Linux distributions handle pip installations, and are unable to provide solutions to related issues in general.
See the Using Linux Package Managers section if your Python reports
No module named ensurepip on Debian and derived systems (e.g. Ubuntu).
Installing with get-pip.py¶
Be cautious if you are using a Python install that is managed by your operating
system or another package manager.
get-pip.py does not coordinate with
those tools, and may leave your system in an inconsistent state.
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
Then run the following command in the folder where you
get-pip.py also installs setuptools 2 and wheel
if they are not already. setuptools is required to install
source distributions. Both are
required in order to build a Wheel Cache (which improves installation
speed), although neither are required to install pre-built wheels.
The get-pip.py script is supported on the same python version as pip. For the now unsupported Python 2.6, alternate script is available here.
Install from local copies of pip and setuptools:
python get-pip.py --no-index --find-links=/local/copies
py get-pip.py --no-index --find-links=/local/copies
Install to the user site 3:
python get-pip.py --user
py get-pip.py --user
Install behind a proxy:
python get-pip.py --proxy="http://[user:passwd@]proxy.server:port"
py get-pip.py --proxy="http://[user:passwd@]proxy.server:port"
get-pip.py can also be used to install a specified combination of
wheel using the same requirements syntax as pip:
python get-pip.py pip==9.0.2 wheel==0.30.0 setuptools==28.8.0
py get-pip.py pip==9.0.2 wheel==0.30.0 setuptools==28.8.0
python -m pip install -U pip
py -m pip install -U pip
Python and OS Compatibility¶
pip works with CPython versions 2.7, 3.5, 3.6, 3.7, 3.8 and also PyPy.
This means pip works on the latest patch version of each of these minor versions. Previous patch versions are supported on a best effort approach.
pip works on Unix/Linux, macOS, and Windows.
“Secure” in this context means using a modern browser or a tool like
curlthat verifies SSL certificates when downloading from https URLs.
Beginning with pip v1.5.1,
get-pip.pystopped requiring setuptools to be installed first.
The pip developers are considering making
--userthe default for all installs, including
get-pip.pyinstalls of pip, but at this time,
--userinstalls for pip itself, should not be considered to be fully tested or endorsed. For discussion, see Issue 1668.
Did this article help?
We are currently doing research to improve pip’s documentation and would love your feedback. Please email us and let us know:
What problem were you trying to solve when you came to this page?
What content was useful?
What content was not useful?