python data_error ai_generated true

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

ID: python/pip-invalid-wheel-filename

Also available as: JSON · Markdown · 中文
80%Fix Rate
82%Confidence
0Evidence
2024-04-02First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.7 active — — —
3.8 active — — —
3.9 active — — —

Root Cause

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

generic

中文

wheel 文件名不符合 PEP 427 命名约定（例如缺少版本或标签分隔符）。

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

Common approaches that don't work:

  1. 40% fail

    If the internal metadata doesn't match, pip may reject it after download.

  2. 95% fail

    Doesn't address the filename issue; the error persists.