PIP-CHECK(1)

📦 version 23.2.1, in centos-stream 9

💅 PIP-CHECK(1) — the pip girlies' checkup era ✨

okay so bestie, this is a page from the pip manual fam — like, the pip one, yes, that pip — and this specific page is all about the pip check command. it's giving "annual physical but for your site-packages" and honestly? we love her for it 🫶

🌸 NAME 🌸

pip-check — the description of the pip check command. that's it, that's the name, she's literally just vibing with a hyphen and a purpose 💖

✨ DESCRIPTION ✨

Verify installed packages have compatible dependencies ✨

that's the whole thing, no cap. she goes through what you've got installed and checks that the dependencies actually line up, so you don't find out something's broken three imports deep at 2am 😭 it's the vibe check your environment has been begging for.

🎀 USAGE 🎀

python -m pip check [options]

run her exactly like that, bestie. python -m pip check, plus whatever [options] your heart desires 👑

🔥 OPTIONS 🔥

like, so many options. she's thorough. we respect it 💅

  • -h, --help — shows the help. classic, iconic, always there for you.
  • --debug — lets unhandled exceptions escape out of the main subroutine instead of getting logged to stderr. like, letting it out into the world instead of quietly journaling about it 💀
  • --isolated — runs pip in isolated mode, meaning she ignores environment variables and your user configuration. main character energy, no outside opinions 🦋
  • --require-virtualenv — only lets pip run inside a virtual environment; if you're not in one she exits with an error. strict boundaries, love that for her.
  • --python <python> — runs pip with the specific Python interpreter you name. pick your fighter 🌈
  • -v, --verbose — more output. it's additive, so you can stack it up to 3 times. yes she gets louder, and yes it's on purpose ✨
  • -V, --version — shows the version and bounces. short and sweet.
  • -q, --quiet — less output. also additive, up to 3 times, and those three taps correspond to WARNING, ERROR, and CRITICAL logging levels respectively 🤫
  • --log <path> — path to a verbose appending log. she writes, she adds to it, she doesn't overwrite. respectful 🎀
  • --no-input — disables prompting for input. no questions, no interruptions.
  • --keyring-provider <keyring_provider> — enables credential lookup through the keyring library if user input is allowed. you specify the mechanism: [disabled, import, subprocess]. default is disabled 💜
  • --proxy <proxy> — set a proxy like scheme://[user:passwd@]proxy.server:port. yes, hold the format exactly, she's specific about it.
  • --retries <retries> — max number of retries each connection should attempt. default is 5 times 🔁
  • --timeout <sec> — sets the socket timeout. default is 15 seconds ⏳
  • --exists-action <action> — the default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. choose your destiny, bestie 🍓
  • --trusted-host <hostname> — marks this host or host:port pair as trusted, even though it doesn't have valid HTTPS or any HTTPS at all. dramatic? a little. useful? yes 🙈
  • --cert <path> — path to a PEM-encoded CA certificate bundle. if you provide it, it overrides the default. see 'SSL Certificate Verification' in the pip documentation for more 🧚
  • --client-cert <path> — path to an SSL client certificate: a single file with the private key and the certificate in PEM format. one file, two jobs, multitasking queen 👑
  • --cache-dir <dir> — stores the cache data in <dir>.
  • --no-cache-dir — disables the cache entirely. no hoarding, we're minimal now 💅
  • --disable-pip-version-check — don't periodically check PyPI to see whether a new pip version is available to download. this one is implied with --no-index ⭐
  • --no-color — suppresses colored output. monochrome era. (sad but valid.)
  • --no-python-version-warning — silences deprecation warnings for upcoming unsupported Pythons 🔕
  • --use-feature <feature> — enables new functionality that may be backward incompatible. living on the edge, bestie ⚡
  • --use-deprecated <feature> — enables deprecated functionality that will be removed in the future. enjoy her while she's here 😭
fr fr heads up: --use-deprecated is, you know, deprecated — that functionality is going away in the future. and --use-feature can be backward incompatible. both noted, both your call 💖

👑 AUTHOR 👑

the pip developers 💜

the pip developers — that's the copyright, periodt.

and that's the tea, bestie ☕ version 23.2, dated Jun 25, 2025 — go check those dependencies, you absolute icon 🌟🦋

📦 where this page comes from