Civitai Checkpoint Loader (XTNodes)

Instead of picking a file you've already downloaded, this node takes a Civitai model-page URL directly and does the download itself - fetches the file, drops it into your checkpoints folder, and loads it in the same step. It's the "I found this on Civitai five seconds ago and want it running" loader.

How it works

Paste a URL like https://civitai.com/models/288584?modelVersionId=324619 and the node resolves it to a specific model version, downloads the file (via aria2 by default - a proper multi-connection downloader, not a plain HTTP GET, which matters on a multi-gigabyte checkpoint), and loads it exactly the way the standard checkpoint loader does once it's on disk. Point it at the same URL again later and it skips the download; the file's already there. Trigger words and a summary come back the same way as every other node in this pack, sourced from the model page you just downloaded from - match confidence here is total, unlike the local loaders' hash-guessing, since you told it exactly which Civitai page you meant.

The inputs and outputs that matter

url is a full Civitai model page URL, ideally with a specific modelVersionId in it so you're not left at the mercy of whichever version happens to be "latest" later. override_trigger_words and preview_images behave as in every loader here. Outputs: MODEL, CLIP and VAE wire on normally, plus the pack's usual civitai_trigger_words (LIST) and summary(Text) pair.

How to install it

Through ComfyUI Manager (search "ComfyUI Easy Civitai (XTNodes)") or:

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

then restart. Two things the local loaders don't need but this one does. First, aria2c has to actually be on your system for the download to work - on Linux it's a manual step (sudo apt-get install aria2), on Windows a copy ships bundled inside the repo itself, and if it's missing the node fails with a plain, readable message telling you exactly that rather than something cryptic. Second, downloading anything Civitai gates behind login (most NSFW content) needs an API token: copy .secrets.toml.example to .secrets.toml and drop your Civitai token in under [civitai] token = "..." - public, non-gated checkpoints work fine with no token at all.

Common issues & troubleshooting

A download that silently never finishes is almost always the missing-aria2c case above - check your ComfyUI console for the "Aria2c is not installed" message rather than assuming the node is stuck. A checkpoint that fails to download at all, or errors partway, is worth checking against the gated-content case: no token in .secrets.toml plus an adult or restricted model equals a failed pull, not a bug in the node.

And the pack-wide caveat applies here too: this project hasn't been touched since September 2024, and if a required pip package fails to install, this node (and every other loader) just won't appear after restart, with no error surfaced anywhere. Re-running pip install -r requirements.txt and reading its actual output is the only reliable check.