- Docs »
- Installation
- Edit on GitHub
Do I need to install pip?¶
pip is already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4downloaded from python.org or if you are workingin a Virtual Environmentcreated by virtualenv or pyvenv.Just make sure to upgrade pip.
Installing with get-pip.py¶
To install pip, securely download get-pip.py. [1]:
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
Inspect get-pip.py for any malevolence. Then run the following:
python get-pip.py
Warning
Be cautious if you are using a Python install that is managed by your operatingsystem or another package manager. get-pip.py does not coordinate withthose tools, and may leave your system in an inconsistent state.
get-pip.py also installs setuptools [2] and wheelif they are not already. setuptools is required to installsource distributions. Both arerequired in order to build a Wheel Cache (which improves installationspeed), although neither are required to install pre-built wheels.
Note
The get-pip.py script is supported on the same python version as pip.For the now unsupported Python 2.6, alternate script is availablehere.
get-pip.py options¶
--no-setuptools¶If set, do not attempt to install setuptools
--no-wheel¶If set, do not attempt to install wheel
get-pip.py allows pip install options and the general options. Below aresome examples:
Install from local copies of pip and setuptools:
python get-pip.py --no-index --find-links=/local/copies
Install to the user site [3]:
python get-pip.py --user
Install behind a proxy:
python get-pip.py --proxy="http://[user:passwd@]proxy.server:port"
Using Linux Package Managers¶
See Installing pip/setuptools/wheel with Linux Package Managers inthe Python Packaging User Guide.
Upgrading pip¶
On Linux or macOS:
pip install -U pip
On Windows [4]:
python -m pip install -U pip
Python and OS Compatibility¶
pip works with CPython versions 2.7, 3.3, 3.4, 3.5, 3.6 and also pypy.
This means pip works on the latest patch version of each of these minorversions. Previous patch versions are supported on a best effort approach.
pip works on Unix/Linux, macOS, and Windows.
| [1] | “Secure” in this context means using a modern browser or atool like curl that verifies SSL certificates when downloading fromhttps URLs. |
| [2] | Beginning with pip v1.5.1, get-pip.py stopped requiring setuptools tobe installed first. |
| [3] | The pip developers are considering making --user the default for allinstalls, including get-pip.py installs of pip, but at this time,--user installs for pip itself, should not be considered to be fullytested or endorsed. For discussion, see Issue 1668. |
| [4] | https://github.com/pypa/pip/issues/1299 |
Read the Docs v: latest
- On Read the Docs
- Project Home
- Builds
Free document hosting provided by Read the Docs.
