PIP-DEBUG(1)

✨ PIP-DEBUG(1) ✨

okay bestie, welcome to the pip-debug page — it's the manual for the pip debug command, and yes we're doing this together, hand in hand, no cap 🫶

---

💖 NAME 💖

pip-debug — the lil description of the pip debug command, bestie. it's giving "what even is this thing" energy and we're about to find out 💅

---

🦋 DESCRIPTION 🦋

It displays debug information. That's it. That's the whole job. Display debug information. ✨

---

🌸 USAGE 🌸

python -m pip debug <options>

Warning: This command is only meant for debugging. Its options and outputs are provisional and may change without notice.

so like… yes it exists, yes it's useful, but it is lowkey under construction forever 😭. The options and the outputs are provisional — they can literally change without anyone telling you. Not a vibe you want to build your whole pipeline on, fr fr. Use it for debugging, periodt.

---

🎀 OPTIONS 🎀

• --platform <platform> — only use wheels that are compatible with <platform>. If you don't say anything, it defaults to the platform of the running system. Wanna flex multiple platforms supported by the target interpreter? Just use this option multiple times, iconic. 💅

(environment variable: PIP_PLATFORM)

• --python-version <python_version> — the Python interpreter version used for wheel and "Requires-Python" compatibility checks. No input? It defaults to a version derived from the running interpreter, cute. You can write the version as up to three dot-separated integers — like "3" for 3.0.0, "3.7" for 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. Flexible queen 👑

(environment variable: PIP_PYTHON_VERSION)

• --implementation <implementation> — only use wheels compatible with the Python implementation <implementation>, e.g. 'pp', 'jy', 'cp', or 'ip'. If you don't specify it, then the current interpreter implementation is used. And if you wanna force implementation-agnostic wheels? Use 'py'. Slay 🌈

(environment variable: PIP_IMPLEMENTATION)

• --abi <abi> — only use wheels compatible with the Python abi <abi>, e.g. 'pypy_41'. If you don't specify it, then the current interpreter abi tag is used. Use this option multiple times to specify multiple abis supported by the target interpreter. Heads up bestie: generally you will need to specify --implementation, --platform, and --python-version when using this option — they're a package deal, iykyk 💀

(environment variable: PIP_ABI)

---

👑 Author 👑

pip developers

---

💜 Copyright 💜

The pip developers

---

and that's the whole page, bestie!! 🧚 version 26.0, dated Aug 26, 2026, coming at you straight from the pip manual, section PIP-DEBUG(1). go debug something gorgeous. mwah 💋✨