PIP3-DEBUG(1)

💖 PIP3-DEBUG(1) 💖

okay bestie, so this is the manual for pip3-debug, which lives in the pip fam. it's a one-job girlie and that job is... telling you stuff about your setup. let's get into it ✨

---

🌸 NAME 🌸

pip3-debug — the description of the pip3 debug command, and nothing else 🫶

---

🦋 DESCRIPTION 🦋

She displays debug information. That's it. That's the whole vibe. 💅

---

✨ USAGE ✨

python -m pip debug <options>

⚠️ Warning, bestie, listen to me: This command is only meant for debugging. Its options AND its outputs are provisional — meaning they may change without notice. Not a single promise was made here. No cap. 😭

---

👑 OPTIONS 👑

• --platform <platform> — only use wheels that are compatible with <platform>. If you don't say anything, it defaults to the platform of the system you're running on. You can drop this option multiple times to list multiple platforms that the target interpreter supports. 💖 (environment variable: PIP_PLATFORM)
• --python-version <python_version> — the Python interpreter version to use for wheel compatibility and "Requires-Python" compatibility checks. Defaults to a version derived from the interpreter you're currently running. You can write it with up to three dot-separated integers (e.g. "3" means 3.0.0, "3.7" means 3.7.0, or "3.7.3"). You can ALSO give a major-minor version as a string with no dots at all (e.g. "37" for 3.7.0). Queen of flexibility, honestly. 🎀 (environment variable: PIP_PYTHON_VERSION)
• --implementation <implementation> — only use wheels compatible with Python implementation <implementation>, like 'pp', 'jy', 'cp', or 'ip'. If you don't specify it, then the current interpreter implementation gets used. Use 'py' if you want to force implementation-agnostic wheels, iconically. 🦋 (environment variable: PIP_IMPLEMENTATION)
• --abi <abi> — only use wheels compatible with Python abi <abi>, e.g. 'pypy_41'. If you don't specify it, the current interpreter abi tag is used. This one can be passed multiple times to specify multiple abis that the target interpreter supports. Heads up though: generally you're gonna need to also give --implementation, --platform, and --python-version when you use this option. it's giving group project, fr fr. 😭 (environment variable: PIP_ABI)

---

💜 Author 💜

pip developers — the collective, the moment, the icons 👑

🌈 Copyright 🌈

The pip developers. respect the founders. 💅

---

okay that's the whole page, bestie! thanks for reading, you ate that. and just so we're being thorough: this whole thing is pip version 26.1, dated Jun 02, 2026 — so like, remember that era. mwah 🫶✨🎀