目次

2026年11月13日、Georgi Gerganov 氏率いる ggml-org チームは、llama.cpp v1.0.0 と基盤テンソルライブラリ ggml v1.0.0 を正式にリリースした。過去3年半にわたり、150種以上のモデルアーキテクチャを支えるローカル推論の事実上の標準基盤へと成長した同プロジェクトだが、これまではコミットごとの連番(b12374 まで)のみで管理されており、正式なセマンティックバージョニングは導入されていなかった。

v1.0.0 の最大の意義は、新機能の追加以上に「開発者への互換性契約」を明文化した点にある。今後 libllama(llama.cpp/include/)と libggml(ggml/include/)の公開 C API およびバイナリインターフェース(ABI)における破壊的変更は、メジャーバージョンアップ(MAJOR)時に限定される。

ローカルAIエコシステムにとって C API / ABI 安定性が重要な理由

従来のビルド番号制では、新モデル対応の裏で関数削除や構造体レイアウトの変更が頻繁に発生し、下流プロジェクトに大きな保守負担を強いていた。

特定コミット固定(コミットピン留め)からの解放:Python・Rust・Go・Node などの言語バインディングや、Ollama・LM Studio といったデスクトップアプリは、これまで特定のコミットハッシュに依存関係を固定し、数週間ごとにまとめて移植作業を行う必要があった。v1.0.0 以降は ^1.0.0 のバージョン指定により、1.x 系の新モデル追加(MINOR)やバグ修正(PATCH)を既存コードの書き換えなしで取り込めるようになる。

動的ハードウェアバックエンドの独立更新:CUDA、Metal、Vulkan、ROCm、OpenVINO、SYCL、Qualcomm Hexagon などの計算バックエンドを実行時に動的ライブラリとして読み込む設計において、ABI が固定されることでバックエンド単位の独立したアップデートが容易になる。

図 1 llama.cpp と ggml v1.0.0 のセマンティックバージョニング規則および C API / ABI 境界
図 1 llama.cpp と ggml v1.0.0 のセマンティックバージョニング規則および C API / ABI 境界

画像の出典:ggml-org 公式ブログおよび GitHub v1.0.0 リリースノートをもとに DigIntoAI が作成。

b12374 以前から v1.0.0 へ移行する際の確認ポイント

35個の非推奨関数と旧ヘッダの整理:v1.0.0 では llama.h から llama_set_warmup を含む35個の非推奨関数と defrag_thold が削除され、NextN 投机デコーディング API が llama.h へ正式昇格した。また clip.h が廃止され、マルチモーダル基盤は mtmd へ統合されている。

公式パッケージ配布チャネルの活用:Homebrew、Winget、Debian、conda-forge、MacPorts、Docker、iOS/macOS 向け XCFramework などの公式配布経路が整備され、アプリ側での独自クロスビルド負担が軽減される。

llama-server のセキュリティ規定変更に注意:CORS 検証や DNS リバインディング・SSRF 対策が強化され、HF_TOKEN の送信先も huggingface.co に限定された。未認証のツール実行を利用している場合は --allow-unauthenticated-tools の明示的な指定が必要となる。

図 2 ビルド番号時代から llama.cpp v1.0.0 へ移行する際の開発者別アップグレード指針
図 2 ビルド番号時代から llama.cpp v1.0.0 へ移行する際の開発者別アップグレード指針

画像の出典:llama.cpp v1.0.0 のヘッダおよびサーバー変更履歴をもとに DigIntoAI が作成。

対象外事項および運用上の注意点

保証対象は公開 C ヘッダのみ:セマンティックバージョニングの互換保証は llama.cpp/include/ と ggml/include/ の公開 C API に適用される。内部の非公開ヘッダや CLI の標準出力テキストの解析に依存する実装は引き続き影響を受ける可能性があるため、本番環境では公開 C API または OpenAI 互換 HTTP エンドポイント経由での連携が推奨される。

未検証事項:本解説は ggml-org 公式ドキュメントおよび v1.0.0 リリースノートに基づく整理であり、複数 GPU ベンダー環境でのマイナーバージョン間バイナリ差し替え検証は未実施である。