pip/docs/installing.txt

Installation instructions
=========================

Prerequisites
-------------

Prior to installing pip make sure you have either
`setuptools <http://pypi.python.org/pypi/setuptools>`_ or its more up to
date fork `distribute <http://pypi.python.org/pypi/distribute>`_ installed.
Please consult your operating system's package manager or install it
manually::

    $ curl -O http://python-distribute.org/distribute_setup.py
    $ python distribute_setup.py

.. warning::

    In case you are using Python 3.X you **have** to use distribute since
    setuptools doesn't support Python 3.X.

Using installer
---------------

Download `get-pip.py <https://github.com/pypa/pip/raw/master/contrib/get-pip.py>`_
and execute it, using the Python interpreter of your choice::

    $ curl -O https://github.com/pypa/pip/raw/master/contrib/get-pip.py
    $ python get-pip.py

This may have to be run as root.

Using source
------------
You can find the source on PyPi: http://pypi.python.org/pypi/pip::

    $ tar xvfz pip-*.*.*.tar.gz
    $ cd pip-*.*.*
    $ python setup.py install # may need to be root

Installing development version
------------------------------

First you will need to clone the git repo::

    $ git clone https://github.com/pypa/pip.git

Now we can install from the repo::

    $ cd pip
    $ python setup.py install # may need to be root