Reference

pipx(1)

install and run Python applications in isolated environments

Name

pipx - install and run Python applications in isolated environments

SYNOPSIS

pipx [global-options] [install | install-all | uninject | inject | expose | unexpose | pin | unpin | upgrade | upgrade-all | upgrade-shared | uninstall | uninstall-all | reset | reinstall | reinstall-all | health | repair | list | interpreter | cache | manifest | run | exec | runpip | ensurepath | environment | completions | help] [command-options]

DESCRIPTION

pipx installs and runs Python applications in isolated environments while exposing their commands on your PATH.

COMMANDS

install

Install a package

install-all

Install all packages

uninject

Uninstall injected packages from an existing Virtual Environment

inject

Install packages into an existing Virtual Environment

expose

Relink hidden or missing resources of an environment

unexpose

Hide resources without removing an environment

pin

Pin the specified package to prevent it from being upgraded

unpin

Unpin the specified package

upgrade

Upgrade a package

upgrade-all

Upgrade all packages.

upgrade-shared

Upgrade shared libraries.

uninstall

Uninstall a package

uninstall-all

Uninstall all packages

reset

Return pipx to a fresh install

reinstall

Reinstall a package

reinstall-all

Reinstall all packages

health

Check installed package environments

repair

Repair broken package environments

list

List installed packages

interpreter

Interact with interpreters managed by pipx

cache

Manage cached run environments

manifest

Manage tools declared in an explicit manifest

run

Download the latest version of a package to a temporary virtual environment, then run an app from it. Also compatible with local __pypackages__ directory (experimental).

exec

Run an application from an existing pipx environment

runpip

Run pip, or uv pip under the uv backend, in an existing pipx-managed Virtual Environment

ensurepath

Ensure directories necessary for pipx operation are in your PATH environment variable.

environment

Print a list of environment variables and paths used by pipx.

completions

Print instructions on enabling shell completions for pipx

help

Show help for pipx or a command

Run pipx command --help for command-specific options.

GLOBAL OPTIONS

-h, --help

show this help message and exit

--version

Print version and exit

ENVIRONMENT VARIABLES

PIPX_HOME

Directory for pipx-managed environments and state.

PIPX_BIN_DIR

Directory where pipx exposes application commands.

PIPX_DEFAULT_PYTHON

Default interpreter used to create environments.

PIPX_USE_EMOJI

Set to 0 to disable emoji output.

SEE ALSO

Full documentation: <https://pipx.pypa.io/>

pip(1), virtualenv(1)

AUTHORS

Chad Smith and contributors

<https://github.com/pypa/pipx>

History

--help since Arch Linux 2026-11-01; -h since Arch Linux 2026-11-01.

--global until Debian 13 (Trixie); --quiet until Debian 13 (Trixie); --verbose until Debian 13 (Trixie); -q until Debian 13 (Trixie); -v until Debian 13 (Trixie).