Load Checkpoint with Previews (XTNodes)

This is ComfyUI's stock checkpoint loader with the same trick as its LoRA sibling in this pack: pick a file you already have, and it goes and figures out what that file actually is by asking Civitai. Useful the moment you've got a checkpoints folder full of merges with names like finalV3_actualfinal.safetensors and no memory of which one is which.

How it works

It loads whatever .safetensors or .ckpt you select exactly the normal way - splits it into MODEL, CLIP and VAE via ComfyUI's own checkpoint-loading path, no custom model logic here. What's added is a BLAKE3 hash of the file computed on first use, checked against Civitai's hash-search endpoint, and cached locally so it's instant afterward. If it matches, you get a written summary of the model straight from its Civitai page and, if preview_images is on, a strip of its sample images inside the node itself - handy for confirming "yes, this is the anime-realism merge I meant to load" without alt-tabbing to a browser. If it doesn't match - a private or self-trained checkpoint, or one pulled from Civitai since - the node doesn't error; the checkpoint loads fine regardless, you just get an honest "Could not find model in civitai.com" in the summary field instead of metadata.

The inputs and outputs that matter

model_name is a dropdown of your local checkpoints folder - this is a pure local loader, no URL or download here (that's CivitaiCheckpointLoaderSimple, a separate node in this pack). override_trigger_words is usually left blank for a checkpoint since checkpoints rarely need a trigger word the way LoRAs do, but it's there if a particular fine-tune's Civitai page calls for one. preview_images toggles the sample-image pull described above.

Outputs: MODEL, CLIP and VAE wire on exactly like the built-in loader. civitai_trigger_words (LIST, usually empty for checkpoints) and summary(Text) are the same bonus pair every loader in this pack carries.

How to install it

Via ComfyUI Manager, search "ComfyUI Easy Civitai (XTNodes)", or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/X-T-E-R/ComfyUI-EasyCivitai-XTNodes
pip install -r requirements.txt

then restart. No models to download for this node specifically - it only reads what's already on disk.

Common issues & troubleshooting

The one thing to know going in: this pack hasn't been touched since September 2024, and its __init__.py swallows any import error from a node file completely silently - no traceback, nothing in the log. Two open GitHub issues describe installing this pack and getting only its two prompt-utility nodes, with every loader (this one included) simply absent. The likely culprit is one of the five pip dependencies (blake3, dynaconf, pydantic, codetiming, sanitize_filename) failing to install cleanly, or the pack drifting out of sync with a ComfyUI core function it calls into. If your checkpoint loader never shows up after install, re-run pip install -r requirements.txt inside the same Python environment ComfyUI launches with and actually read the output rather than trusting it finished - that's the only way to catch the real error, since the pack itself won't surface one.

Beyond that, this is about as low-risk a node as the pack ships: it's reading a file you already trust, computing a hash, and making one read-only API call, so there's not much else here to go wrong.