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.

Bonso Tools

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.

BonsoNet

Cómo se usa

  • Conecta la imagen a image.
  • Activa el modo con su casilla: canny, depth, openpose, scribble o anime.
  • Ajusta Megapixel para fijar la resolución exacta de salida: la imagen se reescala de forma proporcional.
  • La salida image va al nodo de ControlNet.

Detalles prácticos

  • Solo image y Megapixel aceptan 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_aux la 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.

Bonso Pose

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; F encaja; Ctrl+Z deshace; 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.

Mask Crop Bonso

Cómo se usa

  • Conecta la máscara a mask.
  • padding es el margen extra en píxeles alrededor de la zona (24 por defecto).
  • region_type elige qué se considera la zona: dominant (la parte blanca) o minority (la parte negra).
  • Salidas: cropped_mask y crop_data (compatible con Mask Paste Region), además de las coordenadas top, left, right, bottom, width y height.

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.

Bonso FileName

Cómo se usa

  • Escribe en las líneas Linea_1 a Linea_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 texto se 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.

Bonso Booleano

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 false si absolutamente todo su contenido está desactivado.
  • Si hay varias coincidencias no mira los estados: avisa Multi Match! y devuelve False.

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.

Switch Model A Switch Model B

Cómo se usa

  • Conecta un modelo a true_model y otro a false_model.
  • switch puede ser una casilla del nodo o el booleano de Bonso Booleano.
  • La salida model va 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.

Bonso Switch

Cómo se usa

  • Conecta lo que quieras a on true y a on false, o solo a una de las dos.
  • switch True deja pasar on true; switch False deja pasar on 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 true es una imagen, on false no 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.

Bonso Ghost A Bonso Ghost B

Cómo se usa

  • Conecta la imagen a image y usa su salida image donde 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

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. 🙋 Ask for provider support