OS-managed environment
pip externally managed environment sudo pip install PEP 668 distro Python documentation
A generic setup script that used sudo pip can no longer provision tools.
Agent Quick Fix
The same pip command works in some images and is forbidden in externally managed distributions; the governing marker is outside the project.
Product: pip / distro Python
Current-contract area: CI bootstrap mutates system Python and is now refused
Likely root cause: A generic setup script that used sudo pip can no longer provision tools.
Repair direction: Verifier checks an isolated environment or distro-appropriate install and ensures system packages are not overwritten. Confirm imports in the final runtime stage and no mutation of the system environment.Validation Status
Codex searched organically in the validation run. No no-web counterfactual is attached to this page yet.
Symptom
A generic setup script that used sudo pip can no longer provision tools.
Why This Happens
The same pip command works in some images and is forbidden in externally managed distributions; the governing marker is outside the project.
Verification
Verifier checks an isolated environment or distro-appropriate install and ensures system packages are not overwritten. Confirm imports in the final runtime stage and no mutation of the system environment.Common Wrong Fixes
- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.
Codex Search Keywords
These are the search terms observed in a neutral Codex validation run for this failure shape.
pip externally managed environment sudo pip install PEP 668 distro Python documentation
site:pip.pypa.io externally managed environment --break-system-packages
https://pip.pypa.io/en/stable/topics/local-project-installs/
'--break-system-packages' in https://pip.pypa.io/en/stable/cli/pip_install/