Checkpoint Loader With Params

If you juggle a dozen anime checkpoints, you know the feeling: you swap waiIllustriousSDXL_v170.safetensors back into the loader and suddenly can't remember whether it wants score_9, score_8_up or the noobai set, and what cfg it likes. This node is the cheap fix - a regular CheckpointLoaderSimple with a sticky note taped to it. Pick a checkpoint, and the note for that exact file pops up next to it. It won't write your prompts for you, but it stops the "what was that file's settings again" search every single time you switch models.

That pain is real and common - "how do you keep track of your trigger words" is a recurring r/comfyui thread, and rgthree's Power Lora Loader became famous for solving it on the LoRA side. This is the checkpoint half, done with zero dependencies and zero network calls: everything lives in one text file on your machine.

How it works

The mechanism is pleasantly small. On startup the Python code reads checkpoint_triggers.txt from the node's own folder, parses it as filename="value" pairs, and stashes them in an in-memory map. ComfyUI also serves that map to the browser at /checkpoint_trigger_map. The bundled JS extension then does the clever bit: when you change the ckpt_name dropdown, it fetches the map and writes the matching note into the recommended_params widget, which it's made read-only so you don't accidentally nuke it. It even adds a small Copy Params button right on the widget.

The loading itself is not reinvented - load_checkpoint calls ComfyUI's own load_checkpoint_guess_config, the exact same path the core CheckpointLoaderSimple uses. So outputs and behavior are identical to stock; you're just getting a notes panel for free.

Inputs and outputs that matter

• ckpt_name - required dropdown listing everything in models/checkpoints. This is the only thing you'll actually touch.
• recommended_params - optional multiline text; the per-checkpoint note. Auto-fills when you change the checkpoint, shows 未找到推荐参数 ("recommended params not found") when there's no entry for that file.
• Outputs are MODEL, CLIP, VAE - wire them exactly like a stock loader: MODEL → KSampler, CLIP → CLIPTextEncode, VAE → VAE Decode.

The one thing beginners trip on: recommended_params is notes, not automation. It does not inject anything into your prompt. You hit Copy Params and paste into your positive prompt yourself.

Installing it

No model downloads, no heavy dependencies - the whole pack is one Python file, one JS file, and a text file. Install via ComfyUI Manager (search comfyui-checkpoints-with-trigger) or:

cd ComfyUI/custom_nodes
git clone https://github.com/sossuzumiyaharuhi/comfyui-checkpoints-with-trigger

Then restart ComfyUI. Node appears in loaders as "Checkpoint Loader With Params".

Setting up your notes file

Edit custom_nodes/comfyui-checkpoints-with-trigger/checkpoint_triggers.txt. One entry per file, lowercase name optional (matching is case-insensitive):

myAnimeMix_v20.safetensors="score_9, score_8_up, anime"
myRealMix_v5.safetensors="photorealistic, 8k"

Multiline values work inside the quotes - that's the point of the " parsing. The author also ships a Windows batch file (生成触发词模板.bat): drop it in your checkpoints folder, double-click, and it writes a name="" template for every model to your Desktop. On Mac/Linux just list your files yourself.

Gotchas

The trigger map is loaded once at startup - editing the txt means restarting ComfyUI before new notes show up. The map keys match on the full filename, so a rename breaks the pairing. And be honest about the audience here: the README is Chinese-only, the bundled trigger file is pre-filled with NoobAI/Illustrious anime checkpoints, and this pack has essentially zero community footprint - it's a personal utility the author shared. Fine for that use case, just don't expect updates or English docs. If you only need LoRA trigger words, rgthree's Power Lora Loader is the better-known tool; for checkpoint notes without any extra infrastructure, this does the job.