AUTOMATIC1111: instalar o Stable Diffusion WebUI (2026)

#AUTOMATIC1111, o que é?

A Stability AI anunciou o lançamento público do Stable Diffusion em 22 de agosto de 2022. O repositório de um desenvolvedor conhecido pelo pseudônimo AUTOMATIC1111 foi criado no GitHub no mesmo dia: uma interface para navegador, construída com a biblioteca Gradio e disponibilizada sob a licença AGPL-3.0, que dispensava a digitação de comandos Python. O repositório conta hoje com mais de 160.000 estrelas. A interface oferece abas para geração de imagens a partir de texto, geração de imagens a partir de imagens, edição com máscara e ampliação, além de uma imensa biblioteca de extensões.

Como todas as ferramentas locais, ela roda na sua máquina e abre no navegador no endereço http://127.0.0.1:7860, sem nunca sair da sua rede local por padrão. Os prompts, as configurações e as imagens permanecem no seu disco, disponíveis para consulta e reutilização offline.

• Stable Diffusion: as versões e qual escolher

#Do que você precisa

As placas AMD funcionam nativamente no Linux com ROCm. No Windows, o wiki oficial é claro: « Windows+AMD support has not officially been made for webui », e a opção prática passa pelo fork comunitário DirectML de lshqqytiger, no qual o treinamento ainda não funcionava segundo a página do wiki, editada em janeiro de 2024. Nos Macs com Apple Silicon, o wiki oficial documenta uma instalação via Homebrew e o script webui.sh: a maioria das funções funciona, e o treinamento é muito lento e consome muita memória. A NVIDIA continua sendo a opção com melhor suporte pelo projeto.

#Instalação em Windows e Linux

1. 01
   Instalar o Python 3.10.6

   Pelo python.org, marcando « Add Python to PATH ». O README especifica que as versões mais recentes não oferecem suporte ao torch: mantenha a versão 3.10.6, mesmo que o mesmo README permita a 3.11 para algumas distribuições Linux muito recentes.
2. 02
   Instalar o Git

   Git for Windows no Windows; o pacote git da sua distribuição no Linux.
3. 03
   Clonar o repositório e executar o script

   Em um diretório com caminho curto, sem espaços nem acentos. No Windows, o script é webui-user.bat; no Linux, webui.sh.
4. 04
   Aguardar na primeira execução

   O script baixa o PyTorch e as dependências, que somam vários gigabytes: reserve de dez minutos a meia hora. Quando um endereço local aparecer, abra-o no navegador.

git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui

# Windows
webui-user.bat

# Linux (après : sudo apt install git python3.10-venv libgl1 libglib2.0-0)
./webui.sh

#Onde colocar os modelos

models/Stable-diffusion

Os checkpoints, ou seja, os arquivos principais do modelo, no formato .safetensors.

models/Lora

Os LoRA, que adicionam um estilo ou um tema a um modelo base.

models/VAE

VAEs opcionais; muitos checkpoints SDXL incluem o seu próprio.

extensions

As extensões, geridas a partir da aba com o mesmo nome.

outputs

Suas imagens, organizadas por modo e por data.

Uma instalação nova não contém necessariamente um modelo: as versões antigas baixavam automaticamente o SD 1.5 na primeira execução, o que não é mais garantido. Baixe um checkpoint SDXL no Hugging Face, coloque-o na pasta models/Stable-diffusion, depois clique no ícone de atualização ao lado do seletor de modelo. Use apenas arquivos .safetensors: o formato antigo .ckpt pode executar código ao abrir, como detalhado abaixo.

• Hugging Face: encontrar e verificar um arquivo de modelo

#Opções de inicialização de acordo com sua VRAM

As opções devem ser inseridas na linha COMMANDLINE_ARGS do arquivo webui-user.bat no Windows ou webui-user.sh no Linux.

set COMMANDLINE_ARGS=--xformers --medvram-sdxl --autolaunch

#Configurações para uma primeira imagem

Descreva em vez de dar ordens, em inglês, o tema primeiro: « portrait of an elderly fisherman, window light, 85mm, shallow depth of field » funciona melhor do que uma lista de palavras-chave isoladas. O prompt negativo lista o que deve ser evitado, por exemplo « blurry, deformed hands, extra fingers, low quality » para eliminar os defeitos mais comuns. Uma função importante de se conhecer cedo: a aba PNG Info relê o prompt e todos os ajustes de qualquer imagem gerada pela interface, permitindo reproduzir ou ajustar uma geração bem-sucedida sem ter que reescrever tudo.

#A1111, Forge ou ComfyUI em 2026

O veredito é simples. Escolha A1111 se você está seguindo um curso, um tutorial ou uma extensão escritos para ele, ou se sua instalação atual faz o que você precisa em SD 1.5 e SDXL. Para uma instalação nova com esse estilo de interface, considere o Forge: é um projeto derivado criado por lllyasviel, autor do ControlNet e do Fooocus, que busca melhorar a gestão de recursos e oferece suporte ao Flux, mantendo a mesma forma de uso à qual você está acostumado. O próprio repositório do Forge diz: como o projeto original está “almost static now”, o Forge se ressincroniza com ele “every 90 days, or when important fixes”. Mas o próprio repositório do Forge não recebe commits na sua branch principal desde junho de 2025: a continuidade fica a cargo de um fork comunitário, o Forge Neo de Haoming02, cujo README anuncia suporte a modelos recentes (Qwen-Image, Wan 2.2, Z-Image) e que ainda recebia atualizações no final de setembro de 2026. Em um projeto comunitário, verifique sua atividade antes de se comprometer com ele. Escolha o ComfyUI para modelos atuais, vídeo ou pipelines reprodutíveis.

• ComfyUI: instalação e primeiros passos
• Fooocus: a opção mais simples para começar
• Kit de imagens com IA: configurações por placa de vídeo

#Extensões úteis e segurança dos modelos

#ADetailer: corrigir rostos e mãos automaticamente

Em uma imagem gerada em plano aberto, rostos e mãos continuam sendo o ponto fraco do Stable Diffusion. A extensão ADetailer, cujo repositório oficial a apresenta como uma extensão que “does automatic masking and inpainting”, detecta automaticamente essas áreas com um modelo de reconhecimento e então executa novamente um inpainting direcionado nessas áreas, com seu próprio prompt. Ela é instalada diretamente pela aba Extensions, colando seu endereço do GitHub em “Install from URL”.

O inpainting, justamente, é um dos quatro modos básicos da interface, junto com texto para imagem, imagem para imagem e ampliação: consiste em regenerar apenas uma área da imagem delimitada por uma máscara, mantendo o restante idêntico. O ADetailer automatiza essa operação em vez de exigir que você pinte a máscara manualmente em cada rosto.

#Arquivos .ckpt e .safetensors: o que o formato muda

Um arquivo .ckpt é uma serialização Python no formato pickle, um formato que pode executar código arbitrário ao ser aberto. Checkpoints maliciosos já circularam em plataformas comunitárias. O formato .safetensors resolve o problema na raiz: segundo o repositório oficial do formato, ele « implements a new simple format for storing tensors safely (as opposed to pickle) and that is still fast (zero-copy) ». O AUTOMATIC1111 incorpora uma verificação que bloqueia o carregamento de um pickle considerado suspeito antes de desserializá-lo, mas a regra mais simples continua sendo baixar apenas arquivos .safetensors, especialmente de fontes que não sejam Hugging Face ou Civitai.

• ControlNet: dominar a composição das suas imagens
• Fonte: repositório oficial do ADetailer
• Fonte: o formato .safetensors explicado pelo Hugging Face

#Erros comuns

CUDA out of memory

O tamanho da imagem ou do modelo ultrapassa a capacidade da VRAM. Adicione --medvram ou --medvram-sdxl, reduza a resolução, feche os outros aplicativos que usam a GPU.

Torch is not able to use GPU

Driver muito antigo ou GPU que não é da NVIDIA. Atualize o driver; o CUDA Toolkit não é necessário.

A instalação falha por causa das dependências

Versão incorreta do Python. Instale a 3.10.x, depois remova o diretório venv antes de reiniciar.

Uma RTX 50 recente não é utilizada

A versão estável inclui um PyTorch anterior à arquitetura Blackwell. Um colaborador do projeto documenta a solução em uma discussão no GitHub, atualizada em 1 de maio de 2025: migrar para a branch dev (git switch dev), que utiliza PyTorch 2.7.0 com suporte às RTX 50, depois executar uma vez com --reinstall-torch em COMMANDLINE_ARGS e remover a opção posteriormente. Caso contrário, ComfyUI.

• CUDA : driver, Toolkit, versões, o que realmente precisa ser instalado
• O repositório oficial no GitHub

#FAQ