Onde fica a pasta de modelos do ComfyUI? Caminhos nativos e adicionais

Numa instalação portátil ou manual do ComfyUI, a biblioteca nativa de modelos é ComfyUI/models/. Coloque cada ficheiro na subpasta do respetivo tipo de modelo — checkpoints em models/checkpoints, LoRAs em models/loras e VAEs em models/vae. Se os ficheiros já estiverem numa biblioteca partilhada, acrescente essa biblioteca como caminho adicional de modelos em vez de criar outra cópia completa.

A pasta nativa de modelos do ComfyUI

O ComfyUI não trata models como um único recipiente indiferenciado. Os carregadores procuram nas pastas registadas o tipo de modelo correspondente. A pasta LoRA nativa do ComfyUI é ComfyUI/models/loras. Um checkpoint colocado aí continua a ser um checkpoint; mudar a sua localização não altera o conteúdo do ficheiro.

ComfyUI/
└── models/
    ├── checkpoints/       # checkpoints completos de difusão
    ├── diffusion_models/  # pesos de difusão ou UNet
    ├── loras/             # LoRA e ficheiros de adaptadores relacionados
    ├── text_encoders/     # pesos do codificador de texto
    ├── vae/               # Modelos VAE
    └── controlnet/        # Modelos ControlNet e adaptadores T2I

O exemplo de configuração oficial atual também reconhece nomes antigos como unet e clip. Para uma biblioteca nova e organizada, prefira os nomes atuais apresentados acima. Outros tipos de nós podem registar mais pastas, pelo que um pacote de nós personalizados pode acrescentar uma localização de modelos que não conste deste mapa resumido.

ComfyUI Desktop: abra a pasta, não adivinhe

As instalações Desktop são fáceis de interpretar mal porque a aplicação gere uma parte maior da disposição. No ComfyUI Desktop, utilize Help → Open Folder → Open Model Folder. Isto abre a localização ativa e evita que copie um modelo para uma pasta de nome semelhante pertencente a uma instalação antiga.

Este é também o diagnóstico mais rápido quando um ficheiro não aparece. Confirme que está a consultar a pasta de modelos utilizada pela aplicação em execução, e não apenas o primeiro diretório ComfyUI devolvido por uma pesquisa no sistema de ficheiros.

Quando os caminhos adicionais de modelos são a resposta mais simples

Um caminho adicional é útil quando duas instalações do ComfyUI devem ver a mesma biblioteca, quando outra interface já controla os ficheiros ou quando os modelos grandes estão noutro disco. Indica ao ComfyUI onde mais deve procurar. Não copia, converte, funde nem cria uma cópia de segurança de um modelo.

O pormenor incómodo é que o ComfyUI portátil/manual e o ComfyUI Desktop não utilizam o mesmo nome de ficheiro de configuração:

• Instalação portátil ou manual: copie ComfyUI/extra_model_paths.yaml.example para ComfyUI/extra_model_paths.yaml e depois edite a cópia.
• Desktop no Windows: edite C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml.
• Desktop no macOS: edite ~/Library/Application Support/ComfyUI/extra_models_config.yaml.

Uma configuração de caminho adicional pequena e legível

Comece por uma única biblioteca identificada e apenas pelos tipos de modelos que realmente partilha. base_path é o diretório principal; os restantes valores são caminhos relativos ao mesmo.

shared_models:
  base_path: /Volumes/AI-Library/models/
  checkpoints: checkpoints
  loras: loras
  vae: vae
  controlnet: controlnet
  text_encoders: text_encoders
  diffusion_models: diffusion_models

No Windows, utilize um caminho absoluto do Windows para base_path, como D:\AI-Library\models\. Mantenha os espaços no caminho se forem reais; não invente aspas nem escapes até o analisador YAML os exigir. A configuração mais simples é normalmente aquela que pode comparar diretamente com as pastas no disco.

Reinicie, atualize e comprove um modelo conhecido

Guarde a configuração e reinicie o ComfyUI. O guia oficial de modelos também indica que r atualiza as definições dos nós, mas um reinício é uma verificação mais clara depois de alterar os caminhos dos modelos. Em seguida, comprove a configuração com ficheiros que consiga identificar:

1. Escolha um checkpoint conhecido e uma LoRA conhecida da biblioteca externa.
2. Confirme que cada um aparece no carregador adequado, não apenas algures na interface.
3. Carregue um pequeno fluxo de trabalho existente e confirme que ambos os ficheiros podem realmente ser abertos.
4. Mantenha a localização original inalterada até esse teste ser concluído com êxito após um novo reinício.

Se faltar um modelo, verifique, por esta ordem, a pasta de modelos ativa, a indentação YAML, base_path, a subpasta específica do tipo e a extensão do ficheiro. Uma análise YAML bem-sucedida não demonstra que um checkpoint foi classificado como checkpoint.

Um caminho adicional não é um plano de conservação

Um diretório partilhado pode evitar cópias de trabalho duplicadas, mas continua a ser armazenamento de execução ativo. Eliminar um elemento pode afetar todas as instalações do ComfyUI que apontem para o diretório. Da mesma forma, um ficheiro SafeTensors não passa a ter uma cópia de segurança apenas porque duas aplicações conseguem vê-lo.

O Tensor Archive entra depois de resolver a questão do ambiente de execução. Identifique uma família relacionada concluída — talvez um checkpoint base e os respetivos adaptadores — e depois arquive, verifique e restaure essa família separadamente. O Tensor Archive não reescreve a configuração do ComfyUI nem remove silenciosamente a pasta de origem.

Escolha o guia seguinte de acordo com o problema que realmente tem

Se precisar de preservar um fluxo de trabalho entre caminhos nativos e adicionais, utilize o guia de cópia de segurança de modelos do ComfyUI. Se o SSD já estiver cheio de adaptadores, siga o guia prático para libertar espaço em disco numa biblioteca LoRA. Para distinguir os métodos de treino e o artefacto de adaptador que produzem, leia LoRA vs. QLoRA.