# Generación local de imágenes y video

> Genera imágenes, texturas y clips de video cortos en este equipo con stable-diffusion.cpp: NVIDIA (CUDA), AMD e Intel (Vulkan), Apple silicon (Metal) o el procesador. Añade las herramientas Image Gen y Video. Los modelos son paquetes aparte (Z-Image Turbo, FLUX, SDXL, Qwen-Image, LTX-2.5, Wan 2.2 y más).

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

## Instalar

Con la CLI gamedev, en la carpeta del proyecto:

```bash
gamedev pkg add aigd.sdcpp
```

En la app de escritorio: abre la ventana Packages (el icono de paquete en la barra de estado), selecciona **Browse**, busca `aigd.sdcpp` 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.3.1 | 2026-11-22 | `>=0.20.0` | la más reciente |
| 1.3.0 | 2026-11-21 | `>=0.20.0` | - |
| 1.2.0 | 2026-11-18 | `>=0.20.0` | - |
| 1.1.3 | 2026-11-06 | `>=0.20.0` | - |
| 1.1.2 | 2026-10-13 | `>=0.20.0` | - |
| 1.1.1 | 2026-10-12 | `>=0.20.0` | - |
| 1.1.0 | 2026-10-12 | `>=0.20.0` | - |
| 1.0.1 | 2026-10-11 | `>=0.20.0` | - |
| 1.0.0 | 2026-10-05 | `>=0.20.0` | - |

## Descripción

````markdown
# Generación local de imágenes y video (`aigd.sdcpp`)

El runtime que permite a AI Game Dev generar imágenes, texturas y clips de video cortos en este equipo, en tu propia GPU (o, para un modelo medido ahí, en su procesador), con [stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp). Todo se crea en tu equipo y crearlo no cuesta nada. Es el motor que hay detrás de todos los paquetes de modelos locales de imagen y video de abajo: instálalo una vez y luego añade los modelos que encajen con tu equipo y tu juego.

Este paquete es solo datos (`aigd-package.json`, sin código). Le indica a AI Game Dev qué versión de stable-diffusion.cpp descargar para tu equipo y añade dos interruptores a la barra Tools de la sesión: **Image Gen** y **Video**. Ambos están desactivados hasta que los actives en una sesión. La propia app descarga, comprueba y ejecuta el programa.

## Qué hace

- Descarga la compilación correcta de stable-diffusion.cpp para tu equipo (NVIDIA CUDA, Vulkan para AMD / Intel / otras GPU, Metal en Macs con Apple silicon, o el procesador) y la comprueba con sha256.
- Permite al agente crear imágenes (texto a imagen, imagen a imagen, ediciones) y clips (texto a video, imagen a video) con los paquetes de modelos que hayas instalado.
- Elige el mejor modelo descargado que encaje con tu equipo cuando no indicas ninguno (los ajustes **default model** y **default video model** tienen prioridad).
- Ejecuta una única cola compartida para imágenes y clips (ver abajo), con un límite de tiempo de generación opcional y un presupuesto de memoria de GPU.

## Los modelos son paquetes aparte

Este paquete no contiene ningún modelo. Instala un paquete de modelo (por ejemplo `aigd.image-z-image-turbo`, o `aigd.video-ltx25` / `aigd.video-wan22-ti2v-5b` para clips) desde el navegador Packages y luego descarga sus archivos desde el panel Models. Nada se descarga sin tu confirmación, y ves el tamaño antes, también cuando el agente pide un modelo.

### Modelos de imagen

| Paquete | Ideal para | Equipo |
|---|---|---|
| [Z-Image Turbo](https://ai-game.dev/packages/aigd.image-z-image-turbo) | imágenes fotorrealistas e ilustrativas rápidas, texto corto | NVIDIA 4 GB+, otras GPU 8 GB+, GPU integradas (lentas) |
| [FLUX.1 schnell](https://ai-game.dev/packages/aigd.image-flux1-schnell) | ilustraciones, fotos, iconos, sprites en 4 pasos | NVIDIA 8 GB+ |
| [FLUX.2 klein 4B](https://ai-game.dev/packages/aigd.image-flux2-klein-4b) | ilustraciones, iconos, sprites | Macs con Apple silicon |
| [SDXL 1.0](https://ai-game.dev/packages/aigd.image-sdxl-base) | ilustraciones generales, concept art, fotos | NVIDIA 8 GB+ |
| [Animagine XL 4.0](https://ai-game.dev/packages/aigd.image-animagine-xl-4) | personajes e ilustraciones de anime | NVIDIA 8 GB+ |
| [Juggernaut XL v9](https://ai-game.dev/packages/aigd.image-juggernaut-xl-v9) | imágenes cinematográficas fotorrealistas | NVIDIA 8 GB+ |
| [RealVisXL V5.0](https://ai-game.dev/packages/aigd.image-realvisxl-v5) | personas, lugares y productos fotorrealistas | NVIDIA 8 GB+ |
| [Qwen-Image](https://ai-game.dev/packages/aigd.image-qwen-image) | renderizado de texto, mockups de UI, pósteres | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2512](https://ai-game.dev/packages/aigd.image-qwen-image-2512) | renderizado de texto y seguimiento de prompts, 20 pasos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2512 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-2512-lightning) | lo mismo en 4 pasos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511) | edición de imágenes por instrucción, 20 pasos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511-lightning) | lo mismo en 4 pasos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2.1 Turbo Q3](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q3) | fondo transparente (no comercial) | NVIDIA 6–8 GB, 16 GB RAM |
| [Qwen-Image-2.1 Turbo](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo) | fondo transparente (no comercial) | NVIDIA 8 GB+, 16 GB de RAM; o el procesador de un PC con Windows |
| [Qwen-Image-2.1 Turbo Q8](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q8) | fondo transparente (no comercial) | NVIDIA 12 GB+, 24 GB RAM |

### Modelos de video

| Paquete | Ideal para | Equipo |
|---|---|---|
| [LTX-2.5](https://ai-game.dev/packages/aigd.video-ltx25) | clips con sonido sincronizado, texto o imagen inicial | NVIDIA 16 GB+, 48 GB RAM |
| [Wan 2.2 TI2V 5B](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b) | clips sin sonido, licencia abierta | NVIDIA 12 GB+, 16 GB RAM |

Cada paquete de modelo indica su propia licencia y los equipos en los que se midió.

## Ejemplos de peticiones

- "Activa Image Gen y crea un icono de una llave de plata para el inventario."
- "Crea una pintura conceptual de un cañón desértico con un modelo de imagen local."
- "Crea un clip de 5 segundos de la escena de la pantalla de título con viento y truenos lejanos."

## Una cola, una GPU

Las imágenes y los clips comparten una cola y una GPU, y solo hay un modelo cargado a la vez. Cargar un modelo tarda un rato, así que el modelo cargado conserva la GPU mientras siga teniendo trabajos en espera, tanto imágenes como clips. Otro modelo recibe su turno cuando al modelo cargado no le queda nada por hacer, o cuando un trabajo para otro modelo lleva esperando al menos 5 minutos. Entonces el siguiente turno es para el modelo cuyo trabajo lleve más tiempo esperando. Cambiar de modelo nunca interrumpe una imagen o un clip que ya se está ejecutando: primero termina. Solo se detiene antes si lo detienes tú, si alcanza tu límite de tiempo de generación o si el agente cancela un clip.

## Qué se descarga

Una release upstream, fijada por tag y comprobada por sha256: `leejet/stable-diffusion.cpp` [`master-1106-532d2c1`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-1106-532d2c1). La variante de Linux se queda en [`master-929-3f8527a`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-929-3f8527a): desde entonces upstream compila Linux en Ubuntu 26.04, y esos binarios necesitan glibc 2.43. La app elige una variante para tu equipo. Puedes cambiarla con el ajuste `backend`.

| Variante | Equipo | Descarga |
|---|---|---|
| `win-x64-cuda12` | Windows, GPU NVIDIA (controlador 572.61 o más reciente, compute capability 6.1 o superior) | 976 MB (programa + runtime de NVIDIA CUDA) |
| `win-x64-vulkan` | Windows, AMD / Intel / otras GPU | 30 MB |
| `win-x64-cpu` | Windows sin una GPU utilizable: el procesador. Lento (alrededor de un minuto por imagen de 512 px en un equipo de escritorio rápido, varios en un portátil) y solo para modelos medidos ahí (Qwen-Image-2.1 Turbo) | 18 MB |
| `darwin-arm64-metal` | Mac con Apple silicon, **macOS 26 o posterior** | 38 MB |
| `linux-x64-vulkan` | Linux x64 con una GPU Vulkan, **glibc 2.38 o posterior** (Ubuntu 24.04+, Debian 13+). Requiere `libgomp.so.1` y `libvulkan.so.1` instalados | 37 MB |

La compilación de CPU nunca se elige cuando puede ejecutarse una de GPU; elige **CPU** como backend en Models para usarla de todos modos.

**Text encoder.** La parte de un modelo que lee el prompt puede ejecutarse en la GPU o en el procesador (el ajuste `textEncoder`, **Text encoder** en Models). **Auto** mantiene aquello con lo que se midió cada modelo: Qwen-Image-2.1 Turbo Q3 y Wan 2.2 lo ponen en el procesador para que quepan en sus tarjetas. **CPU** libera unos 2 GB de memoria gráfica a cambio de uno o dos segundos por imagen; **GPU** es algo más rápido cuando la tarjeta tiene espacio, y puede quedarse sin memoria con un modelo que se midió con él en el procesador.

**Linux es una vista previa.** La compilación de Linux todavía no se ha probado en una GPU Linux real. Se puede seleccionar y está marcada como "preview".

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

## Licencias

- stable-diffusion.cpp — MIT, © leejet ([licencia](https://github.com/leejet/stable-diffusion.cpp/blob/master/LICENSE)).
- ggml — MIT (upstream incluye su fork [leejet/ggml](https://github.com/leejet/ggml) de [ggml-org/ggml](https://github.com/ggml-org/ggml)).
- Runtime de NVIDIA CUDA (cudart, cuBLAS), solo en la variante CUDA de Windows — redistribuido por upstream bajo la [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/).
- NVIDIA CUTLASS, solo en la variante CUDA de Windows — BSD-3-Clause ([licencia](https://github.com/NVIDIA/cutlass/blob/main/LICENSE.txt)).
- Este paquete — MIT. Cada paquete de modelo indica su propia licencia.

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