FunUI VAE Loader
Stop Letting ComfyUI Guess Your VAE's Precision
- vae
- status
Two dials. That's the whole node: which VAE file, and what precision it works in. Compare that to ComfyUI's stock VAE loader, which has one dial and figures the rest out for you. Ninety-nine times in a hundred, the guessing is fine. The hundredth time, you get an H3 clip whose audio track is full of NaNs, or a decode that eats VRAM you needed for the sampler, and nothing tells you why.
FunUI VAE Loader makes the choice explicit and then reports what it did in a plain string you can read.
What it actually does
It loads the state dict itself, builds comfy.sd.VAE with the dtype you picked, and calls throw_exception_if_invalid() - so a file that isn't really a VAE fails here, at load, with a clear message instead of at decode time with a tensor shape mismatch forty nodes later.
The dtype list is short and deliberate, and the source says why: bfloat16 is the default because fp16 is a known failure on the AV VAEs, and float32 decodes slowly for no visible gain. That's not fussiness. If a model generates audio alongside picture, fp16 in the VAE is exactly how you get NaN audio - FunUI's own Save Video node has a check that detects it and drops the soundtrack rather than muxing garbage.
Inputs and outputs
- vae_name - a combo of what's in
ComfyUI/models/vae. On a fresh install this list can be empty; the node still registers and simply shows nothing to pick, which is friendlier than the pack failing to load entirely. - dtype -
bfloat16(default),float16,float32. Tooltip aside worth quoting: bfloat16 is the default; MiniMax H3 needs it. Take that as read if you're on H3.
Outputs:
- vae → decode nodes, the resample/second-pass path, or FunUI Identity Transfer, which needs the picture VAE to encode a face reference.
- status → e.g.
your_file.safetensors loaded as bfloat16. Nothing consumes it; it exists so "it worked" is something you can verify instead of assume.
Installing it
FunUI ships as one pack; install it once and every node on this list is there.
cd ComfyUI/custom_nodes
git clone https://github.com/digital-garbage/FunUI
cd FunUI && pip install -r requirements.txt
Or via ComfyUI Manager by searching FunUI (comfy node install FunUI also works). Restart ComfyUI after. Then put your VAE files in models/vae - the node can't see anything that isn't there.
That requirements file is worth a glance: it wants comfy-kitchen>=0.2.32 and gguf, and it deliberately does not upgrade torch or numpy. If pip offers to, decline and sort that out separately; a torch swap on a working ComfyUI install is a bad trade for a VAE loader.
Where people get burned
fp16 because "half is faster". On a plain SDXL VAE you'll probably get away with it. On anything with an audio VAE or H3 involved you're rolling dice on NaNs, and the failure is quiet - a run that completes and an output you can't use.
fp32 to "be safe". Decodes are slower and you get nothing you can see. If you're debugging colour problems, this is not the knob.
Grey and washed out is not a dtype problem. That's the classic symptom of a missing or mismatched VAE - the latent was decoded by the wrong one, or by nothing. Swapping precision won't fix it; loading the right file will.
Empty dropdown after installing a VAE. Restart, or hit refresh in the node. ComfyUI caches the filename list, and the pack's loaders read that cache.
One honest caveat about the whole pack. FunUI is maintained by one person with no QA team, and the docs say so. The upside is that the nodes narrate; the downside is that if a loader throws on a file ComfyUI's own loader accepts, you're the one filing the issue. Keep core's VAE loader around as a control - if core takes the file and this one doesn't, you've found a real difference, and the comparison takes thirty seconds.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| vae_name | COMBO | 0 options: | |
| dtype | COMBO | bfloat16 | The precision the VAE works in. bfloat16 is the default; MiniMax H3 needs it. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| vae | VAE | — |
| status | STRING | — |