Upgrade pipx

Move pipx itself to the latest release. Pick the method that matches how you installed it.

Upgrade per OS

macOS:

$ brew update && brew upgrade pipx

Ubuntu Linux:

$ sudo apt update && sudo apt upgrade pipx

Fedora Linux:

$ sudo dnf upgrade pipx

Windows (Scoop):

$ scoop update pipx

Self-managed installs

If pipx manages its own installation (see Install from source control and the self-managed bootstrap in Install pipx), upgrade it like any other pipx app:

$ pipx upgrade pipx

Upgrade via pip

When you installed pipx with pip install --user and cannot upgrade it as a pipx app:

$ python3 -m pip install --user --upgrade pipx

Warning

On systems that adopt PEP 668 (Ubuntu 23.04+, Debian 12+, Fedora 38+), this fails with externally-managed-environment. Use the distribution package or the self-managed path above instead. See Install pipx for the PEP 668 install options.

Verify it

$ pipx --version

Note

Upgrading from a pre-0.15.0.0 pipx to 0.15.0.0 or later requires reinstalling your packages so they gain the persistent metadata files that release introduced. These files store the pip spec, injected packages, and custom pip arguments in each venv. With no --spec installs and no injected packages, run pipx reinstall-all. Otherwise reinstall manually: pipx uninstall-all followed by pipx install and, where needed, pipx inject.