Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

uv add llama-cpp-python wheels fails for versions above 0.3.30

Open Beginner friendly
#2,352 0 comments 0 reactions 0 assignees View on GitHub

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

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

$ 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

  1. On an Apple Silicon Mac, add the metal wheel index: https://abetlen.github.io/llama-cpp-python/whl/metal
  2. 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
  3. Installation fails while extracting lib/libggml-base.0.16.0.dylib with a bad-uncompressed-size error.
  4. Pinning to 0.3.30 from 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from abetlen/llama-cpp-python

All issues in abetlen/llama-cpp-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.