# pip(1) - man - phpman > **TLDR:** Python package manager. > - Install a package (see `pip install` for more install examples): `pip install {{package}}` - Install a package to the user's directory instead of the system-wide default location: `pip install --user {{package}}` - Upgrade a package: `pip install {{-U|--upgrade}} {{package}}` - Uninstall a package: `pip uninstall {{package}}` - Save installed packages to file: `pip freeze > {{requirements.txt}}` - List installed packages: `pip list` - Show installed package info: `pip show {{package}}` - Install packages from a file: `pip install {{-r|--requirement}} {{requirements.txt}}` *Source: tldr-pages* --- [PIP(1)](https://www.chedong.com/phpMan.php/man/PIP/1/markdown) [PIP(1)](https://www.chedong.com/phpMan.php/man/PIP/1/markdown) ## NAME pip - A tool for installing and managing Python packages ## SYNOPSIS pip [options] pip3 [options] ## DESCRIPTION **pip** is a Python package installer, recommended for installing Python packages which are not available in the Debian archive. It can work with version control repositories (currently only Git, Mercurial, and Bazaar repositories), logs output extensively, and prevents partial installs by downloading all requirements before starting installation. On Debian, **pip** is the command to use when installing packages for Python 2, while **pip3** is the command to use when installing packages for Python 3. ## COMMANDS The command comes before any options. The following commands are recognized: **help** Show help for commands. ### install Install packages. ### uninstall Uninstall packages. **freeze** Output installed packages in requirements format. **list** List installed packages. **show** Show information about installed packages. **search** Search PyPI for packages. **wheel** Build wheels from your requirements. ## GENERAL OPTIONS This list is by no means complete, and it only describes options available to all commands. Use **pip** **** **--help** for more details on command specific options. A few command options are provided below. ### -h --help Show more detailed command help. ### -v --verbose Give more output. Option is additive, and can be used up to 3 times. ### -V --version Show version and exit. ### -q --quiet Give less output. **--log-file** __ Path to a verbose non-appending log, that only logs failures. This log is active by default at _~/.pip/pip.log_. **--log** __ Path to a verbose appending log. This log is inactive by default. **--proxy** __ Specify a proxy in the form **[user:passwd@]proxy.server:port**. **--timeout** __ Set the socket timeout (default 15 seconds). **--exists-action** __ Default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup. **--cert** __ Path to alternate CA bundle. ## INSTALL OPTIONS **pip** **install** installs packages from: • PyPI (a.k.a. The Cheeseshop) and other indexes, using requirements specifiers. • VCS project urls. • Local project directories. • Local or remote source archives • Local wheel directories (python-pip-whl installs its wheels in /usr/share/ python-wheels and they can be locally installed by pip using --find-links) ### -e Install a project in editable mode (i.e. setuptools "develop mode") from a local project path or a VCS url. ### -r Install from the given requirements file. This option can be used multiple times. ### -b Directory to unpack packages into and build in. The default in a virtualenv is "/build". The default for global installs is "/pip_build_". ### -t Install packages into . ### -d Download packages into instead of installing them, regardless of what's already installed. **--download-cache** __ Cache downloaded packages in . **--src** __ Directory to check out editable projects into. The default in a virtualenv is "/src". The default for global installs is "/src". ### -U --upgrade Upgrade all packages to the newest available version. This process is recursive re‐ gardless of whether a dependency is already satisfied. ### --force-reinstall When upgrading, reinstall all packages even if they are already up-to-date. ### -I --ignore-installed Ignore the installed packages (reinstalling instead). ### --no-deps Don't install package dependencies. **--install-option** __ Extra arguments to be supplied to the setup.py install command (use like --install-op‐ tion ="--install-scripts=/usr/local/bin"). Use multiple --install-option options to pass multiple options to setup.py install. If you are using an option with a directory path, be sure to use absolute path. **--global-option** __ Extra global options to be supplied to the setup.py call before the install command. **--user** Install using the user scheme. **--egg** Install packages as eggs, not 'flat', like pip normally does. This option is not about installing _from_ eggs. (WARNING: Because this option overrides pip's normal install logic, requirements files may not behave as expected.) **--root** __ Install everything relative to this alternate root directory. ### --compile Compile py files to pyc. ### --no-compile Do not compile py files to pyc. ### --no-use-wheel Do not find and prefer wheel archives when searching indexes and find-links locations. **--pre** Include pre-release and development versions. By default, pip only finds stable ver‐ sions. ### --no-clean Don't clean up build directories. Package Index Options: ### -i Base URL of Python Package Index (default _). **--extra-index-url** __ Extra URLs of package indexes to use in addition to --index-url. ### --no-index Ignore package index (only looking at --find-links URLs instead). ### -f If a url or path to an html file, then parse for links to archives. If a local path or _file://_ url that's a directory, then look for archives in the directory listing. **--allow-external** __ Allow the installation of externally hosted files ### --allow-all-external Allow the installation of all externally hosted files **--allow-unverified** __ Allow the installation of insecure and unverifiable files ### --process-dependency-links Enable the processing of dependency links. ## UNINSTALL OPTIONS pip is able to uninstall most installed packages. Known exceptions are: • Pure distutils packages installed with **python** **setup.py** **install**, which leave behind no metadata to determine what files were installed. • Script wrappers installed by **python** **setup.py** **develop**. ### -r Uninstall all the packages listed in the given requirements file. This option can be used multiple times. ### -y --yes Don't ask for confirmation of uninstall deletions. ## AUTHORS This manual page was originally written by Jeff Licquia <<_licquia@debian.org_>>, later rewritten by Carl Chenet <<_chaica@debian.org_>>. It was rewritten again and the source converted to re‐ StructuredText by Barry Warsaw <<_barry@debian.org_>>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, version 3 or any later version published by the Free Software Foundation. ## AUTHOR Barry Warsaw <> 1.5.6 2014-06-03 [PIP(1)](https://www.chedong.com/phpMan.php/man/PIP/1/markdown)