pip check: Verify Dependency Consistency

Catch incompatible dependency versions before they break at runtime.

pip check verifies that installed packages have compatible dependencies. It is a cheap CI gate against a broken dependency graph that pip’s installer left in place.

What it does

Scans the installed set for missing dependencies and version conflicts. It prints each problem and exits non-zero if any are found, making it usable as a CI assertion.

Common usage

Terminal

pip check

Common CI failure: reported conflict

pip check exits 1 and names the incompatible packages. Fix it by pinning a compatible version of the offending dependency, then re-run.

Terminal

# Output:
# botocore 1.34.0 has requirement urllib3<1.27, but
# you have urllib3 2.2.1.

# Fix: pin a compatible version
pip install "urllib3<1.27"
pip check

Related guides

pip list: Inspect Installed PackagesHow pip list shows installed packages and versions, the --outdated and --format flags useful in CI, and how t… pip show: Inspect One Package’s MetadataHow pip show displays a package’s version, location, dependencies, and requirements - plus the non-zero exit… 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 -…