ArtificialGuyBR

Home / Blog / Training LoRAs

Biblioteca LoRA: Pastas, Previews, ComfyUI Manager e Kohya

Organize modelos LoRA com convenções de pastas, nomenclatura de previews e metadados. Configure ComfyUI Lora Manager e Kohya GUI.

8 sources cited Training LoRAs

On this page

  1. TL;DR
  2. Como Organizar Arquivos LoRA no Disco
  3. Imagens de Preview e Metadados
  4. ComfyUI LoRA Manager: Instalação e Recursos Principais
  5. Instalando Kohya GUI Junto ao ComfyUI
  6. Erros Comuns e Correções
  7. FAQ
  8. Guias Relacionados

Biblioteca LoRA: Pastas, Previews, ComfyUI Manager e Kohya

TL;DR

  • Estrutura de pastas: Armazene LoRAs em models/loras/ ou adicione caminhos extras via extra_model_paths.yaml (ComfyUI) para que ComfyUI e Kohya GUI vejam os mesmos arquivos.
  • Previews: Nomeie arquivos de preview como <nome-do-lora>.png|jpg|mp4> ou <nome-do-lora>.preview.png|jpg|mp4>; ComfyUI LoRA Manager os detecta automaticamente e pula downloads do CivitAI.
  • Fluxo de trabalho: Instale ComfyUI LoRA Manager (custom node), abra http://127.0.0.1:8188/loras, ative auto-fetch, depois copie e cole LoRAs com trigger words e strength direto no grafo. Instale Kohya GUI (bmaltais/kohya_ss) em venv Python 3.10 para treinar novas LoRAs.

Como Organizar Arquivos LoRA no Disco

ComfyUI espera arquivos LoRA sob models/loras/ por padrão. O oficial extra_model_paths.yaml.example mostra o layout canônico: um base_path apontando para a raiz do ComfyUI, depois loras: models/loras/ abaixo dele. Você pode adicionar múltiplos diretórios separados por pipe sob loras para abranger drives ou compartilhar uma biblioteca entre ComfyUI e Kohya GUI. A documentação de uso de LoRA do ComfyUI descreve o diretório models/loras/ e o nó LoraLoader.

comfyui:
  base_path: /path/to/ComfyUI
  loras:
    models/loras/
    /mnt/shared/loras/

Renomeie o arquivo de exemplo para extra_model_paths.yaml (remova o .example) e reinicie o ComfyUI. O custom node LoRA Manager lê a mesma configuração, então qualquer pasta adicionada lá aparece no navegador dele sem symlinks ou duplicatas.

Convenções de Subpastas

Nem ComfyUI nem LoRA Manager impõem um esquema de subpastas. Padrões comuns da comunidade: Padrão | Caso de Uso

|---------|----------

models/loras/characters/ | LoRAs de personagens models/loras/styles/ | LoRAs de estilo artístico models/loras/concepts/ | LoRAs de objetos/conceitos models/loras/[model-base]/ | Separar por modelo base (SD1.5, SDXL, Flux) Escolha um esquema e mantenha consistência; a busca e árvore de pastas do Manager lidam com aninhamento automaticamente.

Imagens de Preview e Metadados

Regras de Nomenclatura para Auto-Detecção

ComfyUI LoRA Manager (v0.5.4+) escaneia previews locais antes de acessar a API do CivitAI. Ele reconhece dois padrões:

  • <nome-do-arquivo-lora>.[png|jpg|jpeg|mp4]
  • <nome-do-arquivo-lora>.preview.[png|jpg|jpeg|mp4]

Exemplo: meu-personagem.safetensors combina com meu-personagem.png ou meu-personagem.preview.jpg. Previews em vídeo (.mp4) funcionam da mesma forma. Se um arquivo correspondente existir, o Manager o usa e pula o fetch remoto, o que acelera drasticamente o primeiro carregamento para bibliotecas grandes.

Fonte: "Seus previews locais existentes devem ter um nome como <nome-do-arquivo-lora>.[png|jpg|jpeg|mp4] ou <nome-do-arquivo-lora>.preview.[png|jpg|jpeg|mp4] para serem detectados automaticamente." — Anúncio do ComfyUI LoRA Manager

Sidecars de Metadados

LoRA Manager escreve um sidecar .metadata.json ao lado de cada arquivo de modelo. O schema inclui trigger_words, base_model, rank, training_steps e model_version_id do CivitAI quando disponível. Isso não é um padrão da indústria — Kohya GUI não lê nem escreve — mas habilita o fluxo de trabalho one-click copy-paste do Manager (trigger words + strength caem no grafo automaticamente). Campo | Exemplo

|-------|---------

trigger_words | ["ohwx", "woman", "portrait"] base_model | SDXL rank | 32 model_version_id | 123456

ComfyUI LoRA Manager: Instalação e Recursos Principais

Instalação

  1. No ComfyUI Manager (instalador de nodes embutido), busque ComfyUI-Lora-Manager e instale.
  2. Ou clone manualmente: git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git dentro de custom_nodes/.
  3. Reinicie o ComfyUI.
  4. Abra http://127.0.0.1:8188/loras — a UI do Manager carrega em nova aba.

O Que Ele Faz

Recurso | Notas | Fonte

|---------|-------|--------

Auto-fetch de previews do CivitAI | Primeira sincronização lenta para bibliotecas grandes; visitas posteriores usam cache | 11012 Copiar nome do arquivo para clipboard | One-click, pronto para node LoraLoader | 11012 Trocar preview imagem/vídeo | Cicla múltiplos previews por LoRA | 11012 Navegação em árvore de pastas | Espelha seus dirs do extra_model_paths.yaml | 11795 Busca com paginação | Adicionado na v0.5.7 | 11012 Botão de menu no header do ComfyUI | Abre Manager em nova janela (v0.5.6+) | 11012 One-click workflow paste | Copia trigger words + strength preset para nodes | 11012

Internos de Performance (Resumo)

O Manager usa cache multi-camada com preloading e watcher de sistema de arquivos para updates incrementais. Quando você adiciona ou renomeia um arquivo de preview, o watcher detecta e atualiza apenas aquela entrada — sem rescan completo.

Instalando Kohya GUI Junto ao ComfyUI

Kohya GUI (bmaltais/kohya_ss) é um trainer browser-based para LoRA, LoHa, LoKr, Dreambooth, fine-tuning e Textual Inversion. Suporta SD 1.5/2.x, SDXL, SD3, Flux.1, Lumina, Anima e HunyuanImage-2.1. A GUI gera os comandos CLI exatos que o sd-scripts subjacente espera, então você pode copiar e colar em terminal se preferir rodar headless.

Windows (Caminho Testado)

  1. Instale Python 3.10.x (64-bit) do python.org. Python 3.11/3.12 funcionam mas não são oficialmente testados.
  2. Abra PowerShell como Administrador e rode:
   Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
  1. Clone e entre no repo:
   git clone https://github.com/bmaltais/kohya_ss.git
   cd kohya_ss
  1. Crie e ative um virtual environment:
   python -m venv venv
   .\venv\Scripts\activate
  1. Instale dependências (o repo inclui requirements.txt):
   pip install -r requirements.txt
  1. Inicie a GUI:
   python gui.py

Abre em http://127.0.0.1:7860 por padrão.

Fonte: README do sd-scripts do Kohya detalha passos de instalação no Windows, requisito Python 3.10.x e paridade Linux/WSL2. Artigo da CivitAI 4855 traz contexto adicional sobre instalação do Kohya GUI no Windows e pré-requisitos de conhecimento em Python.

Linux / WSL2

Passos são quase idênticos. Use o pacote Python 3.10 da sua distro, pule o passo de execution-policy do PowerShell, e rode source venv/bin/activate em vez disso. O README do sd-scripts nota que o processo é "quase o mesmo do Windows."

Apontando Kohya para Sua Pasta LoRA Compartilhada

Na aba Settings do Kohya GUI, defina Output directory para o mesmo caminho que você adicionou sob loras: no extra_model_paths.yaml. LoRAs recém-treinados aparecem instantaneamente no ComfyUI LoRA Manager — sem restart necessário porque o file-system watcher detecta o novo .safetensors e seu preview.

Erros Comuns e Correções

Sintoma | Causa | Correção

|---------|-------|-----

Primeiro carregamento do Manager demora minutos | Sem previews locais; Manager baixa do CivitAI para cada modelo | Adicione arquivos <nome-do-lora>.preview.png ou aguarde cache inicial construir Strength sugerida do CivitAI ausente no Manager | API do CivitAI não retorna suggested_strength mesmo quando criador definiu | Insira strength manualmente; autor planeja solicitar update na API | 11795 Kohya GUI falha no torch install | Mismatch de wheel CUDA/CPU | Instale PyTorch primeiro via pip install torch --index-url https://download.pytorch.org/whl/cu121 (ajuste versão CUDA) Novo LoRA não aparece no Manager | File watcher perdeu a escrita (raro) | Atualize browser ou reinicie ComfyUI extra_model_paths.yaml ignorado | Arquivo ainda nomeado .example ou erro de sintaxe YAML | Renomeie para extra_model_paths.yaml; valide com yamllint

FAQ

Como configurar diretórios LoRA adicionais no ComfyUI? Crie extra_model_paths.yaml (copie de extra_model_paths.yaml.example), adicione seus caminhos sob loras: (separados por pipe para múltiplos), e reinicie o ComfyUI. O LoRA Manager lê o mesmo arquivo.

Qual a convenção recomendada de nomenclatura para imagens de preview de modelos LoRA? Use <nome-do-arquivo-lora>.png (ou .jpg, .mp4) ou <nome-do-arquivo-lora>.preview.png. O Manager auto-detecta ambos e pula download do CivitAI.

Como usar extra_model_paths.yaml com ComfyUI LoRA Manager? O Manager observa os mesmos caminhos loras: definidos no extra_model_paths.yaml. Nenhuma config extra necessária — apenas garanta que o arquivo tem o nome correto e reinicie o ComfyUI.

O ComfyUI faz cache de imagens de preview de LoRA? Sim. Cache multi-camada com preloading e updates incrementais de sistema de arquivos tornam navegações subsequentes near-instant após a primeira sincronização.

Qual versão do Python o Kohya GUI requer no Windows? Python 3.10.x (64-bit) é a versão testada. 3.11/3.12 podem funcionar mas não são oficialmente validadas.

Posso compartilhar uma pasta LoRA entre ComfyUI e Kohya GUI? Sim. Aponte o output directory do Kohya para um dos caminhos listados sob loras: no extra_model_paths.yaml. Novos modelos aparecem no Manager automaticamente.

Por que a strength sugerida do CivitAI está ausente para meu LoRA? A API do CivitAI não expõe suggested_strength na resposta. O autor do Manager notou isso e pode contatar a equipe do CivitAI.

Como atualizo o ComfyUI LoRA Manager? Use o botão "Update all" do ComfyUI Manager, ou git pull dentro de custom_nodes/ComfyUI-Lora-Manager e reinicie o ComfyUI.

Guias Relacionados