Saltar al contenido principal
Comfy Desktop te permite administrar varias instancias de ComfyUI desde la vista Selector.

Tipos de instancia

Comfy Desktop admite cuatro tipos de instancias. Cada tipo aparece en su tarjeta y en la barra de título; las instancias Rastreadas comparten el icono de Independiente. La siguiente imagen señala las acciones clave disponibles en cada tarjeta de instancia: Menú ⋮ de la tarjeta de instancia: Administrar, Duplicar instancia, Mostrar en Finder, Exportar instantánea, Restaurar instantánea, Desinstalar
  1. Nueva instancia: Crea una instancia de ComfyUI desde cero. Consulta Crear una nueva instancia. También puedes crear una instancia a partir de un archivo de instantánea.
  2. Menú ⋮: Haz clic en el icono de tres puntos para abrir el menú de acciones de una instancia. Al hacer clic derecho en la tarjeta se abre el mismo menú.
  3. Administrar: Abre el panel Administrar para configurar la instancia (ruta, argumentos de inicio, directorios de modelos, variables de entorno). Consulta la página Administrar.
  4. Duplicar instancia: Copia una instalación independiente, con su propio entorno de Python y nodos personalizados. Consulta Duplicar una instancia.
  5. Mostrar en Finder, Mostrar en el Explorador o Mostrar en carpeta: Abre la carpeta de instalación en tu administrador de archivos. El nombre depende de tu sistema operativo.
  6. Exportar instantánea: Exporta la instantánea más reciente de la instancia a un archivo que puedas compartir. Consulta Compartir una instantánea.
  7. Restaurar instantánea: Revierte la instancia a una instantánea anterior. Consulta la página Instantáneas.
  8. Desinstalar: Elimina de forma permanente la instancia y todos sus archivos del disco. Consulta Desinstalar una instancia.
El menú también enumera acciones que solo aparecen en ciertos estados: Detener mientras la instancia se está ejecutando, Actualizar cuando hay una nueva versión de ComfyUI disponible, Migrar a Independiente para una instalación que puedas migrar, y Crear compilación para una instancia local que puedas publicar en un espacio de trabajo. Olvidar no forma parte de este menú; se encuentra en el panel Administrar, consulta Desinstalar una instancia.

Crear una nueva instancia

Haz clic en la tarjeta + (arriba a la izquierda) en la vista Chooser para agregar una nueva instancia de ComfyUI.
1

Crear una nueva instancia

El asistente Crear una nueva instancia en Windows, que señala el nombre (1), el modo de compilación (2), el canal de lanzamiento (3), el hardware (4) y la ubicación de instalación (5)
  1. Nombre: el nombre de tu instancia. El valor predeterminado es “ComfyUI”.
  2. Public Builds: la opción recomendada. Una instalación estándar de ComfyUI creada para el hardware que se detectó. Selecciona Managed Builds para instalar en su lugar una Build de uno de tus espacios de trabajo (consulta Espacios de trabajo y builds), o Remote Connection para conectarte a una instancia de ComfyUI que se ejecuta en otra máquina.
  3. Release: el canal de versión que se va a instalar. Stable (Recommended) viene preseleccionado.
  4. Hardware: Comfy Desktop detecta tu GPU y preselecciona la build correspondiente (NVIDIA, AMD, Intel Arc (XPU) o CPU). Cada opción muestra la versión de ComfyUI, la versión de Python y el tamaño de la descarga.
  5. Ubicación de Instalación: dónde se instala ComfyUI. En Windows, se recomienda encarecidamente usar un SSD y evitar la raíz de la unidad C:. El campo muestra el espacio libre de la unidad y una estimación del tamaño de la instalación cuando Comfy Desktop la conoce.
Si el espacio libre parece bajo, el asistente muestra un diálogo Low Disk Space. Elige Continuar de todos modos, o cancela y selecciona otra ruta.Diálogo Low Disk Space con el espacio libre frente al tamaño de instalación requerido, y los botones Cancelar y Continuar de todos modosComfy Desktop también rechaza las carpetas en las que no puede instalar. Revisa la carpeta en cuanto seleccionas una con Explorar…, explica el problema bajo Ubicación de Instalación y mantiene Continuar deshabilitado hasta que la carpeta sea una que pueda usar:
  • Dentro de los propios archivos de Comfy Desktop: la carpeta de la aplicación, sus recursos incluidos, su carpeta de datos y, en Windows, sus cachés del actualizador. Esos archivos se reemplazan cuando la aplicación se actualiza, así que una instalación allí se eliminaría. En macOS esto abarca todo lo que esté dentro del paquete de la aplicación Comfy Desktop.
  • Dentro de OneDrive (Windows): la sincronización en la nube ralentiza un entorno de Python grande y puede corromper archivos mientras se suben.
  • Dentro de una carpeta compartida de modelos, input o output: instalar allí puede corromper los archivos que comparten todas las instancias. Consulta Almacenamiento.
  • Dentro de la carpeta de otra instancia: las dos instalaciones entrarían en conflicto y podrían corromper datos. Ubicación de instalación definida en una carpeta de modelos compartida: el motivo aparece bajo el campo y Continuar permanece deshabilitado
En una máquina con GPU NVIDIA, la build de NVIDIA también revisa la versión del controlador. Si el controlador detectado es anterior a la 580, Comfy Desktop muestra un diálogo Update NVIDIA Driver con la versión detectada y el mínimo recomendado. Continuar de todos modos instala con el controlador actual.
2

Instalando

Progreso de la instalación: Descargando ComfyUI con porcentaje, velocidad de transferencia y pasos restantesComfy Desktop se encarga del resto. La pantalla de progreso ejecuta un stepper: las etapas finalizadas reciben una marca de verificación, la etapa activa muestra un indicador giratorio con una línea de detalle en vivo (porcentaje, velocidad de transferencia o nombre del archivo) y la siguiente etapa espera debajo. Cuando la instalación termina, ese mismo stepper continúa con el primer inicio, así que las filas siguen con Iniciando ComfyUI y las etapas de inicio.Una instalación creada a partir de una instantánea no se actualiza automáticamente, así que su stepper omite la última etapa y muestra en su lugar las dos etapas de restauración.Si elegiste una plantilla inicial, sus modelos se descargan en segundo plano durante las etapas anteriores, así que la instalación no espera a que terminen. Luego, el stepper termina con Descargando modelos de la plantilla una vez que ComfyUI ha iniciado, y esa fila permanece hasta que los archivos terminan. Selecciona Omitir y abrir ComfyUI en esa pantalla para abrir la instancia de inmediato; la transferencia sigue ejecutándose en la bandeja de descargas.
3

Elegir una plantilla

Paso para elegir un flujo de trabajo inicial con pestañas Video/Image/3D/Audio antes de que termine la instalaciónCuando la instalación termina, Comfy Desktop abre la biblioteca de plantillas, donde puedes elegir una plantilla de flujo de trabajo para empezar.Las plantillas que descargan modelos necesitan suficiente espacio libre para esos archivos. Si la unidad no puede contener los modelos de una plantilla, el asistente bloquea esa opción. Elige una plantilla más ligera o libera espacio. En discos muy pequeños, el paso de plantillas puede omitirse por completo.

Seguimiento de una Instalación Existente

Si ya tienes una instalación de ComfyUI (configurada manualmente desde el repositorio de Git o descargada como versión portable), puedes agregarla a Comfy Desktop sin crear una nueva. Abre el menú ☰ en la barra de título y selecciona Add Existing Instance. El menú ☰ abierto en el Panel, con Add Existing Instance marcado (2)
  1. El botón de menú ☰ en la esquina superior izquierda de la barra de título.
  2. Add Existing Instance: Abre el diálogo que rastrea una instalación existente de ComfyUI.

Detectar tu Instalación

En el diálogo, haz clic en Browse… y selecciona la carpeta de instalación. Comfy Desktop sondea la carpeta y completa el resto del diálogo. El menú desplegable Detected type muestra lo que encontró:
  • Standalone: Una instalación de Comfy Desktop. El sondeo busca un directorio standalone-env y ComfyUI/main.py.
  • Portable: Una compilación portable de Windows. El sondeo busca python_embeded, ya sea en la carpeta que seleccionaste o en una carpeta directamente dentro de ella.
  • Git Clone: Un clon del repositorio de ComfyUI. El sondeo busca un directorio .git.
  • Legacy Desktop: Una instalación de la aplicación ComfyUI Desktop anterior, reconocida por sus directorios models/, user/ y .venv. Consulta Migrar desde Legacy Desktop.
Si el sondeo no encuentra nada, el menú desplegable muestra No known install detected. Selecciona la carpeta que contiene la instalación en sí, no una carpeta principal ni una carpeta no relacionada.

Confirmar la Instalación Detectada

Cuando el sondeo termina, el diálogo muestra lo que encontró. Revisa las rutas antes de rastrear la instalación. El diálogo Add Existing Instance con un clon de Git detectado: ubicación de instalación, versión, repositorio, rama y entorno virtual
  • Install location: La carpeta que seleccionaste. Haz clic en la ruta para abrirla, o en Browse… para elegir otra. Para una compilación portable, apunta a la carpeta que contiene python_embeded.
  • Name: Cómo se lista la instancia en el Selector. El diálogo sugiere un nombre.
  • Detected type: Qué tipo de instalación contiene la carpeta.
  • Version, Repository y Branch: Se muestran para un clon de Git.
  • Virtual Environment: Se muestra para un clon de Git cuando Comfy Desktop encuentra uno, en .venv, venv, .env o env con un archivo pyvenv.cfg dentro. Browse… apunta la instancia a un entorno diferente.
Haz clic en Track Install para agregar la instancia. No se mueve ni se copia ningún archivo.

Rastreada vs Standalone

La diferencia clave entre una instalación Rastreada (Add Existing Instance) y una instalación Standalone es cómo se administran las actualizaciones:
Nota: Comfy Desktop ejecuta una instalación rastreada con su entorno de Python existente y no reinstala ComfyUI ni administra sus paquetes. La captura de instantáneas solo se ejecuta para instancias Standalone.

Iniciar, detener y reiniciar una instancia

↩ Volver a la descripción general

Iniciar una instancia

Haz clic en la tarjeta de una instancia en el Selector para iniciarla. Mientras ComfyUI arranca, la ventana muestra el progreso de inicio y, cuando el servidor está listo, la interfaz de ComfyUI.

Iniciar mientras otra instancia está en ejecución

Cuando inicias una instancia local mientras otra instancia local está en ejecución o iniciándose, Comfy Desktop muestra un diálogo Ya hay una instancia en ejecución que enumera las instancias que detendría:
  • Cerrar e iniciar: detiene las instancias enumeradas y luego inicia la que elegiste.
  • Ejecutar todas: inicia la nueva instancia junto a las que ya están en ejecución.
Descarta el diálogo para cancelar el inicio. Reiniciar una instancia nunca muestra este diálogo. Para dejar de verlo, desactiva Advertir antes de ejecutar varias instancias en Configuraciones de Escritorio → Preferencias.

Cuando el puerto ya está en uso

ComfyUI escucha en el puerto 8188 a menos que la instancia pase --port. Antes de iniciar ComfyUI, Comfy Desktop comprueba ese puerto, y el ajuste If Port is Busy de la instancia, en la pestaña Argumentos de inicio, decide qué ocurre cuando otro programa ya lo está usando:
  • Use next available port (asks if —port is set), el valor predeterminado: Comfy Desktop inicia ComfyUI en el siguiente puerto libre y lo indica en el progreso de inicio. Un puerto ocupado solo detiene el inicio cuando lo ocupa un ComfyUI de esta misma instalación, como se explica más abajo.
  • Ask what to do: el inicio se detiene en Port already in use, que indica qué está ocupando el puerto, y tú eliges el siguiente paso.
Establecer --port en Startup Arguments también hace que Comfy Desktop pregunte, incluso con el ajuste predeterminado, porque ese puerto se pidió a propósito. Port already in use: el inicio se detuvo y el mensaje indica la instancia que ocupa el puerto 8188, con Use next available port y Stop process and retry El mensaje indica qué ocupa el puerto:
  • Otra instancia de Comfy Desktop: el mensaje nombra esa instancia.
  • Un ComfyUI: el mensaje indica que parece una instancia de ComfyUI, incluidas las que iniciaste fuera de Comfy Desktop.
  • Cualquier otro programa: el mensaje nombra el proceso y Comfy Desktop no ofrece detenerlo.
Las acciones de esa pantalla:
  • Use next available port: inicia esta instancia en el siguiente puerto libre.
  • Stop process and retry: detiene a la fuerza el proceso que ocupa el puerto y vuelve a iniciar. Solo aparece cuando lo que ocupa el puerto parece un ComfyUI, y la confirmación advierte de que se perderá el trabajo sin guardar en ese ComfyUI.
  • Return to Dashboard: cancela el inicio.
Si Comfy Desktop puede determinar que lo que ocupa el puerto es un ComfyUI de la misma instalación, por ejemplo uno que iniciaste a mano en una terminal, se detiene en lugar de ofrecer otro puerto, porque una segunda copia usaría la misma base de datos. Detén esa copia, cierra la aplicación que la inició o selecciona Stop process and retry, y vuelve a iniciar. Comfy Desktop hace esta comprobación cuando el inicio activa el sistema de recursos: añade --enable-assets en ComfyUI 0.38.0 y posteriores, salvo que los argumentos de inicio de la instancia incluyan --disable-assets.

Un ComfyUI que dejó una sesión anterior

Antes de comprobar el puerto, Comfy Desktop busca un ComfyUI de la misma instalación que haya dejado en ejecución una sesión anterior de Comfy Desktop. Ese proceso todavía mantiene la base de datos de la instalación, así que un ComfyUI nuevo no podría iniciarse.
  • Todavía procesando un prompt: el inicio se detiene y lo indica. Stop it and launch detiene ese ComfyUI y cancela los prompts que está procesando. Si lo dejas en ejecución, se cancela este inicio.
  • Procesos que ya no responden en el puerto: el mensaje enumera sus PID y ofrece Stop them and launch.
  • Un proceso que no se cierra: el mensaje pide que lo termines manualmente y vuelvas a iniciar.

Detener una instancia

Selecciona Detener en el menú ⋮ de la tarjeta de la instancia. El servidor de ComfyUI se detiene y la ventana permanece abierta con una tarjeta ComfyUI está detenido. Selecciona Volver a iniciar ComfyUI para arrancar el servidor de nuevo, o Volver al Panel para regresar al Selector.

Reiniciar después de un fallo

Si ComfyUI no logra iniciarse o se cierra inesperadamente, la ventana permanece abierta con una tarjeta que describe lo que ocurrió:
  • ComfyUI no pudo iniciarse: la instancia no arrancó.
  • ComfyUI se cerró inesperadamente: el proceso se detuvo. Cuando Comfy Desktop puede leerlo, la tarjeta también muestra el código de salida, o la señal que terminó el proceso.
En Windows, un fallo puede reportar una violación de acceso a la memoria y señalar que algunos archivos de Microsoft Visual C++ Redistributable parecen faltar. Expande los registros de la tarjeta para ver los detalles y luego selecciona Reiniciar ComfyUI para iniciar de nuevo, o Volver para regresar al panel. Si ComfyUI se detiene porque no puede abrir la base de datos de recursos que guarda dentro de la instalación, el error con el que se detiene explica el motivo en lugar de reportar solo un código de salida:
  • Otro ComfyUI está usando la base de datos de esta instalación: cierra ese ComfyUI (o la aplicación que lo inició), o dale a uno de ellos su propia ubicación de base de datos con el argumento de inicio --database-url.
  • Cualquier otro fallo de la base de datos, desde una bloqueada por otro programa hasta una escrita por una versión más reciente de ComfyUI o imposible de crear en esa carpeta: el mensaje indica el archivo y la solución, y termina con la opción de iniciar la instancia sin el sistema de recursos, agregando --disable-assets a sus argumentos de inicio.

Desinstalar una instancia

↩ Volver a la descripción general Cuando quieres eliminar una instancia, dos acciones determinan si sus archivos permanecen en el disco. Olvidar y Desinstalar en el menú Más del panel Administrar
  1. Olvidar: Elimina la instancia de la aplicación sin borrar nada. La carpeta de instalación y todos sus datos permanecen en el disco. Úsalo cuando solo quieras limpiar la lista pero podrías necesitar la instancia más tarde.
  2. Desinstalar: Elimina permanentemente la instalación y todos sus archivos del disco. Los archivos de modelo en directorios compartidos no se ven afectados.
Desinstalar también está en el menú ⋮ de la tarjeta de la instancia. Olvidar no forma parte de ese menú; lo encuentras en el panel Administrar, en el menú Más en la parte inferior del panel. Una instalación que Comfy Desktop adoptó, como una migrada desde Legacy Desktop, no tiene la acción Olvidar.

Duplicar una instancia

↩ Volver a la descripción general Puedes duplicar una instalación independiente existente. Abre el menú ⋮ de la tarjeta y selecciona Duplicar instancia, o usa Duplicar instancia en el menú Más del panel Administrar. La copia obtiene:
  • Un nuevo entorno de Python
  • La misma versión de ComfyUI
  • Su propia configuración de nodos personalizados
Escribe un nombre para la copia duplicada cuando se te solicite. La copia se crea junto a la original. Las instalaciones en la nube, remotas y rastreadas no se pueden duplicar.

Editar una instancia

↩ Volver a la descripción general En el panel Administrar de una instancia, puedes:
  • Cambiar la ruta de instalación
  • Ajustar los argumentos de inicio
  • Modificar los directorios de modelos
  • Actualizar las variables de entorno
  • Renombrar la instancia, desde el nombre en la parte superior de la pestaña Acerca de o desde Renombrar en el menú Más
  • Cambiar la dirección de conexión de una conexión remota, en la pestaña Acerca de
Abre el panel Administrar haciendo clic derecho en la tarjeta de la instancia (o seleccionando Administrar en su menú ⋮).

Estado de error

Si una instalación encuentra un problema, aparece una insignia Error en su tarjeta. Selecciona la insignia para leer los detalles: el mensaje, el código de salida o la señal cuando Comfy Desktop tenga uno, y las últimas líneas de la salida de error. Iniciar o reiniciar la instancia borra la insignia. Si el problema vuelve, revisa los registros en Ubicaciones de datos.