How-to Guides

Recipes for common pipx tasks. Each guide covers a specific goal and assumes you have pipx installed.

• Install pipx — system requirements and OS-specific installation steps.
• Upgrade pipx — keep pipx itself up to date.
• Inject Packages — add extra packages into an existing pipx environment.
• Pin Packages — hold a package at its current version.
• Run Scripts — run specific versions, from URLs, or from source control.
• Use with pre-commit — integrate pipx with pre-commit hooks.
• Configure Paths — customise PIPX_HOME, PIPX_BIN_DIR, and global installs.
• Move Installation — relocate your pipx directory.
• Shell Completions — enable tab completion for your shell.
• Troubleshoot — fix common problems.