PIP(1)

📦 version 22.3.1, in centos-stream 9

💅 PIP(1) — the pip girlie's handbook

okay so bestie, welcome to the pip(1) manual page. this is the one, the icon, the main character of Python packaging. grab a strawberry drink 🍓 and let's get into it.

🌸 NAME

pip — package manager for Python packages. that's the whole vibe. it manages packages. for Python. periodt.

✨ SYNOPSIS

pip <command> [options]

that's it. that's the shape of every pip invocation you will ever type at 2am 😭

🦋 DESCRIPTION

pip is the PyPA recommended package manager for Python packages. PyPA said it, so it's canon. 👑

🎀 OPTIONS 🎀

okay this is the long part but literally every single one matters, so stay with me bestie:

  • -h, --help — shows help. the "help me help you" flag 💖
  • --debug — lets unhandled exceptions propagate outside the main subroutine instead of logging them to stderr. ngl this is the "let it crash dramatically" mode 💀
  • --isolated — runs pip in an isolated mode, ignoring environment variables and user configuration. no outside influences, just vibes 🧚
  • --require-virtualenv — allows pip to only run in a virtual environment; exits with an error otherwise. it's giving protective best friend 🫶
  • --python <python> — runs pip with the specified Python interpreter. choose your fighter ⭐
  • -v, --verbose — give more output. this option is additive, and can be used up to 3 times. the "tell me everything" flag 🙈
  • -V, --version — shows version and exits. quick little flex ✨
  • -q, --quiet — give less output. also additive, also usable up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels). the "shhh i'm concentrating" flag 🤫
  • --log <path> — path to a verbose appending log. receipts, kept forever 📝
  • --no-input — disables prompting for input. no questions, no interruptions, no cap 💅
  • --proxy <proxy> — specify a proxy in the form scheme://[user:passwd@]proxy.server:port. copy that exactly, bestie, don't freestyle it 🔥
  • --retries <retries> — maximum number of retries each connection should attempt (default 5 times). persistence queen 👑
  • --timeout <sec> — sets the socket timeout (default 15 seconds). don't wait forever for anyone 🌈
  • --exists-action <action> — default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. pick your coping mechanism 🎀
  • --trusted-host <hostname> — mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS. highkey risky but it's your call 💀
  • --cert <path> — path to PEM-encoded CA certificate bundle. if provided, overrides the default. see 'SSL Certificate Verification' in pip documentation for more information 🦋
  • --client-cert <path> — path to SSL client certificate, a single file containing the private key and the certificate in PEM format 🔐
  • --cache-dir <dir> — store the cache data in <dir>. a home for your little cached treasures 🍓
  • --no-cache-dir — disables the cache. clear skin, empty cache, no thoughts ✨
  • --disable-pip-version-check — don't periodically check PyPI to determine whether a new version of pip is available for download. implied with --no-index. living in the moment, ignoring your notifications 📵
  • --no-color — suppresses colored output. for the monochrome girlies 🖤
  • --no-python-version-warning — silences deprecation warnings for upcoming unsupported Pythons. ignorance is bliss, but like, deliberately 🙈
  • --use-feature <feature> — enables new functionality, that may be backward incompatible. living on the edge, we love to see it 🔥
  • --use-deprecated <feature> — enables deprecated functionality, that will be removed in the future. enjoy it while it lasts, it's on a countdown ⏳

💜 COMMANDS 💜

each of these has its own whole manual page, so this is like the group chat roster of pip's friends:

  • pip-install(1) — install packages. the classic. the moment. the reason you're here 👑
  • pip-download(1) — download packages. grabbing without committing, we respect it 💅
  • pip-uninstall(1) — uninstall packages. the breakup era 😭
  • pip-freeze(1) — output installed packages in requirements format. snapshot the whole situation 📸
  • pip-list(1) — list installed packages. inventory check ✨
  • pip-show(1) — show information about installed packages. the little bio page 🎀
  • pip-check(1) — verify installed packages have compatible dependencies. friendship compatibility test 🫶
  • pip-search(1) — search PyPI for packages. doomscrolling but productive 🌸
  • pip-wheel(1) — build wheels from your requirements. wheels!! 🛞 (sorry, had to)
  • pip-hash(1) — compute hashes of package archives. math girlie behavior 🔢
  • pip-help(1) — show help for pip commands. when in doubt, ask the group chat 💖

🌟 AUTHOR

the pip developers. legends, all of them. 🫶

The pip developers. same legends, now with legal paperwork. 📜

real talk though: --trusted-host means skipping HTTPS validation, and --use-deprecated means you're using stuff that's literally scheduled for removal. cute flags, but read what they actually do before you ship anything, okay? 💖

and that's the whole page bestie 🎀 biggest slay of the day goes to pip version 22.3, dated Jun 25, 2025 — the PIP(1) manual, signed, sealed, and fully vibe-checked. iykyk 💜✨

📦 where this page comes from