pip check: Verify Dependencies Command Reference

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 the installer left in place.

Common flags / usage

pip check -- scan the installed set for missing or conflicting deps
exit 0 -- no problems found
exit 1 -- at least one conflict reported (fails a strict step)

Example

shell

- run: pip install -r requirements.txt
- run: pip check

In CI

pip check exits non-zero and names the incompatible packages (for example "botocore requires urllib3<1.27, but you have urllib3 2.2.1"). Pin a compatible version of the offending dependency and re-run.

Key takeaways

pip check finds missing dependencies and version conflicts in the installed set.
It exits non-zero on any conflict, so it works as a CI assertion.
Resolve a reported clash by pinning a compatible version.

Related guides

pip list: Inspect Installed Packages Command ReferenceReference for pip list in CI: showing installed packages and versions, --outdated and --format=json for scrip… pip install -r requirements.txt: Command ReferenceReference for pip install -r requirements.txt in CI: installing a whole dependency file, hashed installs, con… pip freeze: Pin the Environment Command ReferenceReference for pip freeze in CI: snapshotting installed versions into requirements.txt, excluding editable/VCS…