mirror of
https://github.com/pypa/pip
synced 2023-12-13 21:30:23 +01:00
66 lines
2 KiB
Text
66 lines
2 KiB
Text
Installation instructions
|
|
=========================
|
|
|
|
The recommended way to use pip is within `virtualenv
|
|
<http://www.virtualenv.org>`_, 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://raw.github.com/pypa/virtualenv/master/virtualenv.py
|
|
$ python virtualenv.py my_new_env
|
|
$ . my_new_env/bin/activate
|
|
(my_new_env)$ pip install ...
|
|
|
|
When used in this manner, pip will only affect the active virtual environment.
|
|
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
|
|
<http://pypi.python.org/pypi/setuptools>`_ or `distribute
|
|
<http://pypi.python.org/pypi/distribute>`_ installed. Please consult your
|
|
operating system's package manager or install it manually::
|
|
|
|
$ curl http://python-distribute.org/distribute_setup.py | python
|
|
|
|
.. 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 <https://raw.github.com/pypa/pip/master/contrib/get-pip.py>`_
|
|
and execute it, using the Python interpreter of your choice::
|
|
|
|
$ curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python
|
|
|
|
This may have to be run as root.
|
|
|
|
Alternative installation procedures
|
|
-----------------------------------
|
|
|
|
Using the source distribution
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
You can find the source on `PyPI <http://pypi.python.org/pypi/pip>`_::
|
|
|
|
$ 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
|