PIP(1)

💖 PIP(1) 💖

okay bestie, welcome to pip — that's the package manager for Python packages, and yes it's the one the PyPA recommends so you KNOW it's the real deal 👑

---

✨ NAME ✨

pip — the package manager for Python packages, your ride-or-die for installing literally everything 🎀

---

✨ SYNOPSIS ✨

pip <command> [options]

that's it. that's the whole vibe. a command, then options, then slay 💅

---

✨ DESCRIPTION ✨

okay so, pip is the PyPA recommended package manager for Python packages. The PyPA said it, not me. That's the official word, periodt 🫶

---

✨ OPTIONS ✨

here's where it gets juicy. every single flag, no gatekeeping, fr fr 🌸

• -h, --help — show help. that's the whole thing. (environment variable: PIP_HELP)
• --debug — lets unhandled exceptions just propagate outside the main subroutine instead of getting logged to stderr. it's giving chaos but on purpose 😭 (environment variable: PIP_DEBUG)
• --isolated — runs pip in an isolated mode, ignoring environment variables AND user configuration. main character energy, no outside opinions 💅 (environment variable: PIP_ISOLATED)
• --require-virtualenv — makes pip only run inside a virtual environment, and it exits with an error otherwise. no venv, no service bestie 🙈 (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. it's additive, so you can stack it up to 3 times 🔥 (environment variable: PIP_VERBOSE)
• -V, --version — show version and exit. quick little flex. (environment variable: PIP_VERSION)
• -q, --quiet — give less output. also additive, usable up to 3 times, which corresponds to the WARNING, ERROR, and CRITICAL logging levels. shhh 🤫 (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. (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. trust, but like, knowingly 🫣 (environment variable: PIP_TRUSTED_HOST)
• --cert <path> — path to a PEM-encoded CA certificate bundle. if provided, it overrides the default. see 'SSL Certificate Verification' in the pip documentation for more info. (environment variable: PIP_CERT)
• --client-cert <path> — path to an 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. bye cache 👋 (environment variable: PIP_NO_CACHE_DIR)
• --disable-pip-version-check — don't periodically check PyPI to figure out whether a new version of pip is available for download. this one is implied with --no-index. (environment variable: PIP_DISABLE_PIP_VERSION_CHECK)
• --no-color — suppress colored output. sad beige terminal 😔 (environment variable: PIP_NO_COLOR)
• --use-feature <feature> — enable new functionality that may be backward incompatible. living on the edge, iconic. (environment variable: PIP_USE_FEATURE)
• --use-deprecated <feature> — enable deprecated functionality that will be removed in the future. ⚠️ careful bestie, this one's on the way out. (environment variable: PIP_USE_DEPRECATED)
• --resume-retries <resume_retries> — maximum attempts to resume or restart an incomplete download. (default: 5) (environment variable: PIP_RESUME_RETRIES)

---

✨ COMMANDS ✨

these are the sub-commands, each with their own man page, and honestly the whole squad ate 🍓

• pip-install(1) — install packages. the classic.
• pip-download(1) — download packages.
• pip-uninstall(1) — uninstall packages. sometimes you gotta let go 💔
• pip-freeze(1) — output installed packages in requirements format.
• pip-lock(1) — generate a lock file for requirements and their dependencies. so secure 🔒
• 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. when in doubt 🧚

---

✨ Author ✨

pip developers 💜

---

✨ Copyright ✨

The pip developers 🌈

---

okay that's the whole page bestie, go forth and install responsibly 🦋

version 26.0, dated Aug 26, 2026 — mwah, love u, bye 💖✨👑