Efeitos sonoros e música locais (Stable Audio 3)
gamedev pkg add aigd.sa3cppVisão geral
Runtime para efeitos sonoros e música locais no AI Game Dev com sa3.cpp, o port C++/ggml do Stable Audio 3, em CUDA, Vulkan, Metal ou na CPU, sem Python. Executa os modelos Stable Audio 3 Small SFX, Small Music e Medium, que são pacotes separados.
Efeitos sonoros e música locais é o runtime que permite ao app AI Game Dev criar efeitos sonoros e música instrumental no seu próprio computador com os modelos Stable Audio 3. Ele usa sa3.cpp, um port C++/ggml do Stable Audio 3 da Stability AI que dispensa Python. Tudo é criado no seu computador, e criar não custa nada. É indicado para desenvolvedores de jogos que querem SFX, foley, sons de UI e música de fundo sem um serviço de nuvem.
O que ele faz
- Baixa a release do sa3.cpp adequada ao seu computador (Windows, Macs com Apple silicon, ou Intel Macs e Linux como preview; CUDA, Vulkan, Metal ou CPU), verifica por sha256 e a executa.
- Adiciona a chave SFX & Music à barra Tools da sessão. A chave fica desligada até você ativá-la em uma sessão.
- Executa
sa3-generateuma vez por som e não mantém nenhum servidor em execução.
Este pacote é apenas dados (aigd-package.json, sem código). Ele informa ao AI Game Dev qual release do sa3.cpp baixar para o seu computador. O app baixa, verifica e executa o programa por conta própria.
Os modelos são pacotes separados
Este pacote não contém nenhum modelo. Instale um pacote de modelo pelo navegador de Pacotes e depois baixe os arquivos dele no painel Modelos:
| Pacote | O que ele cria |
|---|---|
Stable Audio 3 Small SFX (aigd.audio-stable-audio-3-small-sfx) | efeitos sonoros e foley, até 60 s |
Stable Audio 3 Small Music (aigd.audio-stable-audio-3-small-music) | música instrumental, até 2 minutos |
Stable Audio 3 Medium (aigd.audio-stable-audio-3-medium) | música instrumental, até 6 min 20 s |
Nada é baixado sem a sua confirmação. Você vê primeiro o tamanho e a licença do modelo. Os modelos Stable Audio 3 têm licença própria, com limite de receita, dever de registro e um aviso "Powered by Stability AI". O README de cada pacote de modelo apresenta esses termos.
Outros modelos locais de música, efeitos sonoros e fala são executados em Geração de áudio local (aigd.audiocpp).
Exemplos de pedidos
Com o SFX & Music ativado e um modelo instalado, você pede ao agente em palavras simples:
- "Crie um som curto de disparo de laser para a arma do jogador."
- "Gere passos na neve, 4 segundos."
- "Crie um instrumental lo-fi relaxante de 90 segundos para o menu principal."
O que é baixado
O app baixa uma release upstream, fixada por tag e verificada por sha256: betweentwomidnights/sa3.cpp v0.2.4 (commit 3152253). O upstream a marca como pré-release. O app escolhe uma variante para o seu computador.
| Variante | Computador | Download |
|---|---|---|
win-x64-cuda12 | Windows, GPU NVIDIA (driver 572.61 ou mais recente, compute capability 6.1 ou mais recente) | 752 MB (programa + runtime NVIDIA CUDA 12.8) |
win-x64-vulkan | Windows, GPUs AMD / Intel / outras | 19 MB (núcleo + backend Vulkan) |
win-x64-cpu | Windows, sem GPU utilizável (lento; o Medium precisa de GPU) | 7 MB |
darwin-arm64-metal | Mac com Apple silicon, macOS 13.3 ou mais recente | 11 MB (assinado e notarizado pelo upstream) |
darwin-x64-cpu | Intel Mac, macOS 13.3 ou mais recente (somente CPU) | 11 MB |
linux-x64-vulkan | Linux x64 com GPU Vulkan, glibc 2.38 ou mais recente (Ubuntu 24.04+, Debian 13+). Requer libgomp.so.1 e libvulkan.so.1 | 22 MB |
linux-x64-cpu | Linux x64 sem GPU utilizável, glibc 2.38 ou mais recente. Requer libgomp.so.1 | 12 MB |
A variante CUDA para Windows usa o archive autônomo do upstream. É o único archive que carrega o runtime CUDA (cudart64_12, cublas64_12, cublasLt64_12). O archive dividido cuda contém apenas ggml-cuda.dll e espera um runtime CUDA 12.8 instalado em todo o sistema.
Previews. As variantes de Linux e Intel Mac ainda não foram testadas em hardware real, e o upstream não valida a geração por CPU. Elas são selecionáveis e marcadas como "preview".
O app nunca instala drivers nem bibliotecas de sistema. Se faltar algo, ele informa o que instalar.
Licença
- sa3.cpp — MIT, © 2026 betweentwomidnights (licença).
- ggml — MIT, © The ggml authors (ggml-org/ggml).
- cpp-httplib (MIT, © yhirose), yyjson (MIT, © YaoYuan), Signalsmith Stretch e Signalsmith Linear (MIT, © Signalsmith Audio). Os arquivos de licença deles vêm dentro dos archives.
- Motor de prompts RoyalCities RC-stable-audio-tools (MIT, © 2023 Stability AI), adaptado nas ferramentas
sat-*(código-fonte). O AI Game Dev não executa essas ferramentas; a licença está noTHIRD_PARTY_NOTICES.mddos archives. - Runtime do Microsoft Visual C++ (
msvcp140,vcruntime140,vcruntime140_1,vcomp140), apenas nas variantes para Windows. O upstream o redistribui sob os termos do Visual Studio 2022 para código redistribuível. - Runtime NVIDIA CUDA (cudart, cuBLAS), apenas na variante CUDA para Windows. O upstream o redistribui sob a NVIDIA CUDA EULA, e
NVIDIA-CUDA-EULA.txtvem no archive. - Este pacote — MIT. O runtime não contém pesos de modelo. Cada pacote de modelo declara sua própria licença.
Todos os arquivos são baixados da release do GitHub do upstream. O AI Game Dev não os hospeda.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.2Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.1 | 0.32.0-beta.6 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.sa3cpp e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.sa3cppRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
gamedev pkg add aigd.sa3cpp