vllm - 💡(How to fix) Fix [v0.20.0] cp38-abi3 wheels contains cp312 bindings [2 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vllm-project/vllm#41487Fetched 2026-05-02 05:27:50
View on GitHub
Comments
2
Participants
2
Timeline
5
Reactions
0
Author
Participants
Timeline (top)
commented ×2labeled ×1mentioned ×1subscribed ×1

Code Example

$ unzip -v vllm-0.20.0-cp38-abi3-manylinux_2_35_x86_64.whl | grep cpython
 1352656  Defl:N   483912  64% 04-27-2026 07:59 cdda9112  vllm/third_party/deep_gemm/_C.cpython-312-x86_64-linux-gnu.so
RAW_BUFFERClick to expand / collapse

Your current environment

Version 0.20.0 PyPI wheels.

🐛 Describe the bug

The pre-built wheel on PyPI is tagged cp38-abi3 and contains

$ unzip -v vllm-0.20.0-cp38-abi3-manylinux_2_35_x86_64.whl | grep cpython
 1352656  Defl:N   483912  64% 04-27-2026 07:59 cdda9112  vllm/third_party/deep_gemm/_C.cpython-312-x86_64-linux-gnu.so

which will break if one use python 3.8-3.11, 3.13-3.14 and deep-gemm.

This wheel only correctly works for Python 3.12. Or that SO is mistagged and should be abi3?

Alternatively, one can build from source with the desired cpython version.

Before submitting a new issue...

  • Make sure you already searched for relevant issues, and asked the chatbot living at the bottom right corner of the documentation page, which can answer lots of frequently asked questions.

extent analysis

TL;DR

The pre-built wheel on PyPI is incorrectly tagged as cp38-abi3 and only works with Python 3.12, so a new wheel should be built with the correct ABI tag or from source for other Python versions.

Guidance

  • Verify the Python version being used and check if it matches the expected version for the pre-built wheel.
  • Consider building the wheel from source with the desired Python version to ensure compatibility.
  • Check the ABI tag of the pre-built wheel and ensure it matches the expected ABI for the Python version being used.
  • If using a version of Python other than 3.12, try building from source or using a different wheel with the correct ABI tag.

Example

No code snippet is provided as the issue is related to wheel compatibility and ABI tags.

Notes

The issue is specific to the pre-built wheel on PyPI and its compatibility with different Python versions. Building from source or using a different wheel with the correct ABI tag may resolve the issue.

Recommendation

Apply workaround: Build the wheel from source with the desired Python version to ensure compatibility, as the pre-built wheel on PyPI is incorrectly tagged and only works with Python 3.12.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

vllm - 💡(How to fix) Fix [v0.20.0] cp38-abi3 wheels contains cp312 bindings [2 comments, 2 participants]