Geração local de imagens e vídeos
gamedev pkg add aigd.sdcppVisão geral
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).
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. 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 | imagens fotorrealistas e ilustrativas rápidas, texto curto | NVIDIA 4 GB+, outras GPUs 8 GB+, GPUs integradas (lento) |
| FLUX.1 schnell | ilustrações, fotos, ícones, sprites em 4 passos | NVIDIA 8 GB+ |
| FLUX.2 klein 4B | ilustrações, ícones, sprites | Macs com Apple silicon |
| SDXL 1.0 | ilustrações gerais, concept art, fotos | NVIDIA 8 GB+ |
| Animagine XL 4.0 | personagens e ilustrações de anime | NVIDIA 8 GB+ |
| Juggernaut XL v9 | imagens fotorrealistas cinematográficas | NVIDIA 8 GB+ |
| RealVisXL V5.0 | pessoas, lugares e produtos fotorrealistas | NVIDIA 8 GB+ |
| Qwen-Image | renderização de texto, mockups de UI, pôsteres | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2512 | renderização de texto e aderência ao prompt, 20 passos | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2512 Lightning | o mesmo em 4 passos | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-Edit-2511 | edição de imagens por instrução, 20 passos | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-Edit-2511 Lightning | o mesmo em 4 passos | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2.1 Turbo Q3 | fundo transparente (não comercial) | NVIDIA 6–8 GB, 16 GB RAM |
| 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 | fundo transparente (não comercial) | NVIDIA 12 GB+, 24 GB RAM |
Modelos de vídeo
| Pacote | Ideal para | Computador |
|---|---|---|
| LTX-2.5 | clipes com som sincronizado, texto ou imagem inicial | NVIDIA 16 GB+, 48 GB RAM |
| Wan 2.2 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. A variante Linux fica em 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).
- ggml — MIT (o upstream envia seu fork leejet/ggml do ggml-org/ggml).
- Runtime NVIDIA CUDA (cudart, cuBLAS), apenas na variante CUDA para Windows — redistribuído pelo upstream sob a NVIDIA CUDA EULA.
- NVIDIA CUTLASS, apenas na variante CUDA para Windows — BSD-3-Clause (licença).
- 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.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.3.1Mais recente | 0.20.0 ou mais recente | |
| 1.3.0 | 0.20.0 ou mais recente | |
| 1.2.0 | 0.20.0 ou mais recente | |
| 1.1.3 | 0.20.0 ou mais recente | |
| 1.1.2 | 0.20.0 ou mais recente | |
| 1.1.1 | 0.20.0 ou mais recente | |
| 1.1.0 | 0.20.0 ou mais recente | |
| 1.0.1 | 0.20.0 ou mais recente | |
| 1.0.0 | 0.20.0 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.sdcpp 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.sdcppRequisitos
- AI Game Dev 0.20.0 ou mais recente
- Um Mac com Apple silicon
gamedev pkg add aigd.sdcpp