Gecko [ touzafair.com ]

Name	Size	Permission
reference	[ DIR ]	drwxr-xr-x
configuration.rst	107 B	-rw-r--r--
cookbook.rst	113 B	-rw-r--r--
development.rst	4.35 KB	-rw-r--r--
distribute_setuptools.rst	2.48 KB	-rw-r--r--
index.rst	525 B	-rw-r--r--
installing.rst	1.94 KB	-rw-r--r--
logic.rst	139 B	-rw-r--r--
news.rst	71 B	-rw-r--r--
quickstart.rst	1021 B	-rw-r--r--
usage.rst	123 B	-rw-r--r--
user_guide.rst	15.06 KB	-rw-r--r--

Code Editor : installing.rst

.. _`Installation`:

Installation
============

Python & OS Support
-------------------

pip works with CPython versions 2.6, 2.7, 3.1, 3.2, 3.3, 3.4 and also pypy.

pip works on Unix/Linux, OS X, and Windows.

.. note::

Python 2.5 was supported through v1.3.1, and Python 2.4 was supported through v1.1.

.. _`get-pip`:

Install pip
-----------

To install or upgrade pip, securely download `get-pip.py
<https://bootstrap.pypa.io/get-pip.py>`_. [1]_

Then run the following (which may require administrator access)::

python get-pip.py

If `setuptools`_ (or `distribute`_) is not already installed, ``get-pip.py`` will
install `setuptools`_ for you. [2]_

To upgrade an existing `setuptools`_ (or `distribute`_), run ``pip install -U setuptools`` [3]_

Upgrade pip
-----------

On Linux or OS X:

pip install -U pip

On Windows [4]_:

python -m pip install -U pip

Using Package Managers
----------------------

On Linux, pip will generally be available for the system install of python using
the system package manager, although often the latest version will be
unavailable.

On Debian and Ubuntu::

sudo apt-get install python-pip

On Fedora::

sudo yum install python-pip

----

.. [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, ``get-pip.py`` stopped requiring setuptools to
       be installed first.

.. [3] Although using ``pip install --upgrade setuptools`` to upgrade from
       distribute to setuptools works in isolation, it's possible to get
       "ImportError: No module named setuptools" when using pip<1.4 to upgrade a
       package that depends on setuptools or distribute. See :doc:`here for
       details <distribute_setuptools>`.

.. [4] https://github.com/pypa/pip/issues/1299

.. _setuptools: https://pypi.python.org/pypi/setuptools
.. _distribute: https://pypi.python.org/pypi/distribute

${this.title}

Code Editor : installing.rst