# ERROR: Invalid wheel filename: my_package-1.0-py3-none-any.whl

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

## Root Cause

The wheel file's name does not follow the PEP 427 naming convention (e.g., missing version or tag separators).

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.7 | active | — | — |
| 3.8 | active | — | — |
| 3.9 | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   python setup.py bdist_wheel --universal  # ensures proper naming
   ```
2. **** (75% success)
   ```
   pip install --no-use-pep517 /path/to/my_package-1.0-py3-none-any.whl
   ```

## Dead Ends

- **** — If the internal metadata doesn't match, pip may reject it after download. (40% fail)
- **** — Doesn't address the filename issue; the error persists. (95% fail)