# ERROR: foo-1.0-py3-none-any.whl is not a supported wheel on this platform.

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

## Root Cause

pip rejects a wheel whose tag does not match the current interpreter/platform. Often the wheel was built for a different Python ABI (e.g., cp311 on a cp312 interpreter) or the platform tag is incompatible (win_amd64 on linux).

## Version Compatibility

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

## Workarounds

1. **** (90% success)
   ```
   python -c 'import sys; print(sys.implementation.cache_tag)'
# download correct tag, e.g. cp312
pip download --only-binary=:all: --python-version 312 --platform manylinux2014_x86_64 foo
   ```
2. **** (75% success)
   ```
   pip install --no-binary foo foo
   ```

## Dead Ends

- **** — The filename tag is metadata only; the binary inside still targets another ABI and crashes at import with undefined symbols. (90% fail)
- **** — Force-reinstall does not bypass tag compatibility checks. (85% fail)