# Geração local de imagens e vídeos

> Gera imagens, texturas e clipes de vídeo curtos neste computador com stable-diffusion.cpp: NVIDIA (CUDA), AMD e Intel (Vulkan), Apple silicon (Metal) ou o processador. Adiciona as ferramentas Image Gen e Video. Os modelos são pacotes separados (Z-Image Turbo, FLUX, SDXL, Qwen-Image, LTX-2.5, Wan 2.2 e mais).

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

## Instalar

Com o CLI gamedev, na pasta do projeto:

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

No app desktop: abra a janela Packages (o ícone de pacote na barra de status), selecione **Browse**, busque `aigd.sdcpp` 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.3.1 | 2026-11-22 | `>=0.20.0` | mais recente |
| 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` | - |

## Descrição

````markdown
# Geração local de imagens e vídeos (`aigd.sdcpp`)

O runtime que permite ao AI Game Dev gerar imagens, texturas e clipes de vídeo curtos neste computador, na sua própria GPU (ou, para um modelo medido nela, no processador dele), com [stable-diffusion.cpp](https://github.com/leejet/stable-diffusion.cpp). Tudo é feito no seu computador, e fazer isso não custa nada. É o motor por trás de todos os pacotes de modelos locais de imagem e vídeo abaixo: instale-o uma vez e depois adicione os modelos que cabem no seu computador e no seu jogo.

Este pacote contém apenas dados (`aigd-package.json`, sem código). Ele informa ao AI Game Dev qual versão do stable-diffusion.cpp baixar para o seu computador e adiciona dois botões à barra Tools da sessão: **Image Gen** e **Video**. Ambos ficam desligados até você ativá-los em uma sessão. O próprio app baixa, verifica e executa o programa.

## O que ele faz

- Baixa a build correta do stable-diffusion.cpp para o seu computador (NVIDIA CUDA, Vulkan para AMD / Intel / outras GPUs, Metal em Macs com Apple silicon, ou o processador) e a verifica por sha256.
- Permite que o agente faça imagens (texto para imagem, imagem para imagem, edições) e clipes (texto para vídeo, imagem para vídeo) com os pacotes de modelos que você instalou.
- Escolhe o melhor modelo baixado que cabe no seu computador quando você não indica um (os ajustes **default model** e **default video model** têm precedência).
- Executa uma fila compartilhada para imagens e clipes (veja abaixo), com um limite opcional de tempo de geração e um orçamento de memória de GPU.

## Os modelos são pacotes separados

Este pacote não contém nenhum modelo. Instale um pacote de modelo (por exemplo `aigd.image-z-image-turbo`, ou `aigd.video-ltx25` / `aigd.video-wan22-ti2v-5b` para clipes) no navegador de Pacotes e depois baixe os arquivos dele no painel Models. Nada é baixado sem a sua confirmação, e você vê o tamanho antes — inclusive quando o agente pede um modelo.

### Modelos de imagem

| Pacote | Ideal para | Computador |
|---|---|---|
| [Z-Image Turbo](https://ai-game.dev/packages/aigd.image-z-image-turbo) | imagens fotorrealistas e ilustrativas rápidas, texto curto | NVIDIA 4 GB+, outras GPUs 8 GB+, GPUs integradas (lento) |
| [FLUX.1 schnell](https://ai-game.dev/packages/aigd.image-flux1-schnell) | ilustrações, fotos, ícones, sprites em 4 passos | NVIDIA 8 GB+ |
| [FLUX.2 klein 4B](https://ai-game.dev/packages/aigd.image-flux2-klein-4b) | ilustrações, ícones, sprites | Macs com Apple silicon |
| [SDXL 1.0](https://ai-game.dev/packages/aigd.image-sdxl-base) | ilustrações gerais, concept art, fotos | NVIDIA 8 GB+ |
| [Animagine XL 4.0](https://ai-game.dev/packages/aigd.image-animagine-xl-4) | personagens e ilustrações de anime | NVIDIA 8 GB+ |
| [Juggernaut XL v9](https://ai-game.dev/packages/aigd.image-juggernaut-xl-v9) | imagens fotorrealistas cinematográficas | NVIDIA 8 GB+ |
| [RealVisXL V5.0](https://ai-game.dev/packages/aigd.image-realvisxl-v5) | pessoas, lugares e produtos fotorrealistas | NVIDIA 8 GB+ |
| [Qwen-Image](https://ai-game.dev/packages/aigd.image-qwen-image) | renderização 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) | renderização de texto e aderência ao prompt, 20 passos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-2512 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-2512-lightning) | o mesmo em 4 passos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511) | edição de imagens por instrução, 20 passos | NVIDIA 16 GB+, 32 GB RAM |
| [Qwen-Image-Edit-2511 Lightning](https://ai-game.dev/packages/aigd.image-qwen-image-edit-2511-lightning) | o mesmo em 4 passos | 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) | fundo transparente (não 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) | fundo transparente (não comercial) | NVIDIA 8 GB+, 16 GB de RAM; ou o processador de um PC Windows |
| [Qwen-Image-2.1 Turbo Q8](https://ai-game.dev/packages/aigd.image-qwen-image-2-1-turbo-q8) | fundo transparente (não comercial) | NVIDIA 12 GB+, 24 GB RAM |

### Modelos de vídeo

| Pacote | Ideal para | Computador |
|---|---|---|
| [LTX-2.5](https://ai-game.dev/packages/aigd.video-ltx25) | clipes com som sincronizado, texto ou imagem inicial | NVIDIA 16 GB+, 48 GB RAM |
| [Wan 2.2 TI2V 5B](https://ai-game.dev/packages/aigd.video-wan22-ti2v-5b) | clipes sem som, licença aberta | NVIDIA 12 GB+, 16 GB RAM |

Cada pacote de modelo declara sua própria licença e os computadores em que foi medido.

## Exemplos de pedidos

- "Ative o Image Gen e faça um ícone de uma chave de prata para o inventário."
- "Faça uma pintura conceitual de um cânion desértico com um modelo de imagem local."
- "Faça um clipe de 5 segundos da cena da tela de título com vento e trovões distantes."

## Uma fila, uma GPU

Imagens e clipes compartilham uma fila e uma GPU, e apenas um modelo fica carregado por vez. Carregar um modelo leva um tempo, então o modelo carregado mantém a GPU enquanto ainda tiver trabalhos esperando, sejam imagens ou clipes. Outro modelo só chega a sua vez quando o modelo carregado não tem mais nada a fazer, ou quando um trabalho para outro modelo já esperou pelo menos 5 minutos. Então a vez seguinte é do modelo cujo trabalho esperou mais tempo. Trocar de modelo nunca interrompe uma imagem ou um clipe que já está em execução: ele termina primeiro. Ele só para antes disso se você o parar, se atingir o seu limite de tempo de geração, ou se o agente cancelar um clipe.

## O que é baixado

Uma versão do upstream, fixada por tag e verificada por sha256: `leejet/stable-diffusion.cpp` [`master-1106-532d2c1`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-1106-532d2c1). A variante Linux fica em [`master-929-3f8527a`](https://github.com/leejet/stable-diffusion.cpp/releases/tag/master-929-3f8527a): desde então o upstream compila o Linux no Ubuntu 26.04, e esses binários precisam de glibc 2.43. O app escolhe uma variante para o seu computador. Você pode alterá-la com o ajuste `backend`.

| Variante | Computador | Download |
|---|---|---|
| `win-x64-cuda12` | Windows, GPU NVIDIA (driver 572.61 ou mais recente, compute capability 6.1 ou mais recente) | 976 MB (programa + runtime NVIDIA CUDA) |
| `win-x64-vulkan` | Windows, GPUs AMD / Intel / outras | 30 MB |
| `win-x64-cpu` | Windows sem uma GPU utilizável: o processador. Lento (cerca de um minuto por imagem de 512 px em um desktop rápido, vários em um notebook) e apenas para modelos medidos nele (Qwen-Image-2.1) | 18 MB |
| `darwin-arm64-metal` | Mac com Apple silicon, **macOS 26 ou mais recente** | 38 MB |
| `linux-x64-vulkan` | Linux x64 com uma GPU Vulkan, **glibc 2.38 ou mais recente** (Ubuntu 24.04+, Debian 13+). Precisa de `libgomp.so.1` e `libvulkan.so.1` instalados | 37 MB |

A build de CPU nunca é escolhida onde uma build de GPU pode rodar; escolha **CPU** como backend em Models para usá-la mesmo assim.

**Text encoder.** A parte de um modelo que lê o prompt pode rodar na GPU ou no processador (o ajuste `textEncoder`, **Text encoder** em Models). **Auto** mantém o que cada modelo foi medido com: Qwen-Image-2.1 Turbo Q3 e Wan 2.2 o colocam no processador para caber em suas placas. **CPU** libera cerca de 2 GB de memória gráfica por um ou dois segundos por imagem; **GPU** é um pouco mais rápido quando a placa tem espaço, e pode ficar sem memória com um modelo que foi medido com ele no processador.

**O Linux é uma prévia.** A build Linux ainda não foi testada em uma GPU Linux real. Ela é selecionável e marcada como "preview".

O app nunca instala drivers ou bibliotecas do sistema. Se faltar algo, ele informa o que instalar.

## Licenças

- stable-diffusion.cpp — MIT, © leejet ([licença](https://github.com/leejet/stable-diffusion.cpp/blob/master/LICENSE)).
- ggml — MIT (o upstream envia seu fork [leejet/ggml](https://github.com/leejet/ggml) do [ggml-org/ggml](https://github.com/ggml-org/ggml)).
- Runtime NVIDIA CUDA (cudart, cuBLAS), apenas na variante CUDA para Windows — redistribuído pelo upstream sob a [NVIDIA CUDA EULA](https://docs.nvidia.com/cuda/eula/).
- NVIDIA CUTLASS, apenas na variante CUDA para Windows — BSD-3-Clause ([licença](https://github.com/NVIDIA/cutlass/blob/main/LICENSE.txt)).
- Este pacote — MIT. Cada pacote de modelo declara sua própria licença.

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