pipx1

Install and run python applications in isolated environments

Usage

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]

Overview

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.

Options

-h, --help: show this help message and exit

--version: Print version and exit

Environment

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.

History

Arch Linux 2026-11-01: the text shown here
Debian 13 (Trixie)
Debian 12 (Bookworm)

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