b9987

ggml-org/llama.cppb9987Jul 13, 2026by github-actions[bot]same day as b9986

What changed since b9986

high risk

GGUF C API gains a tensor-shape accessor and drops the n_dims accessor, breaking code that used it.

Breaking changes

  • The `n_dims` accessor was removed from the GGUF API, so any code calling it will fail to compile against b9987.

New features

  • Added the `gguf_get_tensor_ne` accessor, which returns a tensor's shape as a `const int64_t *` for programmatic metadata inspection.

Improvements

  • Tensor shape retrieval was consolidated into a single accessor, simplifying the GGUF interface.
  • Existing GGUF model files remain readable; the change is API-level only, not a format change.

Upgrade notes

Only C/C++ consumers of the GGUF library are affected; replace any `n_dims`-based logic with `gguf_get_tensor_ne` and derive dimensionality from the returned shape pointer. CLI users and model files need no changes. Note that the chat-template reasoning-leak fix landed in b9986, so upgrading from b9986 to b9987 does not re-include it.

Analyzed Oct 24, 2026

Upgrading?

Release notes summary

This release adds a new accessor function to the GGUF library to retrieve tensor shapes, improving the ability to inspect model metadata programmatically. It also refactors the accessor interface by removing the deprecated `n_dims` accessor.

Key Highlights

  • Added `gguf_get_tensor_ne` accessor for tensor shapes
  • Removed `n_dims` accessor to streamline the API
  • Refactored tensor shape retrieval interface
  • Maintains compatibility with existing GGUF files

Release Notes (excerpt)

<details open> gguf : add tensor shape accessor (#24405) * gguf : add tensor shape accessors * gguf : return tensor shape as const int64_t * * gguf : remove n_dims accessor, keep only gguf_get_tensor_ne </details> **macOS/iOS:** - macOS Apple Silicon (arm64) - macOS Apple Silicon (arm64, KleidiAI enabled) DISABLED - macOS Intel (x64) - iOS XCFramework **Linux:** - Ubuntu x64 (CPU) - Ubuntu arm64 (CPU) - Ubuntu s390x (CPU) - Ubuntu x64 (Vulkan) - Ubuntu arm64 (Vulkan)…

Published by ggml-org on GitHub.

Read the full release notes

Related Repositories