# ERROR: package-1.0.0-py3-none-any.whl is not a valid wheel filename.

- **ID:** `python/pip-install-error-invalid-wheel`
- **Domain:** python
- **Category:** data_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The wheel file does not conform to the PEP 427 naming convention, causing pip to reject it.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   pip download package --only-binary :all:
   ```
2. **** (85% success)
   ```
   pip wheel package --no-binary :all:
   ```
3. **** (80% success)
   ```
   Ensure the format is {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl
   ```

## Dead Ends

- **** — Renaming alone may not fix internal metadata mismatches. (70% fail)
- **** — Force reinstall does not bypass filename validation. (95% fail)
- **** — Newer pip still enforces valid wheel filenames. (90% fail)