pipx - Man Page
install and run Python applications in isolated environments
Examples (TL;DR)
- Run an app in a temporary virtual environment:
pipx run pycowsay moo - Install a package in a virtual environment and add entry points to path:
pipx install package - Uninstall a package:
pipx uninstall package - List installed packages:
pipx list - Run an app in a temporary virtual environment with a package name different from the executable:
pipx run --spec httpx-cli httpx http://www.github.com - Inject dependencies into an existing virtual environment:
pipx inject package dependency1 dependency2 ... - Install a package in a virtual environment with pip arguments:
pipx install --pip-args='pip-args' package - Upgrade/reinstall/uninstall all installed packages:
pipx upgrade-all|uninstall-all|reinstall-all
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
Restore resources from a hidden 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. Runs pip install -U <pkgname> for each package.
- 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 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), virtualenv(1)
Authors
Chad Smith and contributors