PIP-UNINSTALL(1)

💅 PIP-UNINSTALL(1) — bestie edition

ok so this is the manual page for pip-uninstall, and it lives in the pip section of the manual (section 1, iykyk). grab a strawberry drink 🍓 and let's get into it.

---

✨ NAME ✨

pip-uninstall — literally the description of the pip uninstall command 🫶

---

🌸 DESCRIPTION 🌸

It uninstalls packages. That's it. That's the whole vibe. 💅

pip is able to uninstall most installed packages, which is iconic of it. But bestie, there are some known exceptions, and you need to know them:

• Pure distutils packages installed with python setup.py install — these leave behind no metadata to determine what files were installed. 😭 so pip can't find them, not its fault fr fr.
• Script wrappers installed by python setup.py develop.

no cap: if your package came from one of those two situations, the uninstall just isn't happening. sorry bestie 💀

---

🦋 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. and the way that this option can be used multiple times? obsessed. 🔥

(environment variable: PIP_REQUIREMENT)

• -y, --yes — don't ask for confirmation of uninstall deletions. main character energy, no questions asked, straight to the deletion ✨

(environment variable: PIP_YES)

• --root-user-action <root_user_action> — what action to take if pip is run as a root user. the valid values are [warn, ignore], and the default is warn. 🧚

(environment variable: PIP_ROOT_USER_ACTION)

• --break-system-packages — allow pip to modify an EXTERNALLY-MANAGED Python installation. this is giving chaotic and powerful, so be careful bestie 🙈

(environment variable: PIP_BREAK_SYSTEM_PACKAGES)

---

👑 Author 👑

pip developers

---

⭐ Copyright ⭐

The pip developers

---

🌈 SEE ALSO 🌈

ok so there weren't any SEE ALSO references on this one, so nothing to link here — but you already knew that 💜

---

that's the whole page, bestie!! 🎀 this one's from pip version 26.0, dated Aug 26, 2026 — so if you're reading this, hi from the future, slay, go uninstall something responsibly 💖✨🌸🦋💅🫶🔥👑🌈⭐💀🙈🍓🧚💜