Metadata-Version: 2.5
Name: pipx
Version: 1.18.1
Summary: Install and Run Python Applications in Isolated Environments
Project-URL: Issue Tracker, https://github.com/pypa/pipx/issues
Project-URL: Release Notes, https://pipx.pypa.io/latest/changelog.html
Project-URL: Source Code, https://github.com/pypa/pipx
Project-URL: Documentation, https://pipx.pypa.io
Project-URL: Homepage, https://pipx.pypa.io
Author-email: Chad Smith <chadsmith.software@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: Virtual Environment,cli,install,pip,workflow
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Requires-Python: >=3.11
Requires-Dist: argcomplete>=3.7.2
Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
Requires-Dist: filelock>=4.2
Requires-Dist: packaging>=26.3
Requires-Dist: platformdirs>=4.12.2
Requires-Dist: userpath!=1.9,>=1.9.2
Provides-Extra: uv
Requires-Dist: uv>=0.12.22; extra == 'uv'
Description-Content-Type: text/markdown

<p align="center">
<a href="https://pipx.pypa.io">
<img align="center" src="https://github.com/pypa/pipx/raw/main/logo.svg" width="200"/>
</a>
</p>

# pipx — Install and Run Python Applications in Isolated Environments

<p align="center">
<a href="https://github.com/pypa/pipx/raw/main/pipx_demo.gif">
<img src="https://github.com/pypa/pipx/raw/main/pipx_demo.gif"/>
</a>
</p>

<p align="center">
<a href="https://github.com/pypa/pipx/actions/workflows/tests.yml">
<img src="https://github.com/pypa/pipx/actions/workflows/tests.yml/badge.svg?event=push&branch=main" alt="image" /></a> <a href="https://badge.fury.io/py/pipx"><img src="https://badge.fury.io/py/pipx.svg" alt="PyPI version"></a> <a href="https://badge.fury.io/py/pipx"><img src="https://static.pepy.tech/badge/pipx"></a>

</p>

**Documentation**: <https://pipx.pypa.io>

**Source Code**: <https://github.com/pypa/pipx>

_For comparison to other tools including pipsi, see
[Comparison to Other Tools](https://pipx.pypa.io/stable/explanation/comparisons.html)._

## 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](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b), and
Linux's `apt`.

It's closely related to pip. It installs with uv when available and pip otherwise, 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

- expose CLI entrypoints of packages ("apps") installed to isolated environments with the `install` command,
    guaranteeing no dependency conflicts and clean uninstalls;
- easily list, upgrade, and uninstall packages that were installed with pipx; and
- run the latest version of a Python application in a temporary environment with the `run` command.

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](https://pipx.pypa.io/stable/how-to/install-pipx.html) for commands and alternatives.

```
pipx ensurepath
```

### On Windows

```
scoop install pipx
pipx ensurepath
```

For more detailed installation instructions, see the
[full documentation](https://pipx.pypa.io/stable/how-to/install-pipx.html).

## Quick Start

Install an application for your user:

```
pipx install pycowsay
pycowsay mooo
```

Run an application without installing:

```
pipx run pycowsay moo
```

See the [full documentation](https://pipx.pypa.io/stable/) for more details.

## Contributing

Issues and Pull Requests are definitely welcome! Check out [Contributing](https://pipx.pypa.io/stable/contributing.html)
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](https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md).
