本機語音(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 | 當「自動」不適合你的電腦時,選擇 CUDA(NVIDIA)、Vulkan(大多數 GPU)、Metal(Mac)或 CPU。預設:自動。 |
newModelsDefault | 往後你下載的此執行環境語音模型,代理是否可以使用(預設 allowed,或 blocked)。你已經下載的模型會保留各自的設定。 |
模型是另外的套件
這個套件不含任何模型。每個語音模型套件(tts-kokoro、tts-chatterbox-turbo)都會列出它的兩個檔案:模型本身與其音訊投影器。未經你確認不會下載任何東西,而且你會先看到大小與模型的授權。
不使用 eSpeak:llama.cpp 是借助模型檔案內附的發音字典來讀出 Kokoro 的英文文字。這個套件不隨附 eSpeak-ng,也從不呼叫它。
會下載哪些東西
上游發行版,以標籤固定版本並以 sha256 檢查:ggml-org/llama.cpp b12556(提交 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