Installation instructions

The recommended way to use pip is within virtualenv, since every virtualenv has pip installed in it automatically. This does not require root access or modify your system Python installation. For instance:

$ curl -O https://github.com/pypa/virtualenv/raw/master/virtualenv.py
$ python virtualenv.py my_new_env
$ . my_new_env/bin/activate
(my_new_env)$ pip install ...

If you do want to install pip globally into your Python installation, see the instructions below.

Prerequisites

Prior to installing pip make sure you have either setuptools or 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

If you are using Python 3.X you must use distribute; setuptools doesn’t support Python 3.X.

Using the installer

Download 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.

Alternative installation procedures

Using the source distribution

You can find the source on PyPI:

$ curl -O http://pypi.python.org/packages/source/p/pip/pip-1.0.tar.gz
$ tar xvfz pip-1.0.tar.gz
$ cd pip-1.0
$ python setup.py install # may need to be root

Installing the 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