pip - Man Page

package manager for Python packages

Examples (TL;DR)

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 --upgrade package
Uninstall a package: pip uninstall package
Save installed packages to file: pip freeze > requirements.txt
Show installed package info: pip show package
Install packages from a file: pip install --requirement requirements.txt

tldr.sh

Synopsis

pip <command> [options]

Description

pip is the PyPA recommended package manager for Python packages

Options

-h, --help

Show help.

(environment variable: PIP_HELP)

--debug

Let unhandled exceptions propagate outside the main subroutine, instead of logging them to stderr.

(environment variable: PIP_DEBUG)

--isolated

Run pip in an isolated mode, ignoring environment variables and user configuration.

(environment variable: PIP_ISOLATED)

--require-virtualenv

Allow pip to only run in a virtual environment; exit with an error otherwise.

(environment variable: PIP_REQUIRE_VIRTUALENV, PIP_REQUIRE_VENV)

--python <python>

Run pip with the specified Python interpreter.

(environment variable: PIP_PYTHON)

-v, --verbose

Give more output. Option is additive, and can be used up to 3 times.

(environment variable: PIP_VERBOSE)

-V, --version

Show version and exit.

(environment variable: PIP_VERSION)

-q, --quiet

Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels).

(environment variable: PIP_QUIET)

--log <path>

Path to a verbose appending log.

(environment variable: PIP_LOG, PIP_LOG_FILE, PIP_LOCAL_LOG)

--no-input

Disable prompting for input.

(environment variable: PIP_NO_INPUT)

--keyring-provider <keyring_provider>

Enable the credential lookup via the keyring library if user input is allowed. Specify which mechanism to use [disabled, import, subprocess]. (default: disabled)

(environment variable: PIP_KEYRING_PROVIDER)

--proxy <proxy>

Specify a proxy in the form scheme://[user:passwd@]proxy.server:port.

(environment variable: PIP_PROXY)

--retries <retries>

Maximum number of retries each connection should attempt (default 5 times).

(environment variable: PIP_RETRIES)

--timeout <sec>

Set the socket timeout (default 15 seconds).

(environment variable: PIP_TIMEOUT, PIP_DEFAULT_TIMEOUT)

--exists-action <action>

Default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.

(environment variable: PIP_EXISTS_ACTION)

--trusted-host <hostname>

Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS.

(environment variable: PIP_TRUSTED_HOST)

--cert <path>

Path to PEM-encoded CA certificate bundle. If provided, overrides the default. See 'SSL Certificate Verification' in pip documentation for more information.

(environment variable: PIP_CERT)

--client-cert <path>