pipx README

The project's README from github.com/pypa/pipx. As one markdown file: README.md.

pipx — Install and Run Python Applications in Isolated Environments

image PyPI version

Documentation: https://pipx.pypa.io

Source Code: https://github.com/pypa/pipx

For comparison to other tools including pipsi, see Comparison to Other Tools.

Overview: What is pipx?

pipx is a tool to help you install and run end-user applications written in Python. It's roughly similar to macOS's brew, JavaScript's npx, and Linux's apt.

It's closely related to pip. In fact, it uses pip, but is focused on installing and managing Python packages that can be run from the command line directly as applications.

Features

pipx enables you to

Best of all, pipx runs with regular user permissions, never calling sudo pip install.

Install pipx

On macOS

brew install pipx
pipx ensurepath

On Linux

Install pipx with your distribution's package manager. See the Linux installation instructions for commands and alternatives.

pipx ensurepath

On Windows

scoop install pipx
pipx ensurepath

For more detailed installation instructions, see the full documentation.

Quick Start

Install an application globally:

pipx install pycowsay
pycowsay mooo

Run an application without installing:

pipx run pycowsay moo

See the full documentation for more details.

Contributing

Issues and Pull Requests are definitely welcome! Check out Contributing to get started. Everyone who interacts with the pipx project via codebase, issue tracker, chat rooms, or otherwise is expected to follow the PSF Code of Conduct.

pipx (pypa/pipx)

pypi
Searching Database…

13K ·GitHub
What is this?pipx is a tool to install and run end-user Python command-line applications, each in its own isolated virtual environment so dependencies never conflict.
Is it a package manager or just a wrapper around pip?It's a CLI tool built on top of pip, similar in spirit to Homebrew, npx, or apt, but specifically for exposing CLI entrypoints of Python packages as isolated apps.
How do I install an app with it?Run 'pipx install ' to install an application globally into its own isolated environment, or 'pipx run ' to run it once in a temporary environment without installing.
Do I need pip or venv set up first?You just need Python and pip available; pipx itself is installed via your OS package manager (brew, apt, etc.) or pip, and it manages venvs for you automatically.
Does it need sudo to install packages?No — pipx is designed to run entirely with regular user permissions and never calls 'sudo pip install'.
Does it work the same on macOS, Linux, and Windows?Yes, pipx has dedicated install instructions for macOS, Linux (via your distro's package manager), and Windows.
What happens when I uninstall an app installed with pipx?Because each app lives in its own isolated environment, uninstalling cleanly removes that environment and its dependencies with no leftover clutter.
Can I upgrade apps I installed with pipx?Yes, pipx lets you list, upgrade, and uninstall any package that was installed with it.
How is pipx different from plain pip install?Plain pip installs packages into a shared environment risking dependency conflicts; pipx isolates each CLI app in its own venv while still exposing its command-line entrypoints globally.
Is there an older, similar tool pipx replaces?The README points to a 'Comparison to Other Tools' section covering pipsi, an earlier tool with similar goals.
What are similar projects?pip, rye, poetry, homebrew-cask, pipenv, ripgrep, bashka, veet
Creator
pypa
Size
5.6 MB
Stars
13K
Age
8y
Commits · 90 Days