ComfyUI-USCG-RemoteVAE

ComfyUI-USCG-RemoteVAE

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

Adds HuggingFace Remote VAE decoding to USCG - lets you offload the VAE decode step to an allowlisted HF endpoint, reducing local VRAM use for large latents.

Install

Via Comfy Manager (recommended):

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

Manual:

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

Restart ComfyUI.

What this enables

After installing, the main USCG Builder UI's "Remote URL" VAE option becomes active. You can pick from four preset HF endpoints (SD, SDXL, Flux, HunyuanVideo) or paste an allowlisted custom URL.

Why this is a separate plugin

The HuggingFace Remote VAE feature uses urllib.request.urlopen() against arbitrary URL parameters, which triggers the Comfy Manager security review queue. By isolating this feature in its own plugin, main USCG releases pass the registry scanner cleanly - only this plugin gets queued for review when it's updated.

Network surface

This plugin makes outbound HTTPS POST requests to four allowlisted endpoints:

• https://q1bj3bpq6kzilnsu.us-east-1.aws.endpoints.huggingface.cloud/ (SD)
• https://x2dmsqunjd6k9prw.us-east-1.aws.endpoints.huggingface.cloud/ (SDXL)
• https://whhx50ex1aryqvw6.us-east-1.aws.endpoints.huggingface.cloud/ (Flux)
• https://o7ywnmrahorts457.us-east-1.aws.endpoints.huggingface.cloud/ (HunyuanVideo)

Users may paste additional URLs into the Builder UI, but they must be in the allowlist (usrv_endpoints.HF_ENDPOINTS) to be accepted - out-of-allowlist URLs raise ValueError before any network attempt.

All network code lives in usrv_network.py. Validation lives in usrv_endpoints.py.

License

MIT - see LICENSE.