ComfyUI-USCG-Distributed

ComfyUI-USCG-Distributed

Optional companion plugin for ComfyUI-Ultimate-Auto-Sampler-Config-Grid-Testing-Suite (USCG).

Adds distributed multi-machine grid generation to USCG — master/worker model that lets you run a big benchmark across multiple ComfyUI machines on your LAN.

Install

Via Comfy Manager (recommended):

1. Open Comfy Manager -> Custom Node Manager.
2. Search for "USCG Distributed".
3. Click Install. Restart ComfyUI.

Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/JasonHoku/ComfyUI-USCG-Distributed

Restart ComfyUI.

What this enables

After installing, the main USCG Builder UI's Distribution section becomes active. You can configure a master URL and worker URLs, sync models across machines, and run a grid across the cluster.

Why this is a separate plugin

The Distribution feature uses urllib.request.urlopen() with user-configured LAN URLs, plus socket.connect() for self-IP discovery — both trigger the Comfy Manager "Network operations on arbitrary req" review queue. By isolating this feature in its own plugin, main USCG releases pass the scanner cleanly. Only this plugin gets queued for review when it updates.

Network surface

This plugin makes outbound HTTP POST/GET requests to LAN addresses the user types into the Builder UI's Distribution panel (master and worker URLs). It also performs a UDP socket.connect(("8.8.8.8", 80)) at master setup time to discover the local LAN IP (no actual data is sent — just asks the kernel which IP would be used).

All network code lives in usrv_dist_network.py and usrv_dist_socket.py.

Cross-companion: Remote VAE

If you've also installed ComfyUI-USCG-RemoteVAE, workers can offload VAE decoding to HuggingFace endpoints. This plugin imports comfyui_uscg_remote_vae directly when worker jobs use remote VAE; without it, remote-VAE configs error cleanly with install instructions.

License

MIT - see LICENSE.