> ## Documentation Index > Fetch the complete documentation index at: https://docs.comfy.org/llms.txt > Use this file to discover all available pages before exploring further. # Nodos Personalizados > Los nodos personalizados en ComfyUI: en qué se diferencian de los nodos de Comfy Core y cómo instalarlos, actualizarlos y gestionar dependencias. ## Acerca de los nodos personalizados Después de instalar ComfyUI, descubrirás que incluye muchos nodos integrados. Estos nodos nativos se denominan nodos **Comfy Core**, los cuales son mantenidos oficialmente por ComfyUI. Además, existen numerosos [**nodos personalizados**](https://registry.comfy.org) creados por diversos autores de la comunidad de ComfyUI. Estos nodos personalizados aportan una amplia funcionalidad a ComfyUI, ampliando enormemente sus capacidades y los límites de sus funciones. En esta guía, veremos diversas operaciones relacionadas con los nodos personalizados, incluyendo la instalación, las actualizaciones, la desactivación, la desinstalación y la instalación de dependencias. Cualquier persona puede desarrollar sus propias extensiones personalizadas para ComfyUI y compartirlas con los demás. Puedes encontrar muchos nodos personalizados de la comunidad [aquí](https://registry.comfy.org). Si quieres desarrollar tus propios nodos personalizados, visita la siguiente sección para empezar: > **[Empieza a desarrollar nodos personalizados](https://docs.comfy.org/custom-nodes/overview.md)** > > Aprende cómo empezar a desarrollar un nodo personalizado ## Gestión de nodos personalizados En esta sección cubriremos: * Instalar nodos personalizados * Instalar dependencias de nodos * Control de versiones de nodos personalizados * Desinstalar nodos personalizados * Deshabilitar temporalmente nodos personalizados * Manejar conflictos de dependencias de nodos personalizados ### 1. Instalar nodos personalizados Actualmente, ComfyUI admite instalar nodos personalizados mediante varios métodos, entre ellos: * [Instalar mediante ComfyUI Manager (recomendado)](#instalar-mediante-comfyui-manager) * Instalar mediante Git * Instalación manual Recomendamos instalar nodos personalizados mediante **ComfyUI Manager**, que es una herramienta sumamente importante en el ecosistema de nodos personalizados de ComfyUI. Hace que la gestión de nodos personalizados (como buscar, instalar, actualizar, deshabilitar y desinstalar) sea sencilla: solo necesitas buscar el nodo que quieres instalar en ComfyUI Manager y hacer clic en instalar. Sin embargo, dado que actualmente todos los nodos personalizados se almacenan en GitHub, para las regiones que no pueden acceder a GitHub con normalidad, hemos escrito en esta guía instrucciones detalladas para los distintos métodos de instalación de nodos personalizados. Además, como recomendamos usar **ComfyUI Manager** para la gestión de complementos, te recomendamos usar esta herramienta para la gestión de complementos. Puedes encontrar su código fuente [aquí](https://github.com/Comfy-Org/ComfyUI-Manager). Por lo tanto, en esta documentación usaremos la instalación de ComfyUI Manager como ejemplo de instalación de un nodo personalizado, y complementaremos cómo usarlo para la gestión de nodos en las secciones de introducción correspondientes. **Instalar mediante ComfyUI Manager** Dado que ComfyUI Manager tiene una funcionalidad muy completa, usaremos un documento aparte para presentar el capítulo de instalación de ComfyUI Manager. Visita el siguiente enlace para aprender a usar ComfyUI Manager para instalar nodos personalizados. > **[Instalar nodos personalizados con ComfyUI Manager](https://docs.comfy.org/es/installation/install_custom_node.md#método-1-comfyui-manager-recomendado)** > > Aprende a usar ComfyUI Manager para instalar nodos personalizados **Instalar mediante Git** **1. Asegúrate de que Git esté instalado** Primero, debes asegurarte de que Git esté instalado en tu sistema. Puedes comprobar si Git está instalado ingresando el siguiente comando en la terminal de tu sistema: ```bash theme={null} git --version ``` Si Git está instalado, verás una salida similar a la siguiente: ![Windows Terminal](https://mintcdn.com/dripart/CGWmMjlFmU7msQ5S/images/concepts/custom_nodes/win_terminal.jpg?fit=max\&auto=format\&n=CGWmMjlFmU7msQ5S\&q=85\&s=c0e90164d3a1c8f9ed0f54164b16443b) Si aún no está instalado, visita [git-scm.com](https://git-scm.com/) para descargar el paquete de instalación correspondiente. Usuarios de Linux, consulten [git-scm.com/downloads/linux](https://git-scm.com/downloads/linux) para las instrucciones de instalación. > [!TIP] > > Para la versión Comfy Desktop, puedes usar la terminal de Desktop como se muestra a continuación para completar la instalación. > > ![Comfy Desktop Terminal](https://mintcdn.com/dripart/-uf1LbfqYw9IrpmN/images/concepts/custom_nodes/desktop_terminal.png?fit=max\&auto=format\&n=-uf1LbfqYw9IrpmN\&q=85\&s=333c167906d375f684542c19a938d2ff) **2. Clona el código del nodo personalizado al directorio** Después de completar la instalación de Git, necesitamos la dirección del repositorio del nodo personalizado. Aquí usamos la dirección del repositorio de ComfyUI-Manager como ejemplo: ```bash theme={null} https://github.com/Comfy-Org/ComfyUI-Manager ``` > [!TIP] > > Para regiones que no pueden acceder a GitHub con fluidez, puedes intentar usar otros sitios web de alojamiento de código para hacer un fork del repositorio correspondiente y luego usar esa dirección de repositorio para completar la instalación del nodo, como gitee, etc. Primero, debemos navegar al directorio de nodos personalizados de ComfyUI. Usando la versión portable de ComfyUI como ejemplo, si la ubicación de la carpeta es `D:\ComfyUI_windows_portable`, entonces deberías poder encontrar la carpeta de nodos personalizados en `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`. Primero, debemos usar el comando `cd` para entrar al directorio correspondiente: ```bash theme={null} cd D:\ComfyUI_windows_portable\ComfyUI\custom_nodes ``` Luego usamos el comando `git clone` para completar la instalación del nodo: ```bash theme={null} git clone https://github.com/Comfy-Org/ComfyUI-Manager ``` Si todo sale bien, verás una salida similar a la siguiente: ![Instalar nodos personalizados mediante Git](https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/concepts/custom_nodes/install_custom_nodes_by_git.jpg?fit=max\&auto=format\&n=Rig0_LOInmwVbVSB\&q=85\&s=80409dceca35c9d58c42dde48c4c53a5) Esto significa que has clonado correctamente el código del nodo personalizado. A continuación, debemos instalar las dependencias correspondientes. **3. Instalar dependencias** Consulta las instrucciones de la sección [Instalar dependencias de nodos](#2-instalar-las-dependencias-de-los-nodos) para la instalación de dependencias. **Instalación Manual** La instalación manual no es el método de instalación recomendado, pero sirve como opción de respaldo cuando no puedes instalar sin problemas usando git. > [!WARNING] > > Los plugins instalados de esta forma perderán la información del historial de versiones de git correspondiente y no facilitarán la gestión posterior de versiones. **1. Descargar el Paquete ZIP del Código del Nodo Personalizado** Para la instalación manual, primero necesitamos descargar el código del nodo correspondiente y luego extraerlo en el directorio adecuado. ![Descargar el Código del Nodo](https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/concepts/custom_nodes/download_zip.jpg?fit=max\&auto=format\&n=Rig0_LOInmwVbVSB\&q=85\&s=34fa06cf4580152428c5d2b55b192911) Visita la página del repositorio del nodo personalizado correspondiente: 1. Haz clic en el botón `Code` 2. Luego haz clic en el botón `Download ZIP` para descargar el paquete ZIP 3. Extrae el paquete ZIP **2. Copiar los Archivos al Directorio de Nodos Personalizados de ComfyUI** Copia el código extraído en los pasos anteriores al directorio de nodos personalizados de ComfyUI. Usando la versión portable de ComfyUI como ejemplo, si la ubicación de la carpeta es `D:\ComfyUI_windows_portable`, entonces deberías poder encontrar la carpeta de nodos personalizados en `D:\ComfyUI_windows_portable\ComfyUI\custom_nodes`. Copia el código extraído en los pasos anteriores al directorio correspondiente. **3. Instalar las Dependencias** Consulta las instrucciones de la sección [Instalando las Dependencias de los Nodos](#2-instalar-las-dependencias-de-los-nodos) para la instalación de las dependencias. ### 2. Instalar las dependencias de los nodos Todos los nodos personalizados requieren la instalación de las dependencias relacionadas. Por ejemplo, para ComfyUI-Manager, puedes visitar el archivo [requirements.txt](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/requirements.txt) para ver los requisitos de los paquetes de dependencias. En los pasos anteriores, solo clonamos el código del nodo personalizado de forma local y no instalamos las dependencias correspondientes, así que a continuación necesitamos instalar las dependencias correspondientes. > [!NOTE] > > En realidad, si usas ComfyUI-Manager para instalar plugins, ComfyUI Manager te ayudará automáticamente a completar la instalación de las dependencias. Solo necesitas reiniciar ComfyUI después de instalar el plugin. Esta es la razón por la que recomendamos encarecidamente usar ComfyUI Manager para instalar nodos personalizados. > > Pero quizás en algunas situaciones no puedas usar ComfyUI Manager para instalar nodos personalizados sin problemas, por lo que proporcionamos esta guía más detallada de instalación de dependencias. En el capítulo de [Dependencias](https://docs.comfy.org/es/basic-concepts/dependencies.md), presentamos el contenido relacionado con las dependencias en ComfyUI. ComfyUI es un proyecto basado en **Python**, y creamos un entorno de ejecución de **Python** independiente para ejecutar ComfyUI. Todas las dependencias relacionadas deben instalarse en este entorno de ejecución de **Python** independiente. Si ejecutas `pip install -r requirements.txt` directamente en la terminal a nivel del sistema, las dependencias correspondientes podrían instalarse en el entorno de **Python** a nivel del sistema, lo que hará que las dependencias sigan faltando en el entorno de ComfyUI e impedirá que los nodos personalizados correspondientes funcionen normalmente. Así que a continuación necesitamos usar el entorno de ejecución de Python independiente de ComfyUI para completar la instalación de las dependencias. Según las diferentes versiones de ComfyUI, usaremos diferentes métodos para instalar las dependencias correspondientes: **ComfyUI Portable** La versión ComfyUI Portable usa un Python Integrado ubicado en el directorio `\ComfyUI_windows_portable\python_embeded`. Necesitamos usar este Python para completar la instalación de las dependencias. Primero, inicia la terminal en el directorio de la versión portable, o usa el comando `cd` para navegar al directorio `\ComfyUI_windows_portable\` después de iniciar la terminal. ![Iniciar Terminal](https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/concepts/custom_nodes/open_terminal.jpg?fit=max\&auto=format\&n=Rig0_LOInmwVbVSB\&q=85\&s=ee4569d27b4ef901c5f67d8f795b448c) Asegúrate de que el directorio de la terminal sea `\ComfyUI_windows_portable\`, como se muestra a continuación para `D:\ComfyUI_windows_portable\` ![Terminal](https://mintcdn.com/dripart/CGWmMjlFmU7msQ5S/images/concepts/custom_nodes/terminal.jpg?fit=max\&auto=format\&n=CGWmMjlFmU7msQ5S\&q=85\&s=f6da2e8c4eef1016e6fde84ee5527ce0) Luego usa `python_embeded\python.exe` para completar la instalación de las dependencias: ```bash theme={null} python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Manager\requirements.txt ``` Por supuesto, puedes reemplazar ComfyUI-Manager con el nombre del nodo personalizado que realmente instalaste, pero asegúrate de que exista un archivo `requirements.txt` en el directorio del nodo correspondiente. **Comfy Desktop** > [!TIP] > > Dado que Comfy Desktop ya tiene ComfyUI-Manager y sus dependencias instalados durante el proceso de instalación, y esta guía usa ComfyUI Manager como ejemplo para la instalación de nodos personalizados, en realidad no necesitas realizar la instalación de las dependencias de ComfyUI Manager en la versión de escritorio. > Si no hay problemas inesperados, recomendamos usar ComfyUI Manager para instalar nodos personalizados, así no necesitas instalar las dependencias manualmente. ![Terminal de Comfy Desktop](https://mintcdn.com/dripart/-uf1LbfqYw9IrpmN/images/concepts/custom_nodes/desktop_terminal.png?fit=max\&auto=format\&n=-uf1LbfqYw9IrpmN\&q=85\&s=333c167906d375f684542c19a938d2ff) Luego usa el siguiente comando para instalar las dependencias del plugin correspondiente: ```bash theme={null} pip install -r .\custom_nodes\\requirements.txt ``` Como se muestra a continuación, esta es la instalación de dependencias de ComfyUI-Hunyuan3Dwrapper: ![Instalación de Dependencias de Comfy Desktop](https://mintcdn.com/dripart/-uf1LbfqYw9IrpmN/images/concepts/custom_nodes/install_dependencies.png?fit=max\&auto=format\&n=-uf1LbfqYw9IrpmN\&q=85\&s=ab31e7626f27d5a7da7171f985d1b305) **Usuarios con Entorno de Python Personalizado** Para los usuarios con entornos de Python personalizados, recomendamos usar `pip install -r requirements.txt` para completar la instalación de las dependencias. ### Control de versiones de los nodos personalizados El control de versiones de los nodos personalizados se basa en realidad en el control de versiones de Git. Puedes administrar las versiones de los nodos mediante Git, pero ComfyUI Manager ya ha integrado esta funcionalidad de administración de versiones muy bien. Muchas gracias a [@Dr.Lt.Data](https://github.com/ltdrdata) por brindarnos una herramienta tan conveniente. En esta sección, seguiremos explicando estos dos métodos diferentes de administración de versiones de plugins, pero si usas paquetes ZIP para la instalación manual, se perderá la información correspondiente del historial de versiones de git, lo que hará imposible realizar la administración de versiones. **Administración de versiones con ComfyUI Manager** > [!TIP] > > Dado que estamos iterando en ComfyUI Manager, la interfaz y los pasos más recientes pueden cambiar significativamente **1. Entrar a la interfaz de administración de nodos** Realiza las operaciones correspondientes como se muestra para entrar a la interfaz de ComfyUI Manager **2. Encontrar el paquete de nodos personalizados correspondiente** Puedes usar los filtros correspondientes para filtrar los paquetes de nodos instalados y luego realizar la administración de nodos correspondiente **3. Realizar el cambio de versión** Cambia a la versión correspondiente. El administrador te ayudará a completar las actualizaciones e instalación de las dependencias correspondientes. Por lo general, debes reiniciar ComfyUI después de cambiar de versión para que los cambios surtan efecto. **Administración de versiones con Git** **1. Navegar al directorio usando la línea de comandos** Encuentra la carpeta del directorio donde se ubica tu nodo correspondiente, por ejemplo `ComfyUI/custom_nodes/ComfyUI-Manager` Usa el comando `cd` para entrar a la carpeta correspondiente: ```bash theme={null} cd /ComfyUI/custom_nodes/ComfyUI-Manager ``` **2. Ver las versiones usando comandos de Git** Puedes usar el siguiente comando para ver todas las etiquetas y versiones disponibles: ```bash theme={null} git tag ``` Esto listará todas las etiquetas de versión, y puedes elegir la versión a la que deseas cambiar. **3. Cambiar a una versión especificada** Usa el siguiente comando para cambiar a una etiqueta o versión especificada: ```bash theme={null} git checkout ``` Reemplaza `` con la etiqueta de versión específica a la que deseas cambiar. **4. Cambiar a una versión de commit específica** Si deseas cambiar a una versión de commit específica, puedes usar el siguiente comando: ```bash theme={null} git checkout ``` Reemplaza `` con el hash del commit específico al que deseas cambiar. **5. Instalar las dependencias** Dado que las dependencias del paquete de nodos personalizados correspondiente pueden cambiar después del cambio de versión, debes reinstalar las dependencias del nodo correspondiente. Consulta las instrucciones de la sección [Instalando las dependencias del nodo](#2-instalar-las-dependencias-de-los-nodos) para entrar al entorno correspondiente e instalarlas. ### Desinstalación de nodos personalizados Por actualizar ### Deshabilitar temporalmente los nodos personalizados Por actualizar ### Conflictos de dependencias de nodos personalizados Pendiente de actualización ## ComfyUI Manager ![Interfaz de ComfyUI Manager](https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/concepts/core-concepts_nodes_manager.png?fit=max\&auto=format\&n=Rig0_LOInmwVbVSB\&q=85\&s=cea0de500828224b23b64cef84a31936) Esta herramienta actualmente está incluida por defecto en la [versión Desktop](https://docs.comfy.org/es/installation/desktop/windows.md), mientras que en la [versión Portable](https://docs.comfy.org/es/installation/comfyui_portable_windows.md) debes consultar las instrucciones de instalación en la sección [Instalar el Administrador](#1-instalar-nodos-personalizados) de este documento. > [!NOTE] > > A medida que ComfyUI continúa desarrollándose, ComfyUI Manager desempeña un rol cada vez más importante en ComfyUI. Actualmente, ComfyUI-Manager se ha unido oficialmente a la organización Comfy Org, convirtiéndose oficialmente en parte de las dependencias principales de ComfyUI, y continúa siendo mantenido por el autor original [Dr.Lt.Data](https://github.com/ltdrdata). Puedes leer [esta publicación del blog](https://blog.comfy.org/p/comfyui-manager-joins-comfy-org) para obtener más información. > En futuras iteraciones, optimizaremos enormemente el uso de ComfyUI Manager, por lo que la interfaz mostrada en esta documentación puede diferir de la última versión de ComfyUI Manager. ### Instalar el administrador Si estás ejecutando la aplicación servidor de ComfyUI, necesitas instalar el administrador. Si ComfyUI se está ejecutando, ciérralo antes de continuar. El primer paso es instalar Git, que es una aplicación de línea de comandos para el control de versiones de software. Git descargará el administrador de ComfyUI desde [github.com](https://github.com). Descarga e instala Git desde [git-scm.com](https://git-scm.com/). Después de instalar Git, navega al directorio del programa servidor de ComfyUI y entra en la carpeta llamada **custom\_nodes**. Abre una ventana de comandos o terminal. Asegúrate de que la línea de comandos muestre la ruta del directorio actual como **custom\_nodes**. Ejecuta el siguiente comando para clonar el repositorio de ComfyUI-Manager: ```bash theme={null} git clone https://github.com/Comfy-Org/ComfyUI-Manager.git ``` Esto descargará el administrador. Técnicamente, esto se denomina *clonar un repositorio de Git*. ### Detectar nodos faltantes Después de instalar el administrador, puedes detectar nodos faltantes en el administrador. ![Interfaz de ComfyUI Manager](https://mintcdn.com/dripart/Rig0_LOInmwVbVSB/images/concepts/core-concepts_nodes_manager.png?fit=max\&auto=format\&n=Rig0_LOInmwVbVSB\&q=85\&s=cea0de500828224b23b64cef84a31936) ## Desarrollar un nodo personalizado Si tienes algunas capacidades de desarrollo, consulta la documentación a continuación para aprender cómo comenzar a desarrollar un nodo personalizado. > **[Comienza a desarrollar nodos personalizados](https://docs.comfy.org/custom-nodes/overview.md)** > > Aprende cómo comenzar a desarrollar un nodo personalizado This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.