HF List Models

A backup you never verify isn't a backup, it's a hope. HF List Models (class HuggingFaceListModels) is the verification half of the ComfyUI-Backup pack: it lists the files in your Hugging Face backup repo without downloading a single byte, so you can confirm what actually made it up before you delete the local copy or trust the cloud copy on a fresh machine.

It's the smallest node in the pack - two inputs, one string output, no settings to get wrong - which makes it a genuinely useful first stop. Run it after a backup to check the upload didn't silently drop a folder. Run it before a restore to remind yourself what you're about to pull down. And if you're pairing it with a HuggingFaceRestore on a new install, it's the cheapest possible sanity check: better to discover the repo is empty before you've wiped the old machine.

How it works

It calls list_repo_files from huggingface_hub and then does something mildly clever with the flat file list: it groups every path by its top-level folder - the subfolder under models/ the file came from, so checkpoints/, loras/, vae/, embeddings/ and so on - and prints each group with a count. It caps the display at ten files per type and appends ... and N more past that, so a 2,000-file checkpoint folder doesn't spam your console. The result comes out as a model_list string on an OUTPUT_NODE, meaning it renders in the node view exactly like text you'd see in a ShowText node.

That grouping is the feature. Raw list_repo_files output is a wall of paths; here you get "checkpoints (14 files), loras (42 files), upscale_models (3 files)" at a glance, which is the difference between "the repo has files" and "the backup is complete."

The inputs (all two of them)

• repo_id - the same yourname/comfyui-models-backup you used to create the backup. The only required field.
• token - optional on paper, required in practice. Here's the quirk: Hugging Face's list_repo_files works fine anonymously for public repos, but this node always demands a token - if neither the field nor HF_TOKEN / HUGGING_FACE_HUB_TOKEN is set, it returns an error instead of listing. Just set HF_TOKEN once in your environment and every node in this pack shares it.

There's no filter, no pagination control, no "show all files" option - the 10-per-type cap is baked in. For a big repo you'll see the tip of each iceberg, which is honestly enough for a sanity check.

Installing it

Same pack as the rest - ComfyUI Manager, search ComfyUI-Backup, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/romandev-codex/ComfyUI-Backup

Its only dependency is huggingface_hub>=0.20.0, which ComfyUI's venv already has, so installation is effectively instant. Restart ComfyUI afterward and the three HF nodes appear under the backup category.

Common issues

The error you'll hit is ERROR: Please provide token or set HF_TOKEN - fix it with the token field or the environment variable. Beyond that, the usual failure is expecting it to do something it doesn't: it's a peek, not a browser. You can't click into a file or see sizes, and it'll only list the first 10 files per model type. If you need the complete picture, that's what a HuggingFaceRestore run (or the Hugging Face website) is for. For its actual job - confirming your backup is real and roughly complete - it's the right tool, and it's the one node in this pack you can run over and over without risking anything.