ローカル音声(llama.cpp)
gamedev pkg add aigd.llamacpp概要
llama.cppの音声ツールで、このコンピューター上でテキストを読み上げます。オフラインで動作し、利用枠も消費しません。NVIDIA、AMD、Intel、AppleのGPUまたはCPUで、ボイスライン、ナレーション、仮のセリフを生成できます。KokoroやChatterbox Turboなどのモデルは別パッケージです。
AI Game Devのローカル音声ランタイムです。llama.cppの音声ツール(llama-tts)を使って、このコンピューター上でテキストを読み上げます。処理はすべてお使いのコンピューター上でオフラインで行われ、AI Game Devの利用枠を一切消費しません。テキストをクラウドに送らずにボイスライン、ナレーション、仮のセリフを用意したいゲーム開発者に適しています。音声モデル自体(Kokoro 82MやChatterbox Turboなど)は別パッケージです。
できること
- NPCのセリフ、掛け声、チュートリアル、ナレーションを自分のコンピューターで音声化できます。
- プロトタイプの全セリフを、利用枠を使わずに、何度でもオフラインで下書きできます。
- NVIDIA、AMD、IntelのGPU、Appleシリコン、またはCPUで音声を実行できます。
リクエスト例
- 「このガードのセリフ5つをKokoroで自分のコンピューターで読み上げて、プロジェクトに保存して」
- 「チュートリアルのスクリプトをChatterbox Turboでローカルに音声化して」
- 「村人全員の仮のセリフをローカルの音声モデルで作って」
仕組み
このパッケージはデータのみで(aigd-package.json、コードは含みません)、お使いのコンピューターに合わせてどのllama.cppリリースをダウンロードするかをAI Game Devに伝えます。音声モデルは、他のローカル音声モデルと同様に、セッションのAudioツールを通して使用します。プログラムのダウンロード、検証、実行はアプリ自身が行います。音声1行につきllama-ttsを1回実行し、オフラインで動作するため、生成の合間にメモリに何も残りません。
設定(マシンごと):
| 設定 | 動作 |
|---|---|
backend | Autoがお使いのコンピューターに合わない場合に、CUDA(NVIDIA)、Vulkan(ほとんどのGPU)、Metal(Mac)、またはCPUを選択します。デフォルト: Auto。 |
newModelsDefault | 今後このランタイムの音声モデルをダウンロードしたときに、エージェントがそれを使用できるかどうか(デフォルトはallowed、またはblocked)。すでにダウンロード済みのモデルは、それぞれの設定を保持します。 |
モデルは別パッケージです
このパッケージにモデルは含まれていません。各音声モデルのパッケージ(tts-kokoro、tts-chatterbox-turbo)は、モデル本体とオーディオプロジェクターという2つのファイルを指定します。確認なしにダウンロードされることはなく、先にサイズとモデルのライセンスが表示されます。
eSpeakは使いません。llama.cppはKokoro用の英語テキストを、モデルファイルに格納された発音辞書を使って読み上げます。このパッケージはeSpeak-ngを同梱しておらず、呼び出すこともありません。
ダウンロードされるもの
タグで固定され、sha256で検証されるアップストリームのリリース: ggml-org/llama.cpp b12556(コミット50518b64c6f2191a116d2760042f106c4b3387d7)。アプリがお使いのコンピューターに合わせて1つのバリアントを選びます。
| バリアント | コンピューター | ダウンロード |
|---|---|---|
win-x64-cuda12 | Windows、NVIDIA GPU(ドライバー551.61以降) | 756 MB(プログラム + NVIDIA CUDA 12.4ランタイム) |
win-x64-vulkan | Windows、AMD / Intel / その他のGPU | 39 MB |
win-x64-cpu | サポート対象のGPUがないWindows | 25 MB |
darwin-arm64-metal | Appleシリコン搭載Mac、macOS 13.3以降 | 16 MB |
linux-x64-vulkan | Vulkan GPUを搭載したLinux x64、glibc 2.34およびlibstdc++ GLIBCXX_3.4.30以降(Ubuntu 22.04以降、Debian 12以降)。libgomp.so.1、OpenSSL 3(libssl.so.3、libcrypto.so.3)、libvulkan.so.1が必要です | 37 MB |
linux-x64-cpu | Linux x64、glibc 2.34およびGLIBCXX_3.4.30以降。libgomp.so.1とOpenSSL 3が必要です | 23 MB |
Linuxはプレビュー版です。llama.cppのLinux向けCUDAビルドはCUDAランタイムを別のフォルダーに置きますが、そのプログラムはそこを参照しないため、NVIDIA GPUを搭載したLinuxではVulkanバリアントが動作します。
動作要件
- WindowsビルドにはMicrosoft Visual C++ 2015–2022ランタイム(
MSVCP140.dll、VCRUNTIME140_1.dll)が必要です。ほとんどのWindows PCには既に入っていますが、アーカイブには同梱されていません。 - KokoroはCPUでも快適に動作するほど小さいモデルです。
- アプリがドライバーやシステムライブラリをインストールすることはありません。不足しているものがある場合は、何をインストールすべきかを案内します。
- AI Game Dev 0.32.0-beta.6以降。
ライセンス
- llama.cppおよびggml — MIT、© 2023-2026 The ggml authors(ライセンス)。
- LLVM OpenMPランタイム(
libomp.dll、Windowsバリアントに同梱)— Apache-2.0とLLVM例外(ライセンス)。アーカイブにはLICENSE-LLVM-OpenMPが含まれます。 - NVIDIA CUDAランタイム(cudart、cuBLAS、cuBLASLt、WindowsのCUDAバリアントのみ)— アップストリームによりNVIDIA CUDA EULAの下で再配布されています。
- このパッケージ — MIT。各モデルパッケージは独自のライセンスを明記しています。モデルの重みは元のリリースのライセンスを引き継ぎます。
制限: ファイルを共有する際にこれらの告知を保持すること以外にありません。
すべてのファイルはアップストリームのGitHubリリースからダウンロードされます。AI Game Devがそれらをホストしているわけではありません。
バージョン
| バージョン | リリース日 | アプリが必要 |
|---|---|---|
| 1.0.2最新 | 0.32.0-beta.6 以降 | |
| 1.0.1 | 0.32.0-beta.6 以降 |
インストール
デスクトップアプリで
Packages ウィンドウを開き(ステータスバーのパッケージアイコン)、Browse を選んで aigd.llamacpp を検索し、Add to Project をクリックします。
アプリがまだない方は、Windows、macOS、Linux 用の AI Game Dev を無料でダウンロードしてください。
ターミナルから
gamedev CLI を使い、プロジェクトフォルダーで実行します。
gamedev pkg add aigd.llamacpp必要条件
- AI Game Dev 0.32.0-beta.6 以降
gamedev pkg add aigd.llamacpp