PIP-DOWNLOAD(1)                       pip                      PIP-DOWNLOAD(1)

NAME
       pip-download - description of pip download command

DESCRIPTION
       Download packages from:

       o PyPI (and other indexes) using requirement specifiers.

       o VCS project urls.

       o Local project directories.

       o Local or remote source archives.

       pip also supports downloading from "requirements files", which provide
       an easy way to specify a whole environment to be downloaded.


USAGE

          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

       -c, --constraint <file>
              Constrain versions using the given constraints file. This option
              can be used multiple times.

              (environment variable: PIP_CONSTRAINT)

       --build-constraint <file>
              Constrain build dependencies using the given constraints file.
              This option can be used multiple times.

              (environment variable: PIP_BUILD_CONSTRAINT)

       -r, --requirement <file>
              Install from the given requirements file. This option can be
              used multiple times.

              (environment variable: PIP_REQUIREMENT)

       --requirements-from-script <file>
              Install dependencies of the given script fileas defined by PEP
              723 inline metadata.

              (environment variable: PIP_REQUIREMENTS_FROM_SCRIPT)

       --no-deps
              Don't install package dependencies.

              (environment variable: PIP_NO_DEPS, PIP_NO_DEPENDENCIES)

       --src <dir>
              Directory to check out editable projects into. The default in a
              virtualenv is "<venv path>/src". The default for global installs
              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. 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. [auto, on, off, raw]
              (default: auto)

              (environment variable: PIP_PROGRESS_BAR)

       --no-build-isolation
              Disable isolation when building a modern source distribution.
              Build dependencies specified by PEP 518 must be already
              installed if this option is used.

              (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. The version can be
              specified 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. 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

Copyright
       The pip developers

26.0                           February 5, 2026                PIP-DOWNLOAD(1)