Skip to content

Installation

System Requirements

python 3.6+ is required to install pipx. pipx can run binaries from packages with Python 3.3+. Don't have Python 3.6 or later? See Python 3 Installation & Setup Guide.

You also need to have pip installed on your machine for python3. Installing it varies from system to system. Consult pip's installation instructions. Installing on Linux works best with a Linux Package Manager.

pipx works on macOS, linux, and Windows.

Install pipx

Assuming you have pip installed for python3, run:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Upgrade pipx

python3 -m pip install -U pipx

Installation Options

pipx's default binary location is ~/.local/bin. This can be overriden with the environment variable PIPX_BIN_DIR.

pipx's default virtual environment location is ~/.local/pipx. This can be overridden with the environment variable PIPX_HOME.

Shell Completion

You can easily get your shell's tab completions working by following instructions printed with this command:

pipx completions

Install pipx Development Versions

New versions of pipx are published as beta or release candidates. These versions look something like 0.13.0b1, where b1 signifies the first beta release of version 0.13. These releases can be tested with

pip install --user pipx --upgrade --dev