---
name: "pipx"
section: "1"
platform: "linux"
package: "python-pipx"
version: "1.18.4-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pipx"
---

# 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)](/pip/1.md), [**virtualenv**(1)](/virtualenv/1.md)

## AUTHORS

Chad Smith and contributors

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