Fetching contributors…
Cannot retrieve contributors at this time
138 lines (83 sloc) 3.88 KB


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 or if you are working in a :ref:`Virtual Environment <pypug:Creating and using Virtual Environments>` created by :ref:`pypug:virtualenv` or :ref:`pyvenv <pypug:venv>`. Just make sure to :ref:`upgrade pip <Upgrading pip>`.

Installing with

To install pip, securely download [1]:

curl -o

As when running any script downloaded from the web, ensure that you have reviewed the code and are happy that it works as you expect. Then run the following:



Be cautious if you are using a Python install that is managed by your operating system or another package manager. does not coordinate with those tools, and may leave your system in an inconsistent state. also installs :ref:`pypug:setuptools` [2] and :ref:`pypug:wheel` if they are not already. :ref:`pypug:setuptools` is required to install :term:`source distributions <pypug:Source Distribution (or "sdist")>`. Both are required in order to build a :ref:`Wheel cache` (which improves installation speed), although neither are required to install pre-built :term:`wheels <pypug:Wheel>`.


The script is supported on the same python version as pip. For the now unsupported Python 2.6, alternate script is available here. options

.. option:: --no-setuptools

    If set, do not attempt to install :ref:`pypug:setuptools`

.. option:: --no-wheel

    If set, do not attempt to install :ref:`pypug:wheel` allows :ref:`pip install options <pip install Options>` and the :ref:`general options <General Options>`. Below are some examples:

Install from local copies of pip and setuptools:

python --no-index --find-links=/local/copies

Install to the user site [3]:

python --user

Install behind a proxy:

python --proxy="http://[user:passwd@]proxy.server:port" can also be used to install a specified combination of pip, setuptools, and wheel using the same requirements syntax as pip:

python pip==9.0.2 wheel==0.30.0 setuptools==28.8.0

Using Linux Package Managers

See :ref:`pypug:Installing pip/setuptools/wheel with Linux Package Managers` in the 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.4, 3.5, 3.6, 3.7 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.

[1]"Secure" in this context means using a modern browser or a tool like curl that verifies SSL certificates when downloading from https URLs.
[2]Beginning with pip v1.5.1, stopped requiring setuptools to be installed first.
[3]The pip developers are considering making --user the default for all installs, including installs of pip, but at this time, --user installs for pip itself, should not be considered to be fully tested or endorsed. For discussion, see Issue 1668.