# ERROR: Package 'foo' requires a different Python: 3.9.18 not in '>=3.10'

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

## Root Cause

The package's pyproject.toml declares requires-python with a minimum version greater than the running interpreter, so pip refuses to install it.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   pyenv install 3.10.13 && pyenv local 3.10.13
python -m venv .venv && source .venv/bin/activate
pip install foo
   ```
2. **** (93% success)
   ```
   Use uv or conda to create an env with the required Python:
uv venv --python 3.10 && uv pip install foo
   ```

## Dead Ends

- **** — Bypasses the check but the package often uses syntax/APIs unavailable on the older interpreter, causing runtime failures. (65% fail)
- **** — Older releases may have unrelated bugs or missing security patches, and the user still needs the new features. (55% fail)