# Fala local (llama.cpp)

> Fala texto neste computador com a ferramenta de fala do llama.cpp, offline e sem gastar sua cota: falas de personagens, narração e diálogos provisórios em GPUs NVIDIA, AMD, Intel ou Apple, ou na CPU. Modelos como Kokoro e Chatterbox Turbo são pacotes separados.

- Id: `aigd.llamacpp`
- Origem: Oficial (de primeira parte `aigd.*`)
- Categoria: Áudio
- Publicador: AI Game Dev (`aigd`), verificado
- Versão mais recente: 1.0.2 (publicado em 2026-11-22)
- Licença: MIT
- Requer o app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: não
- Avaliação: ainda sem avaliações
- Página HTML: https://ai-game.dev/pt-br/packages/aigd.llamacpp

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.llamacpp` e clique em **Add to Project**. Mais: https://ai-game.dev/docs/wiki/app/packages

## Versões

| Versão | Publicado | Requer o app | Observações |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | mais recente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descrição

````markdown
# Fala local (`aigd.llamacpp`)

O runtime de fala local do AI Game Dev: ele fala texto neste computador com a ferramenta de fala do [llama.cpp](https://github.com/ggml-org/llama.cpp) (`llama-tts`). Tudo é feito no seu computador, offline, e não usa nada da sua cota do AI Game Dev. Serve para desenvolvedores de jogos que querem falas de voz, narração e diálogos provisórios sem enviar texto para a nuvem. Os próprios modelos de fala, como [Kokoro 82M](https://ai-game.dev/packages/aigd.tts-kokoro) e [Chatterbox Turbo](https://ai-game.dev/packages/aigd.tts-chatterbox-turbo), são pacotes separados.

## O que você pode fazer

- Dar voz a diálogos de NPCs, barks, tutoriais e narração no seu próprio computador.
- Rascunhar cada linha de um protótipo offline, quantas vezes quiser, sem usar cota.
- Rodar fala em uma GPU NVIDIA, AMD ou Intel, em Apple silicon, ou na CPU.

## Exemplos de pedidos

- "Leia estas cinco falas de guarda com o Kokoro no meu computador e salve no projeto."
- "Dê voz ao roteiro do tutorial localmente com o Chatterbox Turbo."
- "Crie diálogos provisórios para todos os aldeões com um modelo de fala local."

## Como funciona

Este pacote é apenas dados (`aigd-package.json`, sem código). Ele informa ao AI Game Dev qual release do llama.cpp baixar para o seu computador. Seus modelos de fala são usados pela ferramenta **Áudio** da sessão, como os outros modelos de fala locais. O app baixa, verifica e executa o programa por conta própria: uma execução de `llama-tts` por linha de fala, offline, então nada fica na memória entre gerações.

Configurações (por máquina):

| Configuração | O que faz |
|---|---|
| `backend` | Escolhe CUDA (NVIDIA), Vulkan (a maioria das GPUs), Metal (Mac) ou a CPU quando o Automático não serve para o seu computador. Padrão: Automático. |
| `newModelsDefault` | Se o agente pode usar um modelo de fala deste runtime que você baixar a partir de agora (`allowed` por padrão, ou `blocked`). Os modelos que você já baixou mantêm a própria configuração. |

## Modelos são pacotes separados

Este pacote não contém nenhum modelo. Cada pacote de modelo de fala ([`tts-kokoro`](https://ai-game.dev/packages/aigd.tts-kokoro), [`tts-chatterbox-turbo`](https://ai-game.dev/packages/aigd.tts-chatterbox-turbo)) informa seus dois arquivos, o modelo e seu projetor de áudio. Nada é baixado sem sua confirmação, e você vê o tamanho e a licença do modelo antes.

Sem eSpeak: o llama.cpp lê texto em inglês para o Kokoro com o dicionário de pronúncia armazenado no arquivo do modelo. Este pacote não inclui o eSpeak-ng e nunca o chama.

## O que é baixado

Uma release upstream, fixada por tag e verificada por sha256: `ggml-org/llama.cpp` [`b12556`](https://github.com/ggml-org/llama.cpp/releases/tag/b12556) (commit `50518b64c6f2191a116d2760042f106c4b3387d7`). O app escolhe uma variante para o seu computador.

| Variante | Computador | Download |
|---|---|---|
| `win-x64-cuda12` | Windows, GPU NVIDIA (driver 551.61 ou mais recente) | 756 MB (programa + runtime NVIDIA CUDA 12.4) |
| `win-x64-vulkan` | Windows, GPUs AMD / Intel / outras | 39 MB |
| `win-x64-cpu` | Windows sem GPU compatível | 25 MB |
| `darwin-arm64-metal` | Mac com Apple silicon, macOS 13.3 ou mais recente | 16 MB |
| `linux-x64-vulkan` | Linux x64 com GPU Vulkan, glibc 2.34 e libstdc++ GLIBCXX_3.4.30 ou mais recente (Ubuntu 22.04+, Debian 12+). Precisa de `libgomp.so.1`, OpenSSL 3 (`libssl.so.3`, `libcrypto.so.3`) e `libvulkan.so.1` | 37 MB |
| `linux-x64-cpu` | Linux x64, glibc 2.34 e GLIBCXX_3.4.30 ou mais recente. Precisa de `libgomp.so.1` e OpenSSL 3 | 23 MB |

**O Linux é uma prévia.** O build CUDA para Linux do llama.cpp mantém o runtime CUDA em uma pasta separada que o programa não consulta, então no Linux com GPU NVIDIA a variante Vulkan é executada.

## Requisitos

- Os builds para Windows precisam do runtime Microsoft Visual C++ 2015–2022 (`MSVCP140.dll`, `VCRUNTIME140_1.dll`), que a maioria dos PCs Windows já tem; os arquivos compactados não o incluem.
- O Kokoro é pequeno o suficiente para rodar bem em uma CPU.
- O app nunca instala drivers nem bibliotecas do sistema. Se faltar algo, ele informa o que instalar.
- AI Game Dev 0.32.0-beta.6 ou mais recente.

## Licença

- llama.cpp e ggml — MIT, © 2023-2026 The ggml authors ([licença](https://github.com/ggml-org/llama.cpp/blob/b12556/LICENSE)).
- Runtime LLVM OpenMP (`libomp.dll`), nas variantes para Windows — Apache-2.0 com exceção LLVM ([licença](https://github.com/llvm/llvm-project/blob/main/openmp/LICENSE.TXT)); o arquivo compactado inclui `LICENSE-LLVM-OpenMP`.
- Runtime NVIDIA CUDA (cudart, cuBLAS, cuBLASLt), apenas na variante CUDA para Windows — redistribuído pelo upstream sob a [EULA do NVIDIA CUDA](https://docs.nvidia.com/cuda/eula/).
- Este pacote — MIT. Cada pacote de modelo declara a própria licença; os pesos dos modelos mantêm a licença de seu lançamento original.

Restrições: nenhuma além de manter estes avisos quando você compartilhar os arquivos.

Todos os arquivos são baixados da release upstream no GitHub. O AI Game Dev não os hospeda.
````
