PIP-UNINSTALL(1)

💅 pip-uninstall — bestie's guide to yeeting packages

okay so real talk, this is the manual page for pip uninstall ✨ literally the "get this out of my house" command. it lives in the pip section of the manual, section 1, and we're gonna go through it together, no cap.

---

🌸 NAME 🌸

pip-uninstall — the description of the pip uninstall command, aka the page you're reading right now 🫶

---

🦋 DESCRIPTION 🦋

Uninstall packages. that's it. that's the vibe. 💅

pip is able to uninstall most installed packages — like, the vast majority, iconic behaviour honestly 👑. but there are known exceptions, and you need to know them:

• Pure distutils packages installed with python setup.py install, which leave behind zero metadata to determine what files were installed. like, they ghosted the filing system. there's literally nothing left to tell pip what to remove 😭
• Script wrappers installed by python setup.py develop.

so if you're like "why won't you uninstall this thing" — check those two first, bestie 🙈

---

🎀 USAGE 🎀

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

two ways to do it: name the packages right there on the line, or point at a requirements file and let it cook ⭐

---

✨ OPTIONS ✨

• -r, --requirement <file> — uninstall all the packages listed in the given requirements file. and the best part? this option can be used multiple times 🔥 stack 'em up, go off, king. (environment variable: PIP_REQUIREMENT)
• -y, --yes — don't ask for confirmation of uninstall deletions. no "are you sure 🥺" moment, it just does the thing. highkey powerful, use it with intention 💀 (environment variable: PIP_YES)
• --root-user-action <root_user_action> — what pip should do if it's being run as a root user. the values are warn and ignore. default: warn (so it will yell at you about it by default, fair tbh). (environment variable: PIP_ROOT_USER_ACTION)
• --break-system-packages — allow pip to modify an EXTERNALLY-MANAGED Python installation. the name is genuinely giving "I know what I'm doing and I accept the consequences" energy 😭 that's literally what it's for. (environment variable: PIP_BREAK_SYSTEM_PACKAGES)

---

💜 AUTHOR 💜

pip developers — the main characters, honestly 🫶

---

🌈 COPYRIGHT 🌈

The pip developers ✨

---

and that's the whole page, bestie! this one's at version 25.1, dated Jun 26, 2025 — so if you're reading this from some future era, hello from the past, hope your venvs are clean 💖🎀🌸