PIP-UNINSTALL(1)

📦 version 23.2.1, in centos-stream 9

💅 PIP-UNINSTALL(1) — the pip girlies' guide 🎀

okay so bestie, you're in the pip corner of the man pages — yes, the one and only pip — and this is the pip-uninstall page. buckle up, we're yeeting packages today 🦋

✨ NAME ✨

pip-uninstall — literally the description of the pip uninstall command. that's the whole vibe. no cap.

🌸 DESCRIPTION 🌸

Uninstall packages. that's it, that's the tweet 💅

pip</purl> is able to uninstall most installed packages. but bestie, there are known exceptions, and we're gonna name them because we're not about to let you get blindsided 😭

  • Pure distutils packages installed with python setup.py install, which leave behind no metadata to determine what files were installed. it's giving "i threw away the receipt" 🙈
  • Script wrappers installed by python setup.py develop.

⭐ USAGE ⭐

here's the shape of it, keep it exactly like this:

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 yes bestie, this option can be used multiple times — stack 'em up 🔥
  • -y, --yes — don't ask for confirmation of uninstall deletions. zero questions, straight to the yeet 💀 (use responsibly, queen)
  • --root-user-action <root_user_action> — action if pip is run as a root user. by default, a warning message is shown. so like, keep that in mind 👑
  • --break-system-packages — allow pip to modify an EXTERNALLY-MANAGED Python installation. highkey a big-girl move, so know what you're doing 🫶

🌈 AUTHOR 🌈

pip developers — the icons behind it all, no notes ✨

The pip developers

bestie reminder: distutils packages installed with python setup.py install have no metadata, so pip can't work out what files to delete. that's not a bug, that's just the lore 😭 same energy for script wrappers from python setup.py develop.

and that's the page, fr fr 💖 version 23.2, dated Jun 25, 2025 — shoutout to the pip team for keeping us uninstalled and unbothered, mwah 🍓🧚⭐

📦 where this page comes from