Cómo actualizar ComfyUI

Aunque las actualizaciones de ComfyUI ya aparecen en varias guías de instalación, aquí reunimos todos los procedimientos en un solo sitio para que quede claro cómo actualizar.

¿Cómo actualizar ComfyUI?

Portable
Desktop
Instalación manual

ComfyUI Portable incluye scripts .bat prácticos para actualizar con facilidad.

Ubicación de los scripts de actualización

En la carpeta update de tu instalación Portable encontrarás estos scripts:

ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // Actualizar a la última versión de desarrollo
   ├── update_comfyui_stable.bat                    // Actualizar a la última versión estable
   └── update_comfyui_and_python_dependencies.bat   // ⚠️ PELIGRO: Reinstala las dependencias - puede causar conflictos

Asegúrate de tener una conexión a internet estable durante las actualizaciones.

⚠️ PELIGRO: ¡Usa update_comfyui_and_python_dependencies.bat con muchísima precaución!Este script es más exhaustivo que las actualizaciones normales y hará lo siguiente:

✅ Actualizar el propio código de ComfyUI
✅ Actualizar PyTorch para el portable estándar de Nvidia (actualmente CUDA 13.0 / cu130, Python 3.13)
✅ Reinstalar TODAS las dependencias de Python

Portable legado de Nvidia (CUDA 12.6 / cu126): Si instalaste el paquete portable aparte para GPUs Nvidia de la serie 10 y anteriores, esa compilación usa CUDA 12.6 y Python 3.12. No tomes cu130 como el destino correcto para ese paquete: reinstala o actualiza PyTorch con el índice de wheels cu126 que corresponda a ese portable, o vuelve a descargar el paquete cu126 desde la guía de instalación Portable.Riesgos:

Puede causar conflictos de dependencias con tu configuración actual
Puede romper nodos personalizados que dependen de versiones específicas de paquetes
Puede sobrescribir paquetes configurados manualmente
En un portable cu126 (u otro que no sea cu130), forzar un wheel cu130 puede romper el arranque de la GPU

⚠️ Usa este script solo cuando:

Necesites solucionar problemas de dependencias
Vayas a realizar actualizaciones de versión mayor
Para actualizaciones diarias, usa update_comfyui.bat en su lugar

Antes de ejecutar este script:

Haz una copia de seguridad de toda tu instalación de ComfyUI
Documenta las versiones de paquetes personalizados que hayas instalado
Confirma qué paquete portable tienes (cu130 estándar vs cu126 legado) — consulta ComfyUI Portable para Windows
Prepárate para reinstalar los nodos personalizados si es necesario

ComfyUI instalado manualmente requiere comandos de Git para completar las actualizaciones.

Requisitos previos a la actualización

Asegúrate de que tu sistema tenga Git instalado y de que ComfyUI se haya instalado mediante Git clone.

Pasos de actualización

Activar el entorno virtual

Primero, activa el entorno virtual de Python de ComfyUI (si estás usando uno):

# Para entorno conda
conda activate comfyui

# Para entorno venv
# Windows
venv\Scripts\activate
# macOS/Linux  
source venv/bin/activate

Obtener el código más reciente

Navega a tu directorio de instalación de ComfyUI y obtén el código más reciente:

cd <ComfyUI-installation-path>
git pull

Actualizar las dependencias

Instala o actualiza los paquetes de dependencias de ComfyUI:

pip install -r requirements.txt

Asegúrate de estar en el entorno virtual de ComfyUI para evitar contaminar el entorno de Python a nivel del sistema

Reiniciar ComfyUI

Después de actualizar, reinicia ComfyUI:

python main.py

Cambiar de versión (opcional)

Para cambiar a una versión específica, usa estos comandos:

# Ver el historial de commits
git log --oneline

# Cambiar a un commit específico
git checkout <commit-hash>

# Volver a la última versión
git checkout master

Se recomiendan las actualizaciones regulares para obtener las últimas funciones y correcciones de seguridad, mientras que las versiones estables se recomiendan para la estabilidad del sistema

Tipos de versión de ComfyUI

Según tu método de instalación, ComfyUI ofrece varias versiones de instalación. Los enlaces a continuación contienen las instrucciones de actualización para cada versión.

Comfy Desktop

Comfy Desktop permite la instalación independiente en Windows, macOS (Apple Silicon) y Linux (AppImage y .deb).

El código fuente está en GitHub

Las instalaciones de Desktop siguen por defecto la versión estable de ComfyUI. Si quieres cada última confirmación (commit), usa la versión portable o una instalación manual con git, o cambia el canal de actualización de la instancia a Latest on GitHub.

A continuación puedes elegir la instalación adecuada para tu sistema y hardware

Windows
macOS (Apple Silicon)
Linux

Guía de instalación de Comfy Desktop (Windows)

Adecuada para Windows 10 o posterior. Se recomienda GPU NVIDIA o AMD.

Guía de instalación de Comfy Desktop (Linux)

Instala el AppImage o el .deb, o compila y ejecuta desde el código fuente.

ComfyUI Portable (Windows)

La versión portable es una versión de ComfyUI que integra un entorno Python integrado independiente; con la versión portable puedes probar las últimas funciones, actualmente solo es compatible con el sistema Windows

Guía de instalación de ComfyUI Portable (Windows)

Compatible con la versión de ComfyUI para Windows que se ejecuta en GPU Nvidia o solo con CPU, siempre usa las últimas confirmaciones (commits) y es completamente portable.

Instalación manual

Guía de instalación manual de ComfyUI

Compatible con todos los tipos de sistema y de GPU (Nvidia, AMD, Intel, Apple Silicon, Ascend NPU, Cambricon MLU)

¿Qué se debe actualizar al actualizar ComfyUI?

Las actualizaciones de ComfyUI consisten principalmente en dos componentes:

Actualizar el código principal de ComfyUI
Actualizar las dependencias principales de ComfyUI, incluidas las dependencias necesarias de Python y los paquetes de dependencias funcionales de ComfyUI

Código principal: Nuevos nodos, soporte para nuevos modelos, nuevas funciones, etc. Dependencias principales: Incluye principalmente la funcionalidad del frontend de ComfyUI, las plantillas de flujo de trabajo, la documentación de ayuda de nodos, etc.

comfyui-frontend-package   # Funcionalidad del frontend de ComfyUI
comfyui-workflow-templates # Plantillas de flujo de trabajo de ComfyUI  
comfyui-embedded-docs      # Documentación de ayuda de nodos de ComfyUI
comfy-kitchen              # Utilidades principales de ComfyUI
comfy-aimdo                # Utilidades principales de ComfyUI

Estas dependencias principales se mantienen en repositorios separados:

ComfyUI_frontend - Interfaz del frontend y funciones interactivas
workflow_templates - Plantillas de flujo de trabajo prediseñadas
comfyui-embedded-docs - Documentación de ayuda de nodos
comfy-kitchen - Biblioteca de kernels rápida para inferencia de Diffusion con múltiples backends de cómputo
comfy-aimdo - Asignador de descarga bajo demanda de modelos de IA

Es importante entender la diferencia entre las versiones de desarrollo (nightly) y las estables (release):

Versión de desarrollo (nightly): Código del último commit, que te da acceso a las funciones más recientes, pero puede contener posibles problemas
Versión estable (release): Basada en lanzamientos estables, normalmente va por detrás de las versiones de desarrollo, pero ofrece mayor estabilidad. Damos soporte a las versiones estables después de que las funciones se prueban y estabilizan

Muchos usuarios suelen encontrarse en versiones estables (release) o en el canal Stable predeterminado de Desktop durante las actualizaciones, pero descubren que las funciones que necesitan solo están disponibles en las compilaciones de desarrollo o nightly. En Desktop, cambia a Latest on GitHub en Administrar → Actualizar. Para instalaciones portables o manuales, verifica si tu archivo local ComfyUI/requirements.txt coincide con las dependencias de la versión nightly para determinar si todas las dependencias admiten las funciones más recientes.

Problemas comunes al actualizar

Interfaz, plantillas de flujos de trabajo y nodos faltantes o desactualizados después de actualizar

Dependencias no actualizadas correctamente
Fallos en la actualización de dependencias

Muchos usuarios solo usan el comando git pull para actualizar el código de ComfyUI, pero descuidan la actualización de las dependencias principales, lo que provoca los siguientes problemas:

Funcionalidad del frontend faltante o anómala
No se encuentran las plantillas de flujos de trabajo recién añadidas
Documentación de ayuda de nodos desactualizada o faltante
Las nuevas funciones carecen del soporte correspondiente en el frontend

Después de usar el comando git pull, usa el entorno de ComfyUI correspondiente para ejecutar pip install -r requirements.txt y actualizar las dependencias.

Si las actualizaciones de dependencias fallan, normalmente se debe a problemas de red o de permisos del equipo. Cuando ocurren fallos en las dependencias principales durante las actualizaciones, el sistema recurre a versiones anteriores. Por lo general verás registros como este al iniciar:

Falling back to the default frontend.
ComfyUI frontend version: xxx

Sigue estos pasos para solucionar problemas:

Usa pip list en el entorno adecuado para ver los paquetes de dependencias instalados actualmente. Si encuentras inconsistencias de versión, usa pip install -r requirements.txt en el entorno de ComfyUI para intentar actualizar las dependencias de nuevo.
Si los problemas persisten después de actualizar, revisa tu conexión de red. Los usuarios de China continental pueden necesitar configurar un proxy para acceder de forma confiable a los repositorios de GitHub.
Si los problemas continúan, revisa los permisos del equipo. Si se requieren privilegios de administrador, ejecuta la línea de comandos con permisos de administrador.

Cómo actualizar correctamente las dependencias principales

Portátil
Instalación manual
Desktop

Método recomendado: usa el script por lotes ComfyUI_windows_portable\update\update_comfyui.bat, que actualiza tanto el código de ComfyUI como todas las dependencias de Python.Actualización manual de dependencias: Si necesitas actualizar las dependencias a mano, usa el siguiente comando:

# Abre la línea de comandos en el directorio de la versión portátil
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

Activar el entorno de Python

Si usas Conda para gestionar entornos de Python, activa tu entorno primero:

conda activate comfyui  # o el nombre de otro entorno

Actualizar el código

Ve al directorio raíz de ComfyUI y actualiza el código con Git:

cd <ComfyUI_ROOT_PATH>
git pull

Actualizar las dependencias

Actualiza las dependencias de ComfyUI: este paso es importante, sobre todo para comfyui-frontend-package:

pip install -r requirements.txt

Solución de problemas de actualización de dependencias principales

Si las actualizaciones de las dependencias principales fallan, sigue estos pasos para solucionar problemas:

Revisa la conexión de red

Si te encuentras en China continental, asegúrate de poder acceder a PyPI o configura un espejo nacional:

# Usando el espejo de la Universidad de Tsinghua
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

Instala los paquetes principales individualmente

Si la instalación por lotes falla, intenta instalar los paquetes individualmente. Primero revisa los requisitos de versión en ComfyUI/requirements.txt:Luego instala según las versiones especificadas (usa los números de versión de tu requirements.txt):

pip install comfyui-frontend-package==<version> 
pip install comfyui-workflow-templates==<version>
pip install comfyui-embedded-docs==<version>
pip install comfy-kitchen==<version>
pip install comfy-aimdo==<version>

Se recomienda usar los números de versión exactos especificados en ComfyUI/requirements.txt. No actualices a las versiones más recientes por tu cuenta, ya que esto puede causar problemas de compatibilidad.

¿Por qué no encuentro las funciones nuevas después de actualizar?

Este es uno de los problemas más comunes:

Si usas Desktop en el canal de actualización Stable, las funciones pueden ir por detrás de los commits más recientes de GitHub. Cambia el canal a Latest on GitHub en la pestaña Administrar → Actualizar cuando necesites funciones más recientes (Latest puede ser menos estable).
Para instalaciones Portable o manuales, asegúrate de estar en la versión de desarrollo (nightly) y no en la versión estable (release) cuando necesites los commits más recientes.

Además, asegúrate de que las dependencias correspondientes se hayan actualizado correctamente durante el proceso de actualización. Si los problemas persisten después de actualizar, consulta la sección Solución de problemas de actualización de dependencias para diagnosticar el problema.

¿Cómo cambiar entre las versiones de desarrollo (Nightly) y estable (Release)?

Diferencias entre versiones:

Versión de desarrollo (Nightly)
Versión estable (Release)

Características: Contiene el código del commit más reciente
Ventajas: Prueba primero las funciones y mejoras más recientes
Riesgos: Puede contener errores no descubiertos o factores de inestabilidad
Adecuada para: Desarrolladores, testers y usuarios que quieren probar las funciones más recientes

Portable
Instalación manual
Desktop

Usa update_comfyui.bat en lugar de update_comfyui_stable.bat:

# Versión de desarrollo (funciones más recientes)
double-click: update_comfyui.bat

# Versión estable
double-click: update_comfyui_stable.bat

# Cambiar a la versión de desarrollo
git checkout master
git pull

# Cambiar a la última versión estable
git fetch --tags
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

¿Qué hacer cuando aparecen errores después de actualizar?

Revisa las dependencias: Ejecuta pip install -r requirements.txt para asegurarte de que todas las dependencias estén actualizadas
Revisa los nodos personalizados: Algunos nodos personalizados pueden ser incompatibles con las versiones nuevas
Revierte la versión: Si los problemas son graves, puedes volver a una versión estable anterior

Si se presentan problemas, consulta nuestra página de solución de problemas para encontrar soluciones.

Solución de problemas

Aprende a solucionar problemas de ComfyUI

¿Cómo te mantienes al día con las funciones nuevas?

GitHub Releases: Consulta ComfyUI Releases para ver las actualizaciones de la versión estable
GitHub Commits: Revisa los commits más recientes para conocer el avance del desarrollo
Discusión en la comunidad: Sigue nuestro blog y Twitter para ver las novedades más recientes

Local (autoalojado)

Instalar nodos personalizados

Cómo actualizar ComfyUI