ArtificialGuyBR

Home / Blog / Training LoRAs

LoRA Library: carpetas, vistas previas, ComfyUI y Kohya

Organiza modelos LoRA con convenciones de carpetas, nombres de vista previa y metadatos. Configura ComfyUI LoRA Manager y Kohya GUI.

8 sources cited Training LoRAs

On this page

  1. TL;DR
  2. Cómo organizar los archivos LoRA en disco
  3. Imágenes de vista previa y metadatos
  4. ComfyUI LoRA Manager: instalación y funciones principales
  5. Instalación de Kohya GUI junto a ComfyUI
  6. Errores comunes y soluciones
  7. Preguntas frecuentes (FAQ)
  8. Guías relacionadas

LoRA Library: carpetas, vistas previas, ComfyUI y Kohya

TL;DR

  • Estructura de carpetas: almacena los LoRA en models/loras/ o añade rutas adicionales mediante extra_model_paths.yaml (ComfyUI) para que ComfyUI y Kohya GUI vean los mismos archivos.
  • Vistas previas: nombra los archivos de vista previa como <nombre-archivo-lora>.png|jpg|mp4> o <nombre-archivo-lora>.preview.png|jpg|mp4>; ComfyUI LoRA Manager los detecta automáticamente y omite las descargas de CivitAI.
  • Flujo de trabajo: instala ComfyUI LoRA Manager (nodo personalizado), abre http://127.0.0.1:8188/loras, activa la obtención automática y luego copia y pega LoRA con palabras desencadenantes y fuerza directamente en tu grafo. Instala Kohya GUI (bmaltais/kohya_ss) en un entorno virtual de Python 3.10 para entrenar nuevos LoRA.

Cómo organizar los archivos LoRA en disco

ComfyUI espera los archivos LoRA en models/loras/ de forma predeterminada (documentación de ComfyUI sobre LoRA). El archivo extra_model_paths.yaml.example oficial (esquema canónico) muestra la estructura canónica: un base_path que apunta a tu directorio raíz de ComfyUI y luego loras: models/loras/ debajo.

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

Cambia el nombre del archivo de ejemplo a extra_model_paths.yaml (elimina el .example) y reinicia ComfyUI. El nodo personalizado LoRA Manager lee la misma configuración, de modo que cualquier carpeta que añadas ahí aparece en su navegador sin enlaces simbólicos ni duplicados.

Convenciones de subcarpetas

Ni ComfyUI ni LoRA Manager imponen un esquema de subcarpetas. Patrones comunes de la comunidad:

Patrón | Caso de uso

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

models/loras/characters/ | LoRA de personajes models/loras/styles/ | LoRA de estilo artístico models/loras/concepts/ | LoRA de objetos o conceptos models/loras/[model-base]/ | Separar por modelo base (SD1.5, SDXL, Flux)

Elige un esquema y mantenlo constante; la búsqueda y el árbol de carpetas del Manager manejan la anidación automáticamente.

Imágenes de vista previa y metadatos

Reglas de nomenclatura para la detección automática

ComfyUI LoRA Manager (v0.5.4+) busca vistas previas locales antes de consultar la API de CivitAI. Reconoce dos patrones:

  • <nombre-archivo-lora>.[png|jpg|jpeg|mp4]
  • <nombre-archivo-lora>.preview.[png|jpg|jpeg|mp4]

Ejemplo: my-character.safetensors se empareja con my-character.png o my-character.preview.jpg. Las vistas previas de video (.mp4) funcionan igual. Si existe un archivo coincidente, el Manager lo usa y omite la obtención remota, lo que acelera enormemente la primera carga en bibliotecas grandes.

Fuente: "Your existing local preview images should have a name like <lora-file-name>.[png|jpg|jpeg|mp4] or <lora-file-name>.preview.[png|jpg|jpeg|mp4] to be automatically detected." — anuncio de ComfyUI LoRA Manager

Archivos sidecar de metadatos

LoRA Manager escribe un archivo sidecar .metadata.json junto a cada archivo de modelo. El esquema incluye trigger_words, base_model, rank, training_steps y el model_version_id de CivitAI cuando está disponible. No es un estándar de la industria — Kohya GUI no lo lee ni lo escribe — pero permite el flujo de trabajo de copiar y pegar con un solo clic del Manager (las palabras desencadenantes y la fuerza llegan al grafo automáticamente).

Campo | Ejemplo

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

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

ComfyUI LoRA Manager: instalación y funciones principales

Instalación

  1. En ComfyUI Manager (el instalador de nodos integrado), busca ComfyUI-Lora-Manager e instálalo.
  2. O clona manualmente: git clone https://github.com/willmiao/ComfyUI-Lora-Manager.git dentro de custom_nodes/.
  3. Reinicia ComfyUI.
  4. Abre http://127.0.0.1:8188/loras — la interfaz del Manager se carga en una pestaña nueva.

Qué hace

Función | Notas | Fuente

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

Obtención automática de vistas previas desde CivitAI | La primera sincronización es lenta en bibliotecas grandes; las visitas posteriores usan la caché | 11012 Copiar nombre de archivo al portapapeles | Con un solo clic, listo para el nodo LoraLoader | 11012 Cambiar imagen/video de vista previa | Recorre múltiples vistas previas por LoRA | 11012 Navegación por árbol de carpetas | Refleja tus directorios de extra_model_paths.yaml | 11795 Búsqueda con paginación | Añadido en v0.5.7 | 11012 Botón de menú en el encabezado de ComfyUI | Abre el Manager en una ventana nueva (v0.5.6+) | 11012 Pegado de flujo de trabajo con un clic | Copia las palabras desencadenantes y la fuerza predefinida en los nodos | 11012

Internos de rendimiento (breve)

El Manager usa caché de múltiples capas con precarga de caché y un observador del sistema de archivos para actualizaciones incrementales. Cuando añades o renombras un archivo de vista previa, el observador lo detecta y actualiza solo esa entrada — sin volver a escanear todo.

Instalación de Kohya GUI junto a ComfyUI

Kohya GUI (bmaltais/kohya_ss) es un entrenador basado en navegador para LoRA, LoHa, LoKr, Dreambooth, ajuste fino e Inversión Textual. Admite SD 1.5/2.x, SDXL, SD3, Flux.1, Lumina, Anima y HunyuanImage-2.1. La GUI genera los comandos CLI exactos que espera el sd-scripts subyacente, de modo que puedes copiarlos y pegarlos en una terminal si prefieres ejecuciones sin interfaz.

Windows (ruta probada)

  1. Instala Python 3.10.x (64 bits) desde python.org. Python 3.11/3.12 funcionan pero no están probados oficialmente.
  2. Abre PowerShell como administrador y ejecuta:
   Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
  1. Clona y entra al repositorio:
   cd kohya_ss
  1. Crea y activa un entorno virtual:
   python -m venv venv
   .\venv\Scripts\activate
  1. Instala las dependencias (el repositorio incluye un requirements.txt):
   pip install -r requirements.txt
  1. Inicia la GUI:
   python gui.py

Se abre en http://127.0.0.1:7860 de forma predeterminada.

Fuente: el README de Kohya sd-scripts especifica Python 3.10.x para Windows y el contexto de instalación en Kohya GUI está en CivitAI; el README de Kohya GUI enumera los modelos base admitidos y la generación automática de comandos CLI (Kohya GUI). La referencia del repositorio de ComfyUI LoRA Manager está en su README.

Linux / WSL2

Los pasos son casi idénticos. Usa el paquete Python 3.10 de tu distribución, omite el paso de la política de ejecución de PowerShell y ejecuta source venv/bin/activate en su lugar. El README de sd-scripts señala que el proceso es "casi el mismo que en Windows".

Apuntar Kohya a tu carpeta LoRA compartida

En la pestaña Settings de Kohya GUI, configura Output directory en la misma ruta que añadiste en loras: dentro de extra_model_paths.yaml. Los LoRA recién entrenados aparecen al instante en ComfyUI LoRA Manager — no hace falta reiniciar porque el observador del sistema de archivos detecta el nuevo .safetensors y su vista previa.

Errores comunes y soluciones

Síntoma | Causa | Solución

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

La primera carga del Manager tarda minutos | No hay vistas previas locales; el Manager descarga de CivitAI para cada modelo | Añade archivos <nombre-archivo-lora>.preview.png o espera a que se construya la caché inicial Falta la fuerza de CivitAI en el Manager | La API de CivitAI no devuelve suggested_strength aunque el creador lo haya configurado | Introduce la fuerza manualmente; el autor planea solicitar una actualización de la API | 11795 Kohya GUI falla al instalar torch | Desajuste de ruedas CUDA/CPU | Instala PyTorch primero con pip install torch --index-url https://download.pytorch.org/whl/cu121 (ajusta la versión de CUDA) El nuevo LoRA no aparece en el Manager | El observador de archivos no detectó la escritura (poco frecuente) | Actualiza el navegador o reinicia ComfyUI extra_model_paths.yaml se ignora | El archivo aún se llama .example o hay un error de sintaxis YAML | Cambia el nombre a extra_model_paths.yaml; valida con yamllint

Preguntas frecuentes (FAQ)

¿Cómo configuro directorios LoRA adicionales en ComfyUI? Crea extra_model_paths.yaml (copia desde extra_model_paths.yaml.example), añade tus rutas en loras: (separadas por barras verticales si son varias) y reinicia ComfyUI. LoRA Manager lee el mismo archivo.

¿Cuál es la convención de nomenclatura de vista previa recomendada para los modelos LoRA? Usa <nombre-archivo-lora>.png (o .jpg, .mp4) o <nombre-archivo-lora>.preview.png. El Manager detecta ambos automáticamente y omite la descarga de CivitAI.

¿Cómo puedo usar extra_model_paths.yaml con ComfyUI LoRA Manager? El Manager observa las mismas rutas loras: definidas en extra_model_paths.yaml. No se necesita configuración adicional — solo asegúrate de que el archivo tenga el nombre correcto y de que ComfyUI se haya reiniciado.

¿ComfyUI almacena en caché las imágenes de vista previa de LoRA? Sí. La caché de múltiples capas con precarga y actualizaciones incrementales del sistema de archivos hacen que las navegaciones posteriores sean casi instantáneas después de la primera sincronización.

¿Qué versión de Python requiere Kohya GUI en Windows? Python 3.10.x (64 bits) es la versión probada. 3.11/3.12 pueden funcionar pero no están validados oficialmente.

¿Puedo compartir una carpeta LoRA entre ComfyUI y Kohya GUI? Sí. Apunta el directorio de salida de Kohya a una de las rutas listadas en loras: dentro de extra_model_paths.yaml. Los nuevos modelos aparecen en el Manager automáticamente.

¿Por qué falta la fuerza sugerida de CivitAI en mi LoRA? La API de CivitAI no expone suggested_strength en su respuesta. El autor del Manager lo ha señalado y puede contactar al equipo de CivitAI.

¿Cómo actualizo ComfyUI LoRA Manager? Usa el botón "Update all" de ComfyUI Manager, o haz git pull dentro de custom_nodes/ComfyUI-Lora-Manager y reinicia ComfyUI.

Guías relacionadas