python install_error ai_generated true

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

ID: python/pip-requires-python-version-mismatch

Also available as: JSON · Markdown · 中文
80%Fix Rate
90%Confidence
0Evidence
2024-05-02First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.8 active — — —
3.9 active — — —
3.10 active — — —
3.11 active — — —

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.

generic

中文

该包的 pyproject.toml 中声明的 requires-python 最低版本高于当前运行的 Python 解释器版本，因此 pip 拒绝安装。

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

Common approaches that don't work:

  1. 65% fail

    Bypasses the check but the package often uses syntax/APIs unavailable on the older interpreter, causing runtime failures.

  2. 55% fail

    Older releases may have unrelated bugs or missing security patches, and the user still needs the new features.