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.