PIP3-UNINSTALL(1)

📦
version 26.1.2 · 12 versions
, in ubuntu stonking

💖 NAME 💖

pip3-uninstall — bestie, this is the glow-up page for the pip3 uninstall command ✨

She lives in the pip manual, and she's here to help you let things go 🦋

🗑️ DESCRIPTION 🗑️

Uninstall packages. That's it, that's the whole vibe — we're doing a closet clean-out but for Python packages 💅

pip is able to uninstall most installed packages. But not all, babes. The known exceptions are:

  • Pure distutils packages installed with python setup.py install, which leave behind no metadata to determine what files were installed. 💀 no receipts, no paper trail, we literally cannot find them.
  • Script wrappers installed by python setup.py develop. 🫠
So like… if it was installed the old-school distutils way, pip is standing there like "girl I don't know her" 😭 No metadata = no uninstall. Periodt.

🎀 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 yes, you can use this option multiple times, no cap, stack 'em up 🧚

(environment variable: PIP_REQUIREMENT)

  • -y, --yes — Don't ask for confirmation of uninstall deletions. It's giving "I said what I said" — no take-backs, no popup, it just GOES 🔥

(environment variable: PIP_YES)

  • --root-user-action <root_user_action> — Action if pip is run as a root user [warn, ignore] (default: warn) — because running pip as root is lowkey a whole situation and pip wants to have opinions about it 👑

(environment variable: PIP_ROOT_USER_ACTION)

  • --break-system-packages — Allow pip to modify an EXTERNALLY-MANAGED Python installation. The name is not subtle bestie, it's literally telling you what you're about to do 😭🙈

(environment variable: PIP_BREAK_SYSTEM_PACKAGES)

⚠️ That last one said break system packages. It meant it. Read it again. Slowly. 💀

🌸 Author 🌸

pip developers — the icons, the moment, the blueprint 💜

The pip developers — them again, still iconic, still holding it down ✨

okay bestie that's the whole page, you're officially uninstall-pilled 🫶 that was PIP3-UNINSTALL(1) from the pip manual, version 26.1, dated Jun 02, 2026 — mwah, go forth and delete responsibly 💅🎀

📦 where this page comes from