# 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`
- **Domain:** pip
- **Category:** install_error
- **Error Code:** `ERROR`
- **Verification:** ai_generated
- **Fix Rate:** 92%

## 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.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| pip 21.0 | active | — | — |
| pip 23.0 | active | — | — |
| pip 24.0 | active | — | — |

## Workarounds

1. **Install the source distribution instead: `pip install <package> --no-binary :all:`** (90% success)
   ```
   Install the source distribution instead: `pip install <package> --no-binary :all:`
   ```
2. **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** (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
   ```
3. **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`** (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`
   ```

## Dead Ends

- **Re-download the same wheel file from PyPI manually.** — The wheel file itself is correct; the issue is platform incompatibility, not file corruption. (95% fail)
- **Use --no-index and point to a local wheelhouse without checking tags.** — pip still validates platform tags even with --no-index; this flag only skips index lookup. (80% fail)
- **Force install with --force-reinstall ignoring warnings.** — pip will abort with an error; --force-reinstall does not bypass platform tag checks. (100% fail)