uv add llama-cpp-python wheels fails for versions above 0.3.30
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 65/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Quiet
- Tech stack
- macos, python
- Domain
- build-system, release
Research direction
The issue is about a corrupted wheel file for macOS arm64. Start by checking the wheel index at https://abetlen.github.io/llama-cpp-python/whl/metal. Download the failing wheel (llama_cpp_python-0.3.34-py3-none-macosx_11_0_arm64.whl) and run unzip -t on it to verify the bad entry. Compare with the working 0.3.30 wheel. The fix likely involves the release pipeline that builds the macOS metal wheels.
Written by the indexing model from the issue text.
Description
- OS: macOS (Darwin 25.5.0)
- Wheel index: https://abetlen.github.io/llama-cpp-python/whl/metal
- Failing wheel:
llama_cpp_python-0.3.34-py3-none-macosx_11_0_arm64.whl - Bundled file that fails to extract:
lib/libggml-base.0.16.0.dylib
$ python3 --version
Python 3.13.8
Failure Information (for bugs)
The wheel is a zip whose stored uncompressed size for lib/libggml-base.0.16.0.dylib disagrees with the actual data (got 000b08a5, expected 000b0798), so strict extractors reject it. The failure happens purely at archive extraction, before anything is imported or run, which points at the release pipeline that built or uploaded the macOS arm64 metal wheels rather than at any local setup. Running unzip -t on the downloaded wheel should surface the same bad entry.
Steps to Reproduce
- On an Apple Silicon Mac, add the metal wheel index:
https://abetlen.github.io/llama-cpp-python/whl/metal - Ask for the metal build of
0.3.34, e.g.pip install "llama-cpp-python==0.3.34" --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/metal - Installation fails while extracting
lib/libggml-base.0.16.0.dylibwith a bad-uncompressed-size error. - Pinning to
0.3.30from the same index installs and runs without issue.
pyproject.toml
[[tool.uv.index]]
name = "llama-metal"
url = "https://abetlen.github.io/llama-cpp-python/whl/metal"
explicit = true
[[tool.uv.index]]
name = "llama-cpu"
url = "https://abetlen.github.io/llama-cpp-python/whl/cpu"
explicit = true
[tool.uv.sources]
llama-cpp-python = [
{ index = "llama-metal", marker = "sys_platform == 'darwin' and platform_machine == 'arm64'" },
{ index = "llama-cpu", marker = "sys_platform != 'darwin' or platform_machine != 'arm64'" },
]
Failure Logs
× Failed to download `llama-cpp-python==0.3.34`
├─▶ Failed to extract archive: llama_cpp_python-0.3.34-py3-none-macosx_11_0_arm64.whl
╰─▶ Bad uncompressed size (got 000b08a5, expected 000b0798) for file: lib/libggml-base.0.16.0.dylib
Suggested check: re-verify the macOS arm64 metal wheels for 0.3.33 and 0.3.34 with unzip -t (or any strict zip reader) and rebuild/reupload them. The CPU wheels and 0.3.30 are unaffected.
- Dominant language
- Python
- Stars
- 10.6k
- Forks
- 1.5k
- Avg merge
- 6h 43m
- Merged PRs (30d)
- 2
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from abetlen/llama-cpp-python
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
abetlen/llama-cpp-python#2371 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
abetlen/llama-cpp-python#2211 · 2 comments ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
abetlen/llama-cpp-python#2210 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
abetlen/llama-cpp-python#2145 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 75/100
abetlen/llama-cpp-python#2135 · 4 reactions ·
All issues in abetlen/llama-cpp-python
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
learningequality/ricecooker#747 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
BSData/horus-heresy-3rd-edition#3171 ·
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
run-llama/llama_index#23199 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
KhronosGroup/glTF-Blender-IO#2769 ·