PIP-DOWNLOAD(1)

✨ NAME ✨

okay so this is pip-download, bestie — it's the manual page for the pip download command 💖

---

🦋 DESCRIPTION 🦋

so like, pip download is out here pulling packages for you, and it does it from so many places, no cap:

• PyPI (and other indexes too!) using requirement specifiers 💅
• VCS project urls
• Local project directories
• Local or remote source archives

and pip is ALSO not done — it supports downloading from "requirements files" too, which is literally the easiest way to name a whole entire environment and just download all of it at once. iconic behavior fr fr 🌸

---

🌈 USAGE 🌈

here's the vibe check on how you actually call it:

python -m pip download [options] <requirement specifier> [package-index-options] ...
python -m pip download [options] -r <requirements file> [package-index-options] ...
python -m pip download [options] <vcs project url> ...
python -m pip download [options] <local project path> ...
python -m pip download [options] <archive url/path> ...

---

💅 OPTIONS 💅

every single one, bestie, we're not skipping a thing:

• -c, --constraint <file> — constrain versions using the given constraints file. and yes, you can use this option multiple times 🎀
  • (environment variable: PIP_CONSTRAINT)
• --build-constraint <file> — constrain build dependencies using the given constraints file. also multiple times allowed, go off 💖
  • (environment variable: PIP_BUILD_CONSTRAINT)
• -r, --requirement <file> — install from the given requirements file. yep, this one can be used multiple times too ✨
  • (environment variable: PIP_REQUIREMENT)
• --requirements-from-script <file> — install dependencies of the given script file, as defined by PEP 723 inline metadata 👑
  • (environment variable: PIP_REQUIREMENTS_FROM_SCRIPT)
• --no-deps — don't install package dependencies. that's it, that's the whole thing 🙈
  • (environment variable: PIP_NO_DEPS, PIP_NO_DEPENDENCIES)
• --src <dir> — the directory to check out editable projects into. in a virtualenv the default is "<venv path>/src", and for global installs the default is "<current dir>/src" 🌸
  • (environment variable: PIP_SRC, PIP_SOURCE, PIP_SOURCE_DIR, PIP_SOURCE_DIRECTORY)
• --require-hashes — require a hash to check each requirement against, for repeatable installs. and lowkey important: this option is implied when any package in a requirements file has a --hash option 💀
  • (environment variable: PIP_REQUIRE_HASHES)
• --progress-bar <progress_bar> — specify whether the progress bar should be used. in 'auto' mode, --quiet will suppress all progress bars. the options are [auto, on, off, raw] (default: auto) ⭐
  • (environment variable: PIP_PROGRESS_BAR)
• --no-build-isolation — disable isolation when building a modern source distribution. heads up though: build dependencies specified by PEP 518 must already be installed if you use this option 🫶
  • (environment variable: PIP_NO_BUILD_ISOLATION)
• --check-build-dependencies — check the build dependencies 🎀
  • (environment variable: PIP_CHECK_BUILD_DEPENDENCIES)
• --ignore-requires-python — ignore the Requires-Python information 💜
  • (environment variable: PIP_IGNORE_REQUIRES_PYTHON)
• -d, --dest <dir> — download packages into <dir> 💖
  • (environment variable: PIP_DEST, PIP_DESTINATION_DIR, PIP_DESTINATION_DIRECTORY)
• --platform <platform> — only use wheels compatible with <platform>. defaults to the platform of the running system. use this option multiple times to specify multiple platforms supported by the target interpreter 🌈
  • (environment variable: PIP_PLATFORM)
• --python-version <python_version> — the Python interpreter version to use for wheel and "Requires-Python" compatibility checks. defaults to a version derived from the running interpreter. you can specify the version using up to three dot-separated integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). a major-minor version can also be given as a string without dots (e.g. "37" for 3.7.0) ✨
  • (environment variable: PIP_PYTHON_VERSION)
• --implementation <implementation> — only use wheels compatible with Python implementation <implementation>, e.g. 'pp', 'jy', 'cp', or 'ip'. if not specified, then the current interpreter implementation is used. use 'py' to force implementation-agnostic wheels 👑
  • (environment variable: PIP_IMPLEMENTATION)
• --abi <abi> — only use wheels compatible with Python abi <abi>, e.g. 'pypy_41'. if not specified, then the current interpreter abi tag is used. use this option multiple times to specify multiple abis supported by the target interpreter. and generally you will need to specify --implementation, --platform, and --python-version when using this option 🌸
  • (environment variable: PIP_ABI)
• --group <[path:]group> — install a named dependency-group from a "pyproject.toml" file. if a path is given, the name of the file must be "pyproject.toml". defaults to using "pyproject.toml" in the current directory 🎀
  • (environment variable: PIP_GROUP)
• --no-clean — don't clean up build directories 🧚
  • (environment variable: PIP_NO_CLEAN)

---

💖 Author 💖

pip developers — shoutout to the whole squad 🫶

🌟 Copyright 🌟

The pip developers

---

okay bestie that's a wrap on pip-download from the pip manual, version 26.0, dated Aug 26, 2026 💅 go download something cute, you've got this, periodt ✨🦋