pipx(1) User Commands pipx(1)

# [Name](#Name)

pipx - install and run Python applications in isolated environments

# [SYNOPSIS](#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](#DESCRIPTION)

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

# [COMMANDS](#COMMANDS)

[**install**](#install)

Install a package

[**install-all**](#install~2)

Install all packages

[**uninject**](#uninject)

Uninstall injected packages from an existing Virtual Environment

[**inject**](#inject)

Install packages into an existing Virtual Environment

[**expose**](#expose)

Restore resources from a hidden environment

[**unexpose**](#unexpose)

Hide resources without removing an environment

[**pin**](#pin)

Pin the specified package to prevent it from being upgraded

[**unpin**](#unpin)

Unpin the specified package

[**upgrade**](#upgrade)

Upgrade a package

[**upgrade-all**](#upgrade~2)

Upgrade all packages. Runs **pip install -U <pkgname>** for each package.

[**upgrade-shared**](#upgrade~3)

Upgrade shared libraries.

[**uninstall**](#uninstall)

Uninstall a package

[**uninstall-all**](#uninstall~2)

Uninstall all packages

[**reset**](#reset)

Return pipx to a fresh install

[**reinstall**](#reinstall)

Reinstall a package

[**reinstall-all**](#reinstall~2)

Reinstall all packages

[**health**](#health)

Check installed package environments

[**repair**](#repair)

Repair broken package environments

[**list**](#list)

List installed packages

[**interpreter**](#interpreter)

Interact with interpreters managed by pipx

[**cache**](#cache)

Manage cached run environments

[**manifest**](#manifest)

Manage tools declared in an explicit manifest

[**run**](#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**](#exec)

Run an application from an existing pipx environment

[**runpip**](#runpip)

Run pip in an existing pipx-managed Virtual Environment

[**ensurepath**](#ensurepath)

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

[**environment**](#environment)

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

[**completions**](#completions)

Print instructions on enabling shell completions for pipx

[**help**](#help)

Show help for pipx or a command

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

# [GLOBAL OPTIONS](#GLOBAL_OPTIONS)

[**-h, --help**](#h)

show this help message and exit

[**--version**](#version)

Print version and exit

# [ENVIRONMENT VARIABLES](#ENVIRONMENT_VARIABLES)

[**PIPX\_HOME**](#PIPX_HOME)

Directory for pipx-managed environments and state.

[**PIPX\_BIN\_DIR**](#PIPX_BIN_DIR)

Directory where pipx exposes application commands.

[**PIPX\_DEFAULT\_PYTHON**](#PIPX_DEFAULT_PYTHON)

Default interpreter used to create environments.

[**PIPX\_USE\_EMOJI**](#PIPX_USE_EMOJI)

Set to **0** to disable emoji output.

# [SEE ALSO](#SEE_ALSO)

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

[**pip**(1)](/man/os/pipx/pip.1), [**virtualenv**(1)](/man/os/pipx/virtualenv.1)

# [AUTHORS](#AUTHORS)

Chad Smith and contributors

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

---

Document: pipx(1) from pipx 1.17.1-r1 (Chainguard OS)
Source: https://github.com/pypa/pipx.git