Pastas do modelo Stable Diffusion: A1111, Forge e ComfyUI

Por que isso importa

Você baixa um checkpoint, uma LoRA, um VAE, um embedding, um modelo ControlNet e um upscaled. Cada UI espera-os em lugares diferentes. Se você rodar AUTOMATIC1111 (A1111), ComfyUI e SD.Next/Forge lado a lado, você ou triplica gigabytes de arquivos ou aprende a correspondência uma vez e compartilha uma única árvore de pastas.

Este artigo dá os caminhos exatos, as flags de CLI que os sobrescrevem, as extensões de arquivo que cada UI reconhece de fato e as duas maneiras práticas de manter uma biblioteca modelo canônica. Para fundo sobre formatos, veja Entendendo Formatos de Modelo.

Tabelas rápidas

A1111 (AUTOMATIC1111 WebUI)

Modelo | Pasta padrão (relativa à instalação) | Extensões de arquivo (oficiais) | Override de CLI | Fonte ------|-----------------|---------------------|--------------|------ Checkpoints (modelos base) | models/Stable-diffusion | .ckpt, .safetensors | --ckpt-dir | A1111 Features wiki LoRA / LyCORIS (v1.5+) | models/Lora | .pt, .safetensors | --lora-dir | A1111 CLI Arguments LoRA / LyCORIS (pré-v1.5) | models/LyCORIS | .safetensors (comunicado da comunidade) | — | Civitai article 1446 Textual Inversion embeddings | embeddings/ | .pt, images | --embeddings-dir | A1111 Features wiki VAE | models/VAE (convenção; --vae-dir default é None) | .ckpt, .pt, .bin, .safetensors para A1111 (não oficial, observado pela comunidade); o folder_paths.py do ComfyUI aceita todas as extensões de supported_pt_extensions | --vae-dir, --vae-path | A1111 CLI Arguments Upscalers (ESRGAN, RealESRGAN, SwinIR, BSRGAN, ScuNET, LDSR, DAT) | models/ESRGAN, models/RealESRGAN, models/SwinIR, … | .pth mais comum; sem restrições de extensão nas flags de CLI | --esrgan-models-path, --realesrgan-models-path, etc. | A1111 CLI Arguments Hypernetworks | models/hypernetworks | .pt, .ckpt, .safetensors | --hypernetwork-dir | A1111 Features wiki ControlNet | Depende da extensão (não está na documentação principal) | — | — | —

ComfyUI

Modelo | Pasta padrão (relativa à raiz do ComfyUI) | Extensões de arquivo (do folder_paths.py) | Fonte ------|--------------|-----------------|------ Checkpoints | models/checkpoints | .ckpt, .pt, .pt2, .bin, .pth, .safetensors, .pkl, .sft | ComfyUI folder_paths.py LoRA | models/loras | Igual ao acima | ComfyUI folder_paths.py VAE | models/vae | Igual ao acima | ComfyUI folder_paths.py Textual Inversion embeddings | models/embeddings | Igual ao acima | ComfyUI folder_paths.py ControlNet / T2I-Adapter | models/controlnet, models/t2i_adapter | Igual ao acima | ComfyUI folder_paths.py Upscalers | models/upscale_models | Igual ao acima | ComfyUI folder_paths.py

SD.Next (Forge)

Flag | Padrão | Notas | Fonte -----|--------|-------|------ --models-dir | models/ | Diretório base de todas as categorias de modelo | SD.Next CLI Arguments --data-dir | ./ | Base de dados do usuário; sobrescrito por --models-dir | SD.Next CLI Arguments --ckpt | — | Checkpoint único para carregar ao iniciar | SD.Next CLI Arguments As convenções de subpasta (LoRA, VAE, embeddings, ControlNet) não estão documentadas explicitamente na referência de CLI pública; o projeto é um fork do A1111 e, na prática, espelha a estrutura do A1111.

Extensões de arquivo: o que realmente funciona

Extensão | A1111 | ComfyUI | Notas | Fonte ---------|-------|---------|-------|------ .safetensors | ✅ Checkpoints, LoRA, VAE | ✅ Todos os tipos | Preferido; seguro, rápido, provável a alteração | ComfyUI folder_paths.py .ckpt | ✅ Checkpoints | ✅ Todos os tipos | Pickle legado do PyTorch; pode conter código arbitrário — só carregue arquivos de fontes confiáveis | ComfyUI folder_paths.py .pt / .bin | ✅ LoRA, embeddings, hypernetworks | ✅ Todos os tipos | Formato PyTorch legado | ComfyUI folder_paths.py .pth | ✅ Upscalers (ESRGAN etc.) | ✅ Todos os tipos | Comum para modelos de upscaling | A1111 CLI Arguments .sft | ❓ | ✅ Todos os tipos | Raro; ComfyUI o reconhece | ComfyUI folder_paths.py

A tabela "Extra networks" do A1111 lista apenas .pt e .safetensors para LoRA, .pt e imagens para embeddings e .pt/.ckpt/.safetensors para hypernetworks. Ela não lista .safetensors para embeddings, embora fontes da comunidade afirmem que funciona. O conjunto supported_pt_extensions do ComfyUI inclui tudo acima para cada categoria de modelo.

Como compartilhar uma biblioteca de modelos entre as três UIs

Método 1: aponte cada UI para uma raiz comum (recomendado)

1. Escolha uma pasta canônica, ex.: ~/ai/models/ com subpastas:

   ~/ai/models/
   ├── checkpoints/
   ├── loras/
   ├── vae/
   ├── embeddings/
   ├── controlnet/
   └── upscale_models/

1. A1111 / SD.Next: inicie com --models-dir ~/ai/models (A1111) ou --models-dir ~/ai/models (SD.Next). Isso faz com que todas as subpastas relativas (Stable-diffusion, Lora, VAE, ESRGAN, etc.) resolvam nessa raiz.

1. ComfyUI: copie extra_model_paths.yaml.example para extra_model_paths.yaml na raiz do ComfyUI, depois edite a seção a1111::

   a1111:
     base_path: /home/you/ai/models   # ou C:\Users\you\ai\models
     checkpoints: checkpoints
     loras: loras
     vae: vae
     embeddings: embeddings
     controlnet: controlnet
     upscale_models: upscale_models

O ComfyUI vai procurar por essas subpastas exatas.

Por que isso funciona: o --models-dir do A1111 sobrescreve --data-dir e vira a base de todos os caminhos relativos de modelo. O extra_model_paths.yaml do ComfyUI foi desenvolvido explicitamente para esse mapeamento entre UIs; veja o arquivo de exemplo e o README do ComfyUI.

Método 2: symlinks / junções (sem alterar configuração)

Se prefere manter a estrutura de pasta padrão de cada UI, crie links das localizações esperadas de cada UI para sua biblioteca canônica.

OS | Comando / ação | Fonte ---|----------------|------ macOS | No Finder: segure Option (⌥) + Command (⌘) enquanto arrasta um arquivo/pasta de modelo do origem para o destino — cria um alias. Ou no terminal: ln -s ~/ai/models/checkpoints ~/stable-diffusion-webui/models/Stable-diffusion | A1111 Change model folder wiki Linux | ln -sf ~/ai/models/checkpoints ~/stable-diffusion-webui/models/Stable-diffusion | A1111 Change model folder wiki Windows (Admin) | mklink /J "C:\stable-diffusion-webui\models\Stable-diffusion" "C:\ai\models\checkpoints" (junção para diretórios) | A1111 Change model folder wiki

Erros comuns e soluções

Sintoma | Causa | Solução | Fonte --------|-------|---------|------ LoRA/LoHA/LoCon em models/LyCORIS invisíveis no A1111 v1.5+ | A partir da v1.5, todas as redes da família LyCORIS são servidas de models/Lora | Mova os arquivos .safetensors de models/LyCORIS para models/Lora | A1111 Features wiki VAE em models/VAE não aparece na lista de VAEs do SD | A lista não está na Quicksettings, ou a lista não foi atualizada após adicionar o arquivo | Adicione sd_vae em Configurações → Interface do usuário → Quicksettings, depois clique no botão de atualização. O A1111 carrega VAEs .safetensors, .ckpt e .pt — o suporte a .safetensors entrou em PR #6528, então converter o arquivo não é a solução. --vae-path carrega um arquivo específico, --vae-dir varre um diretório | A1111 CLI Arguments ComfyUI não mostra modelos após copiar arquivos para as pastas do A1111 | O ComfyUI não varre automaticamente os diretórios do A1111 | Crie extra_model_paths.yaml a partir do exemplo e descomente a seção a1111: com o caminho base do A1111 | README do ComfyUI Arquivos .pth de upscaled em models/Stable-diffusion não aparecem na aba ESRGAN | Cada tipo de upscaled tem sua própria subpasta (ESRGAN, RealESRGAN, SwinIR, BSRGAN, ScuNET, LDSR, DAT) | Mova os arquivos para a subpasta correta dentro de models/ | A1111 CLI Arguments

FAQ

Onde coloco os arquivos LoRA na AUTOMATIC1111? models/Lora (a partir da v1.5; versões anteriores usavam models/LyCORIS para as redes da família LyCORIS).

Posso usar a mesma pasta de modelo para ComfyUI e A1111? Sim. Inicie o A1111 com --models-dir apontando para uma raiz compartilhada e configure o extra_model_paths.yaml do ComfyUI para mapear as mesmas subpastas, ou crie symlinks/junções das pastas padrão de cada UI para uma biblioteca canônica. Veja o Método 1. Relacionado: Otimizando o uso de VRAM.

Que extensão de arquivo usa os modelos VAE? .ckpt, .pt, .bin e .safetensors ocorrem na natureza. O ComfyUI aceita todos para VAEs (segundo folder_paths.py). A documentação do A1111 não publica uma lista oficial de extensões de VAE; as flags de CLI passam o arquivo para o carregador, que trata vários formatos.

Por que o LyCORIS mudou de models/LyCORIS para models/Lora no A1111? A versão 1.5 adicionou uma extensão integrada que trata LoHA, LoKR, LoCon e outras redes da família LyCORIS como redes extras "Lora", consolidando-as em um único diretório. Veja o wiki de Features. Para contexto de treinamento, veja Guia de treinamento LoRA.

Como compartilho uma biblioteca de modelos entre várias interfaces de Stable Diffusion? Veja Método 1: aponte o --models-dir do A1111/SD.Next e o extra_model_paths.yaml do ComfyUI para uma árvore de pastas comum, ou use symlinks/junções das pastas padrão de cada UI para uma biblioteca canônica. Relacionado: Otimizando o uso de VRAM.

Onde o ControlNet procura seus modelos? No A1111, ControlNet é uma extensão — seu diretório de modelos é configurado nas configurações próprias da extensão, não pelo A1111 principal, e varia conforme a versão da extensão. Uma convenção comum observada em setups da comunidade é models/ControlNet, mas nenhum caminho canônico está documentado na documentação principal do A1111. No ComfyUI, o folder_paths.py principal mapeia controlnet para models/controlnet e t2i_adapter para models/t2i_adapter.

.ckpt é seguro ou devo converter para .safetensors? .ckpt usa o formato pickle do Python, que pode executar código arbitrário ao carregar. Carregue .ckpt apenas de fontes confiáveis. .safetensors foi desenvolvido para ser seguro e carrega mais rápido; converta quando possível (por exemplo, via CLI Python safetensors).

O que não está documentado (lacunas)

• Caminho padrão de ControlNet do A1111 — não está no wiki principal; depende da extensão.
• Diretórios de subpasta do SD.Next — apenas os de nível superior --models-dir, --data-dir e --ckpt estão documentados.
• Se o A1111 carrega embeddings .safetensors — a tabela de Features lista apenas .pt e imagens para embeddings/, mas relatos da comunidade dizem que .safetensors funciona.
• Diretório padrão de VAE do A1111 — --vae-dir tem o padrão None; models/VAE é uma convenção da comunidade, não um padrão documentado.
• Changelog das mudanças de caminho de modelo — apenas a migração LyCORIS→Lora (v1.5) está confirmada.