# ERROR: To modify pip, please run the following command:
/home/user/venv/bin/python -m pip install --upgrade pip

- **ID:** `python/pip-install-requires-pip-version`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

pip refuses to upgrade itself via `pip install --upgrade pip` when it detects the running pip is in a location where self-modification is unsafe; it directs you to use `python -m pip` instead.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   Run pip as a module: python -m pip install --upgrade pip
   ```
2. **** (90% success)
   ```
   Upgrade in a fresh venv: python -m venv .venv && . .venv/bin/activate && python -m pip install --upgrade pip
   ```

## Dead Ends

- **** — Force-reinstall still routes through the same self-modification guard and prints the identical refusal. (70% fail)
- **** — Privilege escalation doesn't lift the guard and may install a second pip into a different site-packages, causing version confusion. (75% fail)