How to Install pipx on Windows, macOS & Linux

pipx is a tool that installs Python applications in isolated environments. It keeps each app separate from the others.

This means no broken dependencies. No conflicts. Just clean, working command-line tools.

In this guide, you will learn how to install pipx on Windows, macOS, and Linux. Every step is beginner friendly.

What Is pipx and Why Use It?

Most Python tools are installed with pip. But pip installs packages into a shared global space.

Over time, this causes version clashes. One tool needs an old library. Another needs a new one. Things break.

pipx solves this problem. It creates a separate virtual environment for each tool you install.

The app works like a normal command. But its dependencies stay hidden and isolated.

Popular tools like black, flake8, and poetry work great with pipx.

Before You Start: Check Python

pipx needs Python 3.6 or newer. Most systems already have it.

Open your terminal or command prompt. Then run this command.

python --version

You should see something like this.

Python 3.11.4

If you see an error, install Python first. Then come back to this guide.

How to Install pipx on Windows

Windows users have two easy options. You can use pip or Scoop.

Option 1: Install pipx with pip

Open PowerShell or Command Prompt. Run the following command.

python -m pip install --user pipx

The --user flag installs pipx for your account only. This avoids permission problems.

Next, add pipx to your system path. Run this command.

python -m pipx ensurepath

The ensurepath command updates your PATH variable. This lets you run pipx from anywhere.

Close and reopen your terminal. Then check the install.

pipx --version

You should see the version number.

1.2.0

Option 2: Install pipx with Scoop

Scoop is a package manager for Windows. It makes installs very simple.

If you have Scoop, run this command.

scoop install pipx

Then run pipx ensurepath once. You are done.

How to Install pipx on macOS

On macOS, the easiest way is Homebrew. It handles everything for you.

Open the Terminal app. Then run this command.

brew install pipx

After the install finishes, update your path.

pipx ensurepath

If you do not have Homebrew, you can use pip instead.

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Restart your terminal. Then confirm the install with pipx --version.

How to Install pipx on Linux

Linux users have several choices. Pick the one that matches your distro.

Ubuntu and Debian

Run these commands in your terminal.

sudo apt update
sudo apt install pipx
pipx ensurepath

Fedora

Fedora includes pipx in its repos.

sudo dnf install pipx
pipx ensurepath

Arch Linux

Use pacman to install pipx.

sudo pacman -S python-pipx
pipx ensurepath

Any Linux with pip

If your distro does not package pipx, use pip.

python3 -m pip install --user pipx
python3 -m pipx ensurepath

After any install, restart your shell. Then run pipx --version to verify.

Test Your pipx Install

Let us install a real tool to test pipx. We will use cowsay.

Run this command.

pipx install cowsay

You should see output like this.

  installed package cowsay 6.1, installed using Python 3.11.4
  These apps are now globally available
    - cowsay
done! ✨ 🌟 ✨

Now run the tool.

cowsay "pipx works!"

The output looks like this.

 ______________
< pipx works! >
 --------------
        \   ^__^
         \  (oo)\_______
            (__)\       )\/\
                ||----w |
                ||     ||

If you see the cow, your install worked perfectly.

Common pipx Commands

Once pipx is installed, learn a few basic commands.

Use pipx list to see all installed apps.

pipx list

Use pipx uninstall to remove a tool.

pipx uninstall cowsay

Use pipx upgrade to update a tool to its latest version.

pipx upgrade cowsay

These three commands cover most daily use.

Troubleshooting Common Issues

Sometimes things go wrong. Here are the most common problems and fixes.

If you see "pipx: command not found", your PATH is not set. Run pipx ensurepath again. Then restart your terminal.

If pipx installs but apps do not run, check your PATH. The pipx bin folder must be included.

On Windows, the bin folder is usually at %USERPROFILE%\.local\bin.

On macOS and Linux, it is usually at ~/.local/bin.

Another common issue is an old pip. Update it first with python -m pip install --upgrade pip.

If you use multiple Python versions, tell pipx which one to use. Run pipx install --python python3.11 cowsay.

Why pipx Beats Global pip Installs

Global installs mix everything together. One bad update can break many tools.

pipx keeps each app in its own bubble. Updates stay safe. Removals are clean.

It also saves disk space. Apps share the same Python base when possible.

For any Python command-line tool, pipx is the modern standard.

Conclusion

Installing pipx is quick on any platform. Windows uses pip or Scoop. macOS uses Homebrew. Linux uses apt, dnf, pacman, or pip.

The key step is always pipx ensurepath. It makes pipx and its apps available everywhere.

Once installed, pipx keeps your Python tools isolated and safe. No more dependency conflicts.

Try it today. Install one tool with pipx. You will never go back to global pip installs.