ModuleNotFoundError en ComfyUI: Cómo Instalar Dependencias Faltantes

Acabas de descargar un custom node prometedor para mejorar tus generaciones de imágenes con IA. Lo instalas, reinician ComfyUI con entusiasmo, y aparece: un error rojo que dice “ModuleNotFoundError: No module named ‘X’”. Frustrante. Este error es más común de lo que crees, especialmente si trabajas con nodos especializados que requieren librerías externas.

La buena noticia es que resolver ModuleNotFoundError en ComfyUI es completamente manejable una vez entiendas qué está pasando. En esta guía te mostraremos cómo instalar dependencias faltantes, resolver conflictos de módulos y evitar estos errores en el futuro.

Captura real del error

El traceback real de ModuleNotFoundError tal y como aparece en terminal

De un vistazo: Soluciones rápidas

Qué es ModuleNotFoundError en ComfyUI

El error ModuleNotFoundError en ComfyUI ocurre cuando un custom node intenta usar una librería Python que no está instalada en tu sistema. ComfyUI es modular: el núcleo funciona perfecto, pero cuando añades un nodo personalizado, este puede depender de herramientas externas como InsightFace, MediaPipe o Ultralytics.

El flujo típico es así:

1. Descubres un custom node interesante (por ejemplo, uno que detecta rostros automáticamente)
2. Lo instalas usando git clone en la carpeta custom_nodes
3. Reinician ComfyUI esperando que aparezca el nuevo nodo
4. Ves el error: “ModuleNotFoundError: No module named ‘insightface’”

Esto significa que el nodo está presente, pero le falta una dependencia Python crucial. La solución depende de si el nodo incluye un archivo de configuración de dependencias o si debes instalarlas manualmente.

💡 Consejo: ModuleNotFoundError indica que falta una librería Python. El nodo está instalado, pero sus dependencias no. La solución es identificar qué módulo falta e instalarlo en el entorno virtual correcto de ComfyUI.

Solución Estándar: Instalar con requirements.txt

La mayoría de custom nodes profesionales incluyen un archivo llamado requirements.txt. Este archivo es una lista de todas las dependencias que necesita ese nodo para funcionar correctamente. Es la forma más segura de instalar dependencias en ComfyUI.

Pasos para Instalar Dependencias Correctamente

Paso 1: Abre una terminal en la carpeta del custom node

Navega hasta tu carpeta de ComfyUI, luego a custom_nodes, y dentro a la carpeta específica del nodo problemático:

cd ruta/a/ComfyUI/custom_nodes/nombre_del_nodo

Paso 2: Activa tu entorno virtual

Es crítico que uses el mismo entorno virtual que ComfyUI. En Windows:

..\..\..\venv\Scripts\activate

En macOS/Linux:

../../../venv/bin/activate

Deberías ver (venv) al inicio de tu línea de comandos si la activación fue exitosa.

Paso 3: Instala las dependencias

pip install -r requirements.txt

Espera a que se complete la instalación. Verás líneas como “Successfully installed X-1.2.3” cuando termine.

Paso 4: Reinicia ComfyUI

Cierra completamente ComfyUI y vuelve a abrirlo. El nodo debería aparecer sin errores.

Si requirements.txt No Existe

Algunos nodos más simples no tienen este archivo. Busca en la documentación del nodo qué módulo necesita e instálalo directamente:

pip install nombre_modulo

Por ejemplo, si el error dice “No module named ‘cv2’”, ejecuta:

pip install opencv-python

⚠️ Importante: Siempre intenta pip install -r requirements.txt primero. Si no existe, busca la documentación del nodo para saber qué módulos instalar manualmente.

Módulos Comunes y Sus Soluciones

Ciertos módulos aparecen una y otra vez en custom nodes de ComfyUI. Aquí está la guía rápida para instalar dependencias de forma correcta:

Si tu error menciona uno de estos, usa el comando correspondiente en tu terminal (con el venv activado). La mayoría de problemas de ModuleNotFoundError se resuelven así.

Usar ComfyUI Manager para Evitar la Terminal

Si prefieres no abrir una terminal, ComfyUI Manager ofrece una alternativa visual para instalar dependencias sin necesidad de línea de comandos:

• Abre ComfyUI Manager (debe estar instalado como custom node)
• Busca el botón “Install Missing Custom Nodes” o “Install pip packages”
• Escribe el nombre del módulo que falta
• Manager lo instala automáticamente en el entorno correcto
• Revisa la pestaña “Missing nodes” que detecta automáticamente qué dependencias faltan

Este método es más seguro para usuarios nuevos porque evita errores de ruta o entorno virtual activado incorrectamente. Manager se encarga de usar el venv correcto automáticamente.

Troubleshooting: Cuando la Instalación No Funciona

A veces instalar las dependencias no resuelve el problema de inmediato. Aquí hay razones comunes y soluciones:

Instalaste en el Python del Sistema en Lugar del venv

Este es el error más frecuente. Si ejecutaste pip install sin activar el entorno virtual de ComfyUI, el módulo se instaló en la versión global de Python, no en donde ComfyUI lo busca.

Solución:

1. Activa el venv: En Linux/Mac, source venv/bin/activate; en Windows, venv\Scripts\activate
2. Verifica que está activado: which python (Linux) o where python (Windows) debe mostrar una ruta dentro de tu carpeta ComfyUI
3. Ejecuta pip install nombre_modulo nuevamente
4. Reinicia ComfyUI

Conflicto de Versiones

Un módulo puede estar instalado pero en una versión incompatible. Verifica qué tienes:

pip show nombre_modulo

Si el nodo requiere una versión específica (por ejemplo, transformers==4.30.0), instálala así:

pip install transformers==4.30.0

En Windows: Falta Visual C++ Build Tools

Algunos módulos como insightface y dlib necesitan compilar código C++. Si la instalación falla en Windows con errores de compilación, descarga e instala Visual C++ Build Tools desde visualstudio.microsoft.com. Selecciona “Build Tools for Visual Studio” y carga la carga de trabajo “Desarrollo para escritorio con C++”. Es gratuito y soluciona la mayoría de estos problemas.

📌 A tener en cuenta: Algunos módulos se instalan pero ComfyUI no los reconoce. Reinicia completamente ComfyUI (ciérralo desde el navegador y desde la terminal), espera 10 segundos y abre nuevamente. Si persiste, verifica que instalaste en la carpeta correcta del nodo usando pip show nombre_modulo. Debe estar en la carpeta venv de ComfyUI, no en la instalación global.

Instalación Manual de Módulos Individuales

Si el archivo requirements.txt no funciona o está vacío, instala manualmente cada dependencia:

pip install insightface onnxruntime
pip install mediapipe
pip install ultralytics
pip install accelerate

Ejecuta cada comando por separado y espera a que termine antes de pasar al siguiente. Esto te permite identificar cuál específicamente causa problemas si algo falla.

Mejores Prácticas para Evitar Estos Errores

Revisa la documentación del nodo antes de instalarlo. Los creadores buenos incluyen una lista de dependencias en el README.

Actualiza pip regularmente:

pip install --upgrade pip

Una versión antigua de pip puede tener problemas instalando ciertos módulos.

Mantén tu entorno limpio. Si instalas muchos nodos, considera hacer una copia de seguridad de tu carpeta custom_nodes y limpiar los que no uses. Usa versionamiento en requirements.txt. Si creas tu propio nodo, especifica versiones exactas para que otros no tengan conflictos.

Preguntas Frecuentes

P: ¿Puedo instalar dependencias sin usar el terminal?

R: Sí. ComfyUI Manager tiene la opción ‘Install pip packages’ en su menú. Escribe el nombre del módulo faltante y Manager lo instala en el entorno correcto. También revisa la pestaña ‘Missing nodes’ que detecta automáticamente qué falta.

P: Ejecuté pip install pero sigue dando el mismo error. ¿Por qué?

R: Instalaste en el Python del sistema en lugar del venv de ComfyUI. Activa el entorno virtual primero: en Linux/Mac, source venv/bin/activate; en Windows, venv\Scripts\activate. Después ejecuta pip install. Verifica con which python (Linux) o where python (Windows) que apunta al venv.

P: ¿Por qué insightface da error incluso después de instalarlo?

R: insightface requiere Microsoft Visual C++ Build Tools en Windows. Descárgalos desde visualstudio.microsoft.com (Build Tools for Visual Studio, carga de trabajo ‘Desarrollo para escritorio con C++’). Sin esto, la compilación de extensiones C++ falla aunque pip no muestre error.

P: ¿Qué hago si dos custom nodes necesitan versiones incompatibles de una librería?

R: Es un conflicto de dependencias, frecuente con transformers o numpy. Opciones: (1) instala la versión más reciente compatible con ambos, (2) usa un entorno virtual separado para el nodo conflictivo, (3) reporta el conflicto al autor del nodo en GitHub.

P: ¿Necesito desinstalar el módulo antes de reinstalarlo?

R: No es necesario, pero si tienes problemas puedes hacerlo: pip uninstall nombre_modulo -y seguido de pip install nombre_modulo. Esto asegura una instalación limpia.

P: ¿Por qué algunos módulos pesan tanto (como torch)?

R: Torch es el framework de deep learning que ComfyUI usa. Pesa porque incluye modelos precompilados y librerías de GPU. Es normal que tome varios gigabytes.

P: ¿Puedo instalar módulos globalmente en lugar de en el venv?

R: Técnicamente sí, pero es mala práctica. El entorno virtual mantiene tus dependencias aisladas y evita conflictos con otros proyectos Python.

P: ¿Qué hago si pip install se queda colgado?

R: Presiona Ctrl+C para cancelar. Luego intenta con pip install --no-cache-dir nombre_modulo para evitar problemas de caché.

Sigue leyendo

Si quieres profundizar en la configuración de ComfyUI, consulta nuestra guía sobre optimización de entornos virtuales en proyectos de IA. También te recomendamos explorar cómo resolver conflictos avanzados de dependencias en Python cuando trabajas con múltiples custom nodes simultáneamente. Y si planeas crear tus propios nodos, descubre las mejores prácticas para estructurar requirements.txt y evitar que otros usuarios enfrenten ModuleNotFoundError.

Conclusión

🏆 Nuestra recomendación

El ModuleNotFoundError en ComfyUI es un obstáculo común pero completamente resoluble. Si eres usuario principiante → usa ComfyUI Manager para instalar dependencias sin terminal. Si prefieres control total o trabajas con nodos complejos → domina la instalación manual con pip install -r requirements.txt en el venv correcto.

El 95% de los casos se arreglan simplemente navegando a la carpeta del custom node, activando el entorno virtual, y ejecutando pip install -r requirements.txt. Para los casos más complejos, identifica el módulo específico que falta, instálalo con la versión correcta, y reinicia ComfyUI.

Si trabajas regularmente con custom nodes, guarda esta guía como referencia. Y si encuentras un nodo que requiere módulos especiales, documenta la solución en una nota personal: cuando lo instales nuevamente en otro proyecto, tendrás la respuesta lista. La próxima vez que veas ese error rojo, sabrás exactamente qué hacer en menos de dos minutos.