ComfyUIFlowFields

🌊 ComfyUIFlowFields

Nodo nativo de ComfyUI que reimplementa la lógica de flow fields + partículas

✨ Features

• Curl noise divergence-free (incompresible) generado con fBm de sinusoides
• Simulación de partículas con bilinear sampling del campo
• 3 outputs:
  • particle_image — Trails renderizados en RGB
  • density_mask — Máscara de densidad donde pasaron partículas
  • flow_map — Mapa de flujo visual (dirección + magnitud)
• Parámetros controlables: seed, paleta de colores, modo de spawn, fade, velocidad, etc.

📦 Instalación

1. Copiar esta carpeta a tu directorio de nodos custom de ComfyUI:

   ComfyUI/custom_nodes/ComfyUIFlowFields/
   

2. Reiniciar ComfyUI (o refrescar si usas ComfyUI-Manager).
3. El nodo aparece en la categoría Jarart Tools como 🌊 ComfyUIFlowFields.

🔌 Uso en el grafo

[🌊 ComfyUIFlowFields]
        │
        ├── particle_image  → [Load Image] → [IP-Adapter] → ...
        │
        ├── density_mask    → [Set Latent Noise Mask] → [KSampler]
        │
        └── flow_map        → [Save Image] / [Preview]

Workflow de ejemplo: examples/workflow_example.json.

⚙️ Parámetros

Parámetro	Descripción
width / height	Resolución del canvas
particle_count	Número de partículas (10–5000)
noise_scale	Frecuencia del campo base. Más bajo = flujos más amplios y suaves
noise_octaves	Octavas del fractal. Más octavas = más detalle turbulento
speed	Velocidad de advección de las partículas
steps	Pasos de simulación. Más pasos = trails más largos
fade	Factor de persistencia del trail
line_width	Grosor de la línea de cada partícula
seed	Reproducibilidad
color_mode	rainbow, fire, ocean, monochrome, custom
spawn_mode	random, center, grid, circle
bg_color_hex	Color de fondo en hex (sin #)
flow_angle	Rotación del campo de flujo en grados (0–360). Rota simulación y flow_map

📁 Estructura del proyecto

ComfyUIFlowFields/
├── __init__.py        # registro del nodo (NODE_CLASS_MAPPINGS)
├── core/              # lógica pura: campo, partículas, render (sin ComfyUI)
├── nodes/             # definiciones de nodos ComfyUI
├── examples/          # workflows de ejemplo
├── tests/             # suite pytest (core sin torch; node requiere torch)
└── pyproject.toml     # metadata + registro en Comfy Registry

🧪 Desarrollo

python3 -m venv .venv
.venv/bin/pip install pytest numpy pillow
.venv/bin/pytest

tests/test_node.py se salta localmente si torch no está instalado; se valida dentro de ComfyUI.

📝 Licencia

MIT — adaptado del proyecto original FlowFieldStudio de javierjarart.