Skip to main content
Los nodos personalizados te permiten implementar nuevas funciones y compartirlas con toda la comunidad. Un nodo personalizado es como cualquier nodo de Comfy: recibe una entrada, hace algo con ella y produce una salida. Aunque algunos nodos personalizados realizan tareas muy complejas, muchos solo hacen una cosa. Aquí tienes un ejemplo de un nodo sencillo que recibe una imagen y la invierte. Unique Images Node Ejemplos de nodos personalizados: Si usas Claude Code para desarrollar, ComfyUI Custom Node Skills le proporciona a Claude un conocimiento completo del sistema de nodos de ComfyUI, que abarca tanto las API V3 como V1. Instálalo desde el marketplace de Claude Code o agrega la URL del repositorio para obtener 9 habilidades que cubren los conceptos básicos de nodos, entradas, salidas, tipos de datos, patrones avanzados, extensiones de frontend y empaquetado.

​
Modelo cliente-servidor

Comfy funciona con un modelo cliente-servidor. El servidor, escrito en Python, se encarga de todo el trabajo real: procesamiento de datos, modelos, difusión de imágenes, etc. El cliente, escrito en Javascript, se encarga de la interfaz de usuario. Comfy también se puede usar en modo API, en el que un cliente que no es Comfy (como otra interfaz de usuario o un script de línea de comandos) envía un flujo de trabajo al servidor. Los nodos personalizados se pueden clasificar en una de cuatro categorías:

​
Solo del lado del servidor

La mayoría de los nodos personalizados se ejecutan únicamente en el lado del servidor, ya que definen una clase de Python que especifica los tipos de entrada y salida, y proporcionan una función que se puede llamar para procesar las entradas y producir una salida.

​
Solo del lado del cliente

Algunos nodos personalizados introducen una modificación en la interfaz de usuario del cliente, pero no añaden funcionalidad principal. A pesar del nombre, puede que ni siquiera añadan nodos nuevos al sistema.

​
Cliente y servidor independientes

Los nodos personalizados pueden ofrecer funciones adicionales en el servidor y funciones adicionales (relacionadas) en la interfaz de usuario, como un nuevo widget para manejar un nuevo tipo de datos. En la mayoría de los casos, el control de flujo de datos de Comfy puede gestionar la comunicación entre el cliente y el servidor.

​
Cliente y servidor conectados

En un número reducido de casos, las funciones de la interfaz de usuario y el servidor necesitan interactuar directamente entre sí.
Cualquier nodo que requiera comunicación cliente-servidor no será compatible con su uso a través de la API.

​
Próximos pasos

Primeros pasos

Crea y registra un nodo personalizado funcional, paso a paso.

Python (Backend)

El contrato de la clase de nodo: propiedades, entradas y tipos de retorno.

JavaScript (UI)

Extiende el frontend de ComfyUI desde tu paquete de nodos.

Empaquetar y publicar

Publica tu nodo en el Comfy Registry.