ERROR pip install_error ai_generated true

ERROR: <package>.whl is not a supported wheel on this platform. It is not compatible with this Python interpreter or platform.

ID: pip/wheel-manylinux-incompatible

Also available as: JSON · Markdown · 中文
92%Fix Rate
85%Confidence
1Evidence
2023-03-15First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
pip 21.0 active — — —
pip 23.0 active — — —
pip 24.0 active — — —

Root Cause

The wheel file's platform tag (e.g., manylinux2014_x86_64) does not match the user's system architecture or Python version, often due to downloading a wheel for a different OS or Python ABI.

generic

中文

wheel 文件的平台标签（例如 manylinux2014_x86_64）与用户系统架构或 Python 版本不匹配，通常是因为下载了针对不同操作系统或 Python ABI 的 wheel。

Official Documentation

https://pip.pypa.io/en/stable/cli/pip_install/#wheel-support

Workarounds

  1. 90% success Install the source distribution instead: `pip install <package> --no-binary :all:` 
    Install the source distribution instead: `pip install <package> --no-binary :all:`
  2. 85% success Download the correct wheel for your platform: check Python version (e.g., `python3 -c 'import sys; print(sys.version)'`) and platform (`uname -m`), then find compatible wheel at https://pypi.org/project/<package>/#files 
    Download the correct wheel for your platform: check Python version (e.g., `python3 -c 'import sys; print(sys.version)'`) and platform (`uname -m`), then find compatible wheel at https://pypi.org/project/<package>/#files
  3. 75% success Use `pip install <package>==version --only-binary=:all:` with `--platform` and `--python-version` flags if cross-compiling: `pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310` 
    Use `pip install <package>==version --only-binary=:all:` with `--platform` and `--python-version` flags if cross-compiling: `pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`

中文步骤

  1. 改为安装源码发行版：`pip install <package> --no-binary :all:`
  2. 下载适合你平台的 wheel：检查 Python 版本（`python3 -c 'import sys; print(sys.version)'`）和架构（`uname -m`），然后在 https://pypi.org/project/<package>/#files 找到兼容的 wheel
  3. 使用 `--platform` 和 `--python-version` 标志进行交叉编译：`pip install <package> --platform manylinux2014_x86_64 --python-version 3.10 --implementation cp --abi cp310`

Dead Ends

Common approaches that don't work:

  1. Re-download the same wheel file from PyPI manually. 95% fail

    The wheel file itself is correct; the issue is platform incompatibility, not file corruption.

  2. Use --no-index and point to a local wheelhouse without checking tags. 80% fail

    pip still validates platform tags even with --no-index; this flag only skips index lookup.

  3. Force install with --force-reinstall ignoring warnings. 100% fail

    pip will abort with an error; --force-reinstall does not bypass platform tag checks.