- Bonso Tools
- Instalación
- Nodos incluidos
- BonsoNet — preprocesadores para ControlNet
- Bonso Pose — editor manual de pose
- Mask Crop Bonso — recorte cuadrado de máscara
- Bonso_FileName — ruta de carpetas con palabras
- Bonso Booleano — vigía de estado
- Bonso Switch Model — elegir entre dos modelos
- Bonso Switch — cualquier cosa
- Bonso Ghost — dejar pasar una imagen, o nada
- Nota
- Enlaces
- Instalación
Bonso Tools
Paquete de 10 nodos personalizados para ComfyUI. Nacido para arreglar cosas que los nodos de Crystools, WAS y Easy use no resolvían bien, y crecido hasta cubrir ControlNet, poses, máscaras, interruptores y flujo condicional.
Instalación
cd ComfyUI/custom_nodes
git clone https://huggingface.co/OSOBONSO/comfyui_Bonso_Tools.git
Reinicia ComfyUI. Los nodos aparecen en la categoría Bonso Tools.
Nodos incluidos
| Nodo | Para qué sirve |
|---|---|
| BonsoNet | Preprocesadores para ControlNet en 5 modos (Canny, Depth, OpenPose, Scribble, Anime Line Art) |
| Bonso Pose | Editor manual de poses sobre imagen de referencia, hueso por hueso |
| Mask Crop Bonso | Recorte cuadrado de máscara que se recoloca en los bordes |
| Bonso_FileName | Construye una ruta de carpetas con hasta 6 líneas de texto |
| Bonso Booleano | Vigila un grupo o un nodo y devuelve True o False |
| Bonso Switch Model | Elige entre dos MODEL según un interruptor |
| Bonso Switch | Elige entre dos valores de cualquier tipo |
| Bonso Ghost | Deja pasar una imagen, o hace desaparecer la rama |
BonsoNet — preprocesadores para ControlNet
Convierte una imagen en un mapa que ControlNet entiende. Tiene cinco modos y se usa uno a la vez: Canny (bordes), Depth (profundidad), OpenPose (esqueleto), Scribble (garabato) y Anime Line Art (línea de dibujo). El modo activo se ve en un cartel de color dentro del nodo.
Cómo se usa
- Conecta la imagen a
image. - Activa el modo con su casilla:
canny,depth,openpose,scribbleoanime. - Ajusta Megapixel para fijar la resolución exacta de salida: la imagen se reescala de forma proporcional.
- La salida
imageva al nodo de ControlNet.
Detalles prácticos
- Solo
imageyMegapixelaceptan conexiones; lo demás son casillas del propio nodo. - El color del cartel cambia según el modo, así se ve de un vistazo cuál está encendido.
Avisos
- Los cinco modos son excluyentes: si marcas dos, manda el último.
- Sin
comfyui_controlnet_auxla calidad baja, porque se usa procesado nativo.
Bonso Pose — editor manual de pose
Coloca un muñeco en T-pose sobre tu imagen de referencia y lo mueves hueso por hueso calcando la figura de referencia. No usa ningún modelo de detección.
Cómo se usa
- Botones: Cargar imagen, Editar pose, Esqueleto, Eliminar esqueleto y ENVIAR A.
- En el editor: arrastra cada articulación; la rueda del ratón hace zoom; Espacio o Mayús+arrastrar mueve la vista;
Fencaja;Ctrl+Zdeshace; clic derecho sobre una articulación la oculta. - ENVIAR A recibe el nombre de otro nodo del lienzo, por ejemplo Load Image, y le entrega la pose.
- Ancho de hueso cambia el grosor: se ve igual en el nodo, en el editor y en el PNG exportado.
Detalles prácticos
- La imagen de referencia se ve dentro del nodo, sobre fondo negro, con la opacidad que elijas.
- Todo se guarda en la carpeta
output/BONSO_POSES. - La salida conserva la proporción de la referencia, escalada a los megapíxeles pedidos (1 MP por defecto).
Avisos
- No hay manos ni cara: solo huesos del cuerpo.
- El nodo no tiene salidas por cable: la pose sale únicamente por ENVIAR A.
- Más allá de la imagen el editor es negro infinito, así que puedes sacar una articulación fuera del marco.
Mask Crop Bonso — recorte cuadrado de máscara
Busca la zona de interés de una máscara y devuelve un recorte cuadrado de ella. Es un reemplazo del Mask Crop Region de WAS con una diferencia importante: cuando el cuadrado se sale de la imagen, lo recoloca dentro en vez de deformarlo a un rectángulo.
Cómo se usa
- Conecta la máscara a
mask. paddinges el margen extra en píxeles alrededor de la zona (24 por defecto).region_typeelige qué se considera la zona:dominant(la parte blanca) ominority(la parte negra).- Salidas:
cropped_maskycrop_data(compatible con Mask Paste Region), además de las coordenadastop,left,right,bottom,widthyheight.
Avisos
- Si la máscara está vacía, devuelve una máscara vacía y las coordenadas a cero.
- El recorte es siempre cuadrado, tanto si la zona es ancha como si es alta.
Bonso_FileName — ruta de carpetas con palabras
Construye una ruta de carpetas con palabras. Escribes una palabra por línea, hasta seis, y el nodo las une con una barra inclinada. Sirve para alimentar con un texto cualquier casilla que pida una carpeta o un nombre.
Cómo se usa
- Escribe en las líneas
Linea_1aLinea_6. - Añadir (verde) abre una línea vacía más; Eliminar (gris) quita la última. Cuando no pueden actuar se quedan atenuados.
- La salida
textose conecta donde necesites la ruta.
proyecto + (línea vacía) + escena_01 -> proyecto/escena_01
Avisos
- Las líneas vacías se ignoran.
- Si todas están vacías, el nodo devuelve
Bonso. - No tiene entradas: es solo texto de salida.
Bonso Booleano — vigía de estado
Mira un grupo o un nodo del lienzo y devuelve True si está activo y False si está en bypass o desactivado. Es la pieza que permite encender y apagar partes del flujo sin borrar nada.
Cómo se usa
- Fila 1, buscar: elige grupo o nodo.
- Fila 2, nombre: el nombre exacto. No importan las mayúsculas ni los espacios de sobra; en un nodo puedes escribir su título o su tipo.
- Fila 3: la respuesta, alineada a la izquierda del nodo.
El resultado se recalcula cada cuarto de segundo y también justo antes de ejecutar, así que el booleano coincide siempre con el texto que se ve en el nodo.
Avisos
- En un grupo manda el estado del grupo: solo dice
falsesi absolutamente todo su contenido está desactivado. - Si hay varias coincidencias no mira los estados: avisa
Multi Match!y devuelveFalse.
Bonso Switch Model — elegir entre dos modelos
Elige entre dos conexiones MODEL, la línea morada, según un interruptor. Si switch es True devuelve true_model y si es False devuelve false_model. El modelo pasa tal cual, sin copiarse ni modificarse, así que el flujo se comporta como si el interruptor no estuviera.
Cómo se usa
- Conecta un modelo a
true_modely otro afalse_model. switchpuede ser una casilla del nodo o el booleano de Bonso Booleano.- La salida
modelva al KSampler o a donde haga falta.
Avisos
- La rama que no se usa se quita del trabajo antes de ejecutar, así que una línea rota al otro lado no detiene el flujo, siempre que el interruptor sea una casilla o venga de Bonso Booleano.
- La salida es MODEL de verdad: si la conectas a CLIP o a CONDITIONING, ComfyUI lo rechaza, y eso es lo correcto.
- Si la rama elegida no está conectada, el nodo avisa con un error claro.
Bonso Switch — cualquier cosa
Igual que el anterior, pero sirve para cualquier tipo de dato: imágenes, máscaras, latents, textos, números. Tiene dos entradas, on true y on false, y un interruptor switch.
Cómo se usa
- Conecta lo que quieras a
on truey aon false, o solo a una de las dos. switchTrue deja pasaron true;switchFalse deja pasaron false.- Puedes usar una sola rama: la otra puede quedarse vacía.
Avisos
- La rama que no se usa nunca se ejecuta, así que aunque tenga un error no rompe el flujo.
- Si el interruptor es una casilla o viene de Bonso Booleano, la rama inactiva también se quita del envío: ni siquiera se valida.
- El segundo conector solo admite el mismo tipo que el primero: si
on truees una imagen,on falseno acepta un modelo. El conector del interruptor queda libre para aceptar el booleano. - Si la rama elegida no está conectada, el nodo avisa con un error claro.
Bonso Ghost — dejar pasar una imagen, o nada
Deja pasar una imagen sin tocarla, con los mismos píxeles y el mismo objeto. Si no hay imagen, hace desaparecer esa parte del flujo sin inventar nada: ni imagen negra, ni cuadro de un píxel, ni error. Su aspecto es el de un conector, con una entrada y una salida.
Cómo se usa
- Conecta la imagen a
imagey usa su salidaimagedonde lo necesites, ideal para flujos con varios núcleos y salidas: desactiva las alertas de error innecesarias.
Avisos
- Si la imagen que llega no es válida, todo lo que venga después de este nodo simplemente no se ejecuta: es la forma honesta de decir que ahí no hay imagen.
- La entrada es opcional a propósito: así puede quedarse sin conectar sin dar error.
Nota
Este paquete se creó con asistencia de un agente de IA para solucionar problemas concretos con los nodos originales de Crystools, WAS, Easy use y otros.
Enlaces
- Repositorio de desarrollo (privado): https://github.com/willybonso/comfyui_Bonso_Tools
- Página de HuggingFace: https://huggingface.co/OSOBONSO/comfyui_Bonso_Tools










