Skip to content

# 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.
- Standalone Python — install with a downloaded Python build instead of the system one.
- 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.