PIP(1)

💅 PIP — like, the manual page, but make it make sense

okay bestie, welcome to the pip page ✨ this is the pip manual — yes, the whole thing — and I'm gonna walk you through every single flag like we're texting at 2am 🫶

---

🌸 NAME 🌸

pip — package manager for Python packages 💖 that's the whole vibe. it installs your Python packages, it's the moment, it's the main character.

---

✨ SYNOPSIS ✨

pip <command> [options]

that's it. command first, options after. no cap 🎀

---

🦋 DESCRIPTION 🦋

pip is the PyPA recommended package manager for Python packages 👑 like, officially the one the PyPA tells you to use. iconic behaviour only.

---

🔥 OPTIONS 🔥

okay this is the long part, but stay with me, every single one is here fr fr 🍓

• -h, --help — show help. that's it, that's the tweet. (environment variable: PIP_HELP)
• --debug — let unhandled exceptions propagate outside the main subroutine instead of logging them to stderr 👀 so like, yeah, you get the raw crash. (environment variable: PIP_DEBUG)
• --isolated — run pip in an isolated mode, ignoring environment variables and user configuration 🧚 no outside influence, pure vibes. (environment variable: PIP_ISOLATED)
• --require-virtualenv — allow pip to only run in a virtual environment; exit with an error otherwise 🚪 bestie it will refuse to run outside a venv. (environment variable: PIP_REQUIRE_VIRTUALENV, PIP_REQUIRE_VENV)
• --python <python> — run pip with the specified Python interpreter 🐍 (environment variable: PIP_PYTHON)
• -v, --verbose — give more output. this option is additive and can be used up to 3 times 📈 (environment variable: PIP_VERBOSE)
• -V, --version — show version and exit 💫 (environment variable: PIP_VERSION)
• -q, --quiet — give less output. also additive, also up to 3 times, corresponding to WARNING, ERROR, and CRITICAL logging levels 🤫 (environment variable: PIP_QUIET)
• --log <path> — path to a verbose appending log 🪵 (environment variable: PIP_LOG, PIP_LOG_FILE, PIP_LOCAL_LOG)
• --no-input — disable prompting for input 🙅‍♀️ no questions, no pop-ups, nothing. (environment variable: PIP_NO_INPUT)
• --keyring-provider <keyring_provider> — enable the credential lookup via the keyring library if user input is allowed. specify which mechanism to use [auto, disabled, import, subprocess]. (default: auto) 🔑 (environment variable: PIP_KEYRING_PROVIDER)
• --proxy <proxy> — specify a proxy in the form scheme://[user:passwd@]proxy.server:port. 🌐 (environment variable: PIP_PROXY)
• --retries <retries> — maximum attempts to establish a new HTTP connection. (default: 5) 🔁 (environment variable: PIP_RETRIES)
• --timeout <sec> — set the socket timeout (default 15 seconds). ⏳ (environment variable: PIP_TIMEOUT, PIP_DEFAULT_TIMEOUT)
• --exists-action <action> — default action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort. 💀 pick your fighter. (environment variable: PIP_EXISTS_ACTION)
• --trusted-host <hostname> — mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS 🫶 (environment variable: PIP_TRUSTED_HOST)
• --cert <path> — path to PEM-encoded CA certificate bundle. if provided, overrides the default. see 'SSL Certificate Verification' in pip documentation for more information 📜 (environment variable: PIP_CERT)
• --client-cert <path> — path to SSL client certificate, a single file containing the private key and the certificate in PEM format 🎀 (environment variable: PIP_CLIENT_CERT)
• --cache-dir <dir> — store the cache data in <dir>. 🗂️ (environment variable: PIP_CACHE_DIR)
• --no-cache-dir — disable the cache. 🙈 (environment variable: PIP_NO_CACHE_DIR)
• --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. ⭐ (environment variable: PIP_DISABLE_PIP_VERSION_CHECK)
• --no-color — suppress colored output 🌈➡️🚫 (environment variable: PIP_NO_COLOR)
• --use-feature <feature> — enable new functionality, that may be backward incompatible ⚠️ (environment variable: PIP_USE_FEATURE)
• --use-deprecated <feature> — enable deprecated functionality, that will be removed in the future 💀 (environment variable: PIP_USE_DEPRECATED)
• --resume-retries <resume_retries> — maximum attempts to resume or restart an incomplete download. (default: 0) 🔄 (environment variable: PIP_RESUME_RETRIES)

ok lowkey the --use-deprecated one is literally telling you it's going away. use it and enjoy it while it lasts bestie, but don't build your whole life on it 💅

---

👑 COMMANDS 👑

these are the ones you actually call, each one has its own page 🎀

• pip-install(1) — install packages. 📦
• pip-download(1) — download packages. ⬇️
• pip-uninstall(1) — uninstall packages. 🗑️
• pip-freeze(1) — output installed packages in requirements format. 🧊
• pip-lock(1) — generate a lock file for requirements and their dependencies. 🔒
• pip-list(1) — list installed packages. 📋
• pip-show(1) — show information about installed packages. 🔍
• pip-check(1) — verify installed packages have compatible dependencies. ✅
• pip-search(1) — search PyPI for packages. 🕵️‍♀️
• pip-wheel(1) — build wheels from your requirements. 🛞
• pip-hash(1) — compute hashes of package archives. #️⃣
• pip-help(1) — show help for pip commands. 🫶

---

🌈 AUTHOR 🌈

pip developers 👑 (they ate, honestly)

---

💜 COPYRIGHT 💜

The pip developers

---

and that's the whole page bestie, you're officially pip-literate 🎓✨

cute little sign-off: this was version 25.1, dated Jun 26, 2025 — pip manual page, PIP(1) 🌸 go install something iconic, ily, bye 🫶💅