# ERROR: foo-1.2.3-cp311-cp311-win_amd64.whl is not a supported wheel on this platform.

- **ID:** `python/pip-wheel-not-supported-on-this-platform`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The wheel's platform/ABI tag does not match the current interpreter (e.g., a Windows wheel on Linux, or cp311 wheel on cp310).

## Version Compatibility

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

## Workarounds

1. **** (95% success)
   ```
   Download the wheel matching your platform:
  pip download --only-binary=:all: --platform manylinux2014_x86_64 --python-version 311 --abi cp311 foo
Or simply: pip install foo (pip picks the right wheel).
   ```
2. **** (70% success)
   ```
   Build from source if no matching wheel exists:
  pip install --no-binary=:all: foo
(requires a compiler toolchain).
   ```

## Dead Ends

- **** — Force-reinstall does not change the platform compatibility check. (95% fail)
- **** — Renaming breaks the internal RECORD and the wheel may still contain native code for the wrong platform. (90% fail)
