# ローカル音声（llama.cpp）

> llama.cppの音声ツールで、このコンピューター上でテキストを読み上げます。オフラインで動作し、利用枠も消費しません。NVIDIA、AMD、Intel、AppleのGPUまたはCPUで、ボイスライン、ナレーション、仮のセリフを生成できます。KokoroやChatterbox Turboなどのモデルは別パッケージです。

- ID: `aigd.llamacpp`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: オーディオ
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 1.0.2 (公開日 2026-11-22)
- ライセンス: MIT
- AI Game Dev アプリが必要です: `>=0.32.0-beta.6`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.llamacpp

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.llamacpp
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.llamacpp` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 説明

````markdown
# ローカル音声（`aigd.llamacpp`）

AI Game Devのローカル音声ランタイムです。[llama.cpp](https://github.com/ggml-org/llama.cpp)の音声ツール（`llama-tts`）を使って、このコンピューター上でテキストを読み上げます。処理はすべてお使いのコンピューター上でオフラインで行われ、AI Game Devの利用枠を一切消費しません。テキストをクラウドに送らずにボイスライン、ナレーション、仮のセリフを用意したいゲーム開発者に適しています。音声モデル自体（[Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro)や[Chatterbox Turbo](https://ai-game.dev/packages/aigd.tts-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`](https://ai-game.dev/packages/aigd.tts-kokoro)、[`tts-chatterbox-turbo`](https://ai-game.dev/packages/aigd.tts-chatterbox-turbo)）は、モデル本体とオーディオプロジェクターという2つのファイルを指定します。確認なしにダウンロードされることはなく、先にサイズとモデルのライセンスが表示されます。

eSpeakは使いません。llama.cppはKokoro用の英語テキストを、モデルファイルに格納された発音辞書を使って読み上げます。このパッケージはeSpeak-ngを同梱しておらず、呼び出すこともありません。

## ダウンロードされるもの

タグで固定され、sha256で検証されるアップストリームのリリース: `ggml-org/llama.cpp` [`b12556`](https://github.com/ggml-org/llama.cpp/releases/tag/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（[ライセンス](https://github.com/ggml-org/llama.cpp/blob/b12556/LICENSE)）。
- LLVM OpenMPランタイム（`libomp.dll`、Windowsバリアントに同梱）— Apache-2.0とLLVM例外（[ライセンス](https://github.com/llvm/llvm-project/blob/main/openmp/LICENSE.TXT)）。アーカイブには`LICENSE-LLVM-OpenMP`が含まれます。
- NVIDIA CUDAランタイム（cudart、cuBLAS、cuBLASLt、WindowsのCUDAバリアントのみ）— アップストリームにより[NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/)の下で再配布されています。
- このパッケージ — MIT。各モデルパッケージは独自のライセンスを明記しています。モデルの重みは元のリリースのライセンスを引き継ぎます。

制限: ファイルを共有する際にこれらの告知を保持すること以外にありません。

すべてのファイルはアップストリームのGitHubリリースからダウンロードされます。AI Game Devがそれらをホストしているわけではありません。
````
