pip index versions: List Available Versions

See which versions of a package an index actually offers.

pip index versions queries an index and lists the versions available for a package. It is the fastest way to confirm whether the version your resolver wants even exists.

What it does

Prints the available versions of a package from the configured index, plus the latest and installed versions. The subcommand is marked experimental, so its output format may change.

Common usage

Terminal

pip index versions requests
pip index versions --pre django
pip index versions -i https://pypi.example.com/simple internal-lib

Common CI use: debug a missing version

When install fails with "no matching distribution", run pip index versions to see what the index actually has - often the pin targets a yanked version or a wrong private index.

Terminal

# Confirm what the index offers:
pip index versions internal-lib -i https://pypi.example.com/simple

Related guides

pip "Could not find a version that satisfies the requirement"Fix pip "Could not find a version that satisfies the requirement" / "No matching distribution found" in CI -… pip "No matching distribution found for X" in CIFix pip "ERROR: No matching distribution found for X" in CI - pip reached an index but found no release match… pip config: Manage pip Settings in CIHow pip config sets, lists, and edits pip settings like index URLs and timeouts, where the config files live,…