本地语音(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 上运行语音。
示例请求
- “用 Kokoro 在我电脑上朗读这五句守卫台词,并保存到项目里。”
- “用 Chatterbox Turbo 在本地为教程脚本配音。”
- “用本地语音模型为所有村民生成占位对白。”
工作原理
本包只包含数据(aigd-package.json,没有代码)。它告诉 AI Game Dev 该为你的电脑下载哪个 llama.cpp 版本。它的语音模型通过会话的 Audio 工具使用,与其他本地语音模型一样。应用会自行下载、校验并运行该程序:每句语音运行一次 llama-tts,全程离线,因此两次生成之间不会有任何内容留在内存中。
设置(按机器保存):
| 设置 | 作用 |
|---|---|
backend | 当 Auto 不适合你的电脑时,选择 CUDA(NVIDIA)、Vulkan(大多数 GPU)、Metal(Mac)或 CPU。默认:Auto。 |
newModelsDefault | 从现在起,代理是否可以使用你下载的本运行时语音模型(默认 allowed,或 blocked)。你已下载的模型保留各自的设置。 |
模型是单独的包
本包不包含任何模型。每个语音模型包(tts-kokoro、tts-chatterbox-turbo)都会注明它的两个文件:模型和它的音频投影器。未经你确认不会下载任何内容,并且你会先看到文件大小和模型的许可证。
不使用 eSpeak:llama.cpp 使用存储在模型文件中的发音词典来朗读 Kokoro 的英文文本。本包不附带 eSpeak-ng,也从不调用它。
会下载什么
上游发布版本,按 tag 固定并用 sha256 校验:ggml-org/llama.cpp b12556(commit 50518b64c6f2191a116d2760042f106c4b3387d7)。应用会为你的电脑选择其中一个变体。
| 变体 | 电脑 | 下载 |
|---|---|---|
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 | Windows,无受支持的 GPU | 25 MB |
darwin-arm64-metal | 搭载 Apple 芯片的 Mac,macOS 13.3 或更新版本 | 16 MB |
linux-x64-vulkan | Linux x64,带 Vulkan GPU,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 电脑已经装有它;压缩包中不包含它。 - 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 with LLVM exception(许可证);压缩包中包含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 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.llamacpp,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.llamacpp环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
gamedev pkg add aigd.llamacpp