目次

llama.cppとそのテンソルライブラリggmlは、2026年11月13日にバージョン1.0.0をリリースし、公開APIまたはABIに互換性のない変更を加える場合はメジャーバージョンを更新するという明確なルールを設けました。このリリースでは非推奨の関数も削除されるため、いずれかのライブラリを組み込んでいる開発者は、アップグレード前に既存の呼び出しを確認する必要があります。

要点#

  • libllamaとlibggmlはともに、メジャー、マイナー、パッチの各バージョン番号で、更新が互換性に与える影響を示すようになりました。
  • バージョン1.0.0では、llama.hの非推奨関数35個に加え、llama_set_warmupなども削除されます。
  • llama-serverには音声合成用の/v1/audio/speechエンドポイントが追加され、Web UIには名前付きチャットグループと入力プレビュー付きMarkdownエディターが加わります。
  • バージョニング方針はアップグレードのリスク評価に役立ちますが、アプリケーションには引き続き、実際に使うモデルとハードウェアでのテストが必要です。

バージョン番号の意味#

1.0.0で最も有用な変更は、libllamaまたはlibggmlに依存するアプリケーション向けの互換性方針です。バージョン番号によって、更新が公開された連携仕様を変更するかどうかを保守担当者が判断できるようになります。

発表されたルールでは、major.minor.patch形式を使用します。

| バージョンの区分 | 示す変更 | |---|---| | メジャー | 公開APIまたはABIの互換性を損なう変更 | | マイナー | 後方互換性のある機能やAPIの追加、バックエンドの更新、モデル対応 | | パッチ | APIを変更しないバグ修正 |

これにより、依存関係の更新を検討する際の出発点が明確になります。メジャーアップデートでは、移行に必要な作業の確認が求められます。マイナーやパッチの更新は、明示された変更範囲がより限定的ですが、個々のアプリケーションへの影響は引き続き検証が必要です。

APIとABIの両方が重要な理由#

APIは、アプリケーションのコードがライブラリを呼び出す方法を定義します。関数が削除されると、再びコンパイルできるようにコードの変更が必要になる場合があります。ABIは、コンパイル済みバイナリのレベルでの互換性を定義します。破壊的変更によって、そのライブラリにリンクするソフトウェアの再ビルドが必要になる場合があります。

これらのライブラリを含むアプリケーションを配布するチームにとって、この違いは重要です。ソースコードのコンパイルが成功することの確認と、パッケージ化したアプリケーションが想定するライブラリのビルドを使って読み込まれ、動作することの確認は別です。

発表された方針の対象は、libllamaとlibggmlの公開APIとABIです。同じメジャーバージョン内で、llama-serverやそのWeb UI、モデル実行のあらゆる側面が変わらないという包括的な保証として捉えるべきではありません。

アップグレード前に確認すること#

バージョン1.0.0にはAPIの整理が含まれます。公開ヘッダーのllama.hから非推奨関数35個が削除され、発表ではllama_set_warmupも削除対象に挙げられています。削除された関数をまだ呼び出しているアプリケーションには、移行作業が必要です。

このリリースを採用する前に、次の4点を確認してください。

1. アプリケーションとバインディングのコードで、llama_set_warmupを含む非推奨のllama.h関数の呼び出しを検索します。 2. それらの呼び出しを1.0.0のヘッダーやリリース文書と照合し、サポートされている代替手段を特定します。 3. 使用予定のlibllamaとlibggmlのバージョンに合わせて、アプリケーションとバインディングを再ビルドします。 4. 実際に運用するモデルとハードウェアで、代表的な推論ワークロードを実行します。

提示された発表には、削除された関数の完全な置き換え対応表はありません。呼び出しを変更する前にリリース文書を確認し、名前が似た関数でも動作が同じだとは想定しないでください。

サーバーとWeb UIへの追加#

llama-serverの利用者にとって、主な追加機能は音声合成用エンドポイントの/v1/audio/speechです。アプリケーションで音声出力が必要なら、具体的な評価対象になります。ただし、エンドポイントが存在するだけでは、どのモデル、リクエストオプション、デプロイ構成が要件を満たすかは分かりません。

Web UIには、チャットを整理するための名前付きグループと、チャット入力をプレビューできるMarkdownエディターという2つの作業支援機能が追加されます。これらは、付属のインターフェースを使う人に直接役立つ変更です。

ライブラリの移行とサーバー機能の評価は、別々に確認してください。ライブラリを組み込んだアプリケーションの再ビルドが成功しても、音声合成との連携が検証されたことにも、更新されたインターフェースが既存の作業手順に適していることの確認にもなりません。

引き続き検証が必要なこと#

開発チームは、Hugging Faceのサービスとハードウェアベンダーの支援を活用し、主要なハードウェアプラットフォーム全体で自動テストを拡充しているとしています。この投資は、幅広いハードウェアに対応するプロジェクトの保守を支えますが、すべての利用先の構成で結果を保証できるわけではありません。

発表では、1.0.0で全般的に速度やメモリ使用量が改善したとは示されていません。互換性への影響が分かることを、このリリースの運用上の主な利点と捉え、性能がアップグレードの判断に影響する場合は別途測定してください。

次のステップ#

依存関係を更新する前に、アプリケーションの呼び出しをllama.cpp 1.0.0の公開ヘッダーと照合し、置き換えが必要な削除済み関数をすべて記録してください。

出典: https://gihyo.jp/article/2026/11/llama.cpp-v1.0.0

目次