# Efectos de sonido y música locales (Stable Audio 3)

> Entorno de ejecución para efectos de sonido y música locales en AI Game Dev con sa3.cpp, el port C++/ggml de Stable Audio 3, en CUDA, Vulkan, Metal o la CPU, sin Python. Ejecuta los modelos Stable Audio 3 Small SFX, Small Music y Medium, que son paquetes independientes.

- Id: `aigd.sa3cpp`
- Origen: Oficial (propio `aigd.*`)
- Categoría: Audio
- Editor: AI Game Dev (`aigd`), verificado
- Última versión: 1.0.2 (publicado el 2026-11-22)
- Licencia: MIT
- Requiere la app AI Game Dev: `>=0.32.0-beta.6`
- Código nativo: no
- Valoración: aún sin valoraciones
- Página HTML: https://ai-game.dev/es/packages/aigd.sa3cpp

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.sa3cpp
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.sa3cpp` y haz clic en **Add to Project**. Más: https://ai-game.dev/docs/wiki/app/packages

## Versiones

| Versión | Publicado | Requiere app | Notas |
|---|---|---|---|
| 1.0.2 | 2026-11-22 | `>=0.32.0-beta.6` | la más reciente |
| 1.0.1 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## Descripción

````markdown
# Efectos de sonido y música locales (`aigd.sa3cpp`)

Efectos de sonido y música locales es el entorno de ejecución que permite a la app AI Game Dev crear efectos de sonido y música instrumental en tu propio ordenador con los modelos Stable Audio 3. Usa [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp), un port C++/ggml de Stable Audio 3 de Stability AI que no necesita Python. Todo se genera en tu ordenador y generarlo no cuesta nada. Está pensado para desarrolladores de juegos que quieren efectos de sonido, foley, sonidos de interfaz y música de fondo sin un servicio en la nube.

## Qué hace

- Descarga la versión de sa3.cpp que encaja con tu ordenador (Windows, Mac con Apple silicon, o Intel Mac y Linux como vista previa; CUDA, Vulkan, Metal o CPU), la verifica por sha256 y la ejecuta.
- Añade el interruptor **SFX & Music** a la barra Tools de la sesión. El interruptor está apagado hasta que lo actives en una sesión.
- Ejecuta `sa3-generate` una vez por sonido y no mantiene ningún servidor en marcha.

Este paquete es solo datos (`aigd-package.json`, sin código). Indica a AI Game Developer qué versión de sa3.cpp descargar para tu ordenador. La app descarga, verifica y ejecuta el programa por sí misma.

## Los modelos son paquetes independientes

Este paquete no contiene ningún modelo. Instala un paquete de modelo desde el navegador de Paquetes y después descarga sus archivos desde el panel Modelos:

| Paquete | Qué genera |
|---|---|
| [Stable Audio 3 Small SFX](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-sfx) (`aigd.audio-stable-audio-3-small-sfx`) | efectos de sonido y foley, hasta 60 s |
| [Stable Audio 3 Small Music](https://ai-game.dev/packages/aigd.audio-stable-audio-3-small-music) (`aigd.audio-stable-audio-3-small-music`) | música instrumental, hasta 2 minutos |
| [Stable Audio 3 Medium](https://ai-game.dev/packages/aigd.audio-stable-audio-3-medium) (`aigd.audio-stable-audio-3-medium`) | música instrumental, hasta 6 min 20 s |

Nada se descarga sin tu confirmación. Primero ves el tamaño y la licencia del modelo. Los modelos Stable Audio 3 tienen su propia licencia, con un límite de ingresos, una obligación de registro y un aviso "Powered by Stability AI". El README de cada paquete de modelo expone estos términos.

Otros modelos locales de música, efectos de sonido y voz se ejecutan en [generación de audio local](https://ai-game.dev/packages/aigd.audiocpp) (`aigd.audiocpp`).

## Ejemplos de peticiones

Con **SFX & Music** activado y un modelo instalado, se lo pides al agente con palabras normales:

- "Genera un sonido corto de explosión láser para el arma del jugador."
- "Genera pasos sobre nieve, 4 segundos."
- "Genera una instrumental lo-fi relajada de 90 segundos para el menú principal."

## Qué se descarga

La app descarga una versión upstream, fijada por etiqueta y verificada por sha256: `betweentwomidnights/sa3.cpp` [`v0.2.4`](https://github.com/betweentwomidnights/sa3.cpp/releases/tag/v0.2.4) (commit `3152253`). Upstream la marca como pre-release. La app elige una variante para tu ordenador.

| Variante | Ordenador | Descarga |
|---|---|---|
| `win-x64-cuda12` | Windows, GPU NVIDIA (controlador 572.61 o más reciente, capacidad de cálculo 6.1 o superior) | 752 MB (programa + runtime de NVIDIA CUDA 12.8) |
| `win-x64-vulkan` | Windows, GPU AMD / Intel / otras | 19 MB (núcleo + backend Vulkan) |
| `win-x64-cpu` | Windows, sin GPU utilizable (lento; Medium necesita una GPU) | 7 MB |
| `darwin-arm64-metal` | Mac con Apple silicon, macOS 13.3 o más reciente | 11 MB (firmado y notarizado por upstream) |
| `darwin-x64-cpu` | Intel Mac, macOS 13.3 o más reciente (solo CPU) | 11 MB |
| `linux-x64-vulkan` | Linux x64 con una GPU Vulkan, **glibc 2.38 o más reciente** (Ubuntu 24.04+, Debian 13+). Necesita `libgomp.so.1` y `libvulkan.so.1` | 22 MB |
| `linux-x64-cpu` | Linux x64 sin una GPU utilizable, glibc 2.38 o más reciente. Necesita `libgomp.so.1` | 12 MB |

La variante CUDA para Windows usa el archivo independiente de upstream. Es el único archivo que incluye el runtime de CUDA (`cudart64_12`, `cublas64_12`, `cublasLt64_12`). El archivo dividido `cuda` contiene solo `ggml-cuda.dll` y espera un runtime de CUDA 12.8 instalado en todo el sistema.

**Vistas previas.** Las variantes para Linux e Intel Mac aún no se han probado en hardware real, y upstream no valida la generación de CPU. Se pueden seleccionar y están marcadas como "preview".

La app nunca instala controladores ni bibliotecas del sistema. Si falta algo, te dice qué instalar.

## Licencia

- sa3.cpp — MIT, © 2026 betweentwomidnights ([licencia](https://github.com/betweentwomidnights/sa3.cpp/blob/3152253622d8b54deec14bfb0938371a5bd20439/LICENSE)).
- ggml — MIT, © The ggml authors ([ggml-org/ggml](https://github.com/ggml-org/ggml)).
- cpp-httplib (MIT, © yhirose), yyjson (MIT, © YaoYuan), Signalsmith Stretch y Signalsmith Linear (MIT, © Signalsmith Audio). Sus archivos de licencia se incluyen dentro de los archivos comprimidos.
- Motor de prompts RC-stable-audio-tools de RoyalCities (MIT, © 2023 Stability AI), adaptado en las herramientas `sat-*` ([fuente](https://github.com/RoyalCities/RC-stable-audio-tools)). AI Game Developer no ejecuta esas herramientas; la licencia está en `THIRD_PARTY_NOTICES.md` de los archivos comprimidos.
- Runtime de Microsoft Visual C++ (`msvcp140`, `vcruntime140`, `vcruntime140_1`, `vcomp140`), solo en las variantes para Windows. Upstream lo redistribuye bajo los términos de Visual Studio 2022 para código redistribuible.
- Runtime de NVIDIA CUDA (cudart, cuBLAS), solo en la variante CUDA para Windows. Upstream lo redistribuye bajo la [EULA de NVIDIA CUDA](https://docs.nvidia.com/cuda/eula/), y `NVIDIA-CUDA-EULA.txt` se incluye en el archivo comprimido.
- Este paquete — MIT. El runtime no contiene pesos de modelo. Cada paquete de modelo declara su propia licencia.

Todos los archivos se descargan desde la release de GitHub de upstream. AI Game Developer no los aloja.
````
