---
name: "pip-uninstall"
section: "1"
platform: "linux"
package: "python-pip"
version: "26.2.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pip-uninstall"
---

# pip-uninstall(1)

description of pip uninstall command

## NAME

pip-uninstall - description of pip uninstall command

## DESCRIPTION

Uninstall packages.

pip is able to uninstall most installed packages. Known exceptions are:

- •

  Pure distutils packages installed with **python setup.py install**, which leave behind no metadata to determine what files were installed.

- •

  Script wrappers installed by **python setup.py develop**.

## USAGE

```
python -m pip uninstall [options] <package> ...
python -m pip uninstall [options] -r <requirements file> ...
```

## OPTIONS

- **-r, --requirement \<file\>**

  Uninstall all the packages listed in the given requirements file.  This option can be used multiple times.

  (environment variable: **PIP\_REQUIREMENT**)

- **-y, --yes**

  Don't ask for confirmation of uninstall deletions.

  (environment variable: **PIP\_YES**)

- **--root-user-action \<root\_user\_action\>**

  Action if pip is run as a root user \[warn, ignore\] (default: warn)

  (environment variable: **PIP\_ROOT\_USER\_ACTION**)

- **--break-system-packages**

  Allow pip to modify an EXTERNALLY-MANAGED Python installation

  (environment variable: **PIP\_BREAK\_SYSTEM\_PACKAGES**)

## Author

pip developers

## Copyright

The pip developers