Josia模型加载
One loader to replace Checkpoint, UNET, CLIP, and VAE loaders
- MODEL
- CLIP
- VAE1
- VAE2
JosiaCheckpointPlus (Josia模型加载) is the flagship of the JosiaNodes pack and the one with the most ambitious claim in the README: it's a "100% replacement" for ComfyUI's CheckpointLoader, UNETLoader, CLIPLoader, and VAELoader, all in a single node that auto-detects what kind of model you feed it. You pick a file, it figures out whether it's an all-in-one checkpoint, a standalone UNET, or a GGUF quant, and wires up the right loading path - including, in the video-model era, a second VAE port for audio.
The auto-detect, in plain terms
Drop a model into main_model and it classifies it into one of three shapes:
- AIO checkpoint - the file bundles UNET + CLIP + VAE (the classic sd_xl/flux safetensors). It reuses the built-in components and grays out the external CLIP/VAE selectors, because they'd conflict.
- Standalone UNET - a bare UNET file. You freely pick the CLIP and VAE to pair with it.
- GGUF UNET - a quantized model. This is where the pack's only real external dependency lives: GGUF files need the ComfyUI-GGUF plugin (city96's, the standard one) installed, because decoding the quant is that plugin's job. The node itself handles the smart scheduling and hands off to the plugin's
UnetLoaderGGUF/CLIPLoaderGGUFclasses. Non-GGUF files (ckpt/safetensors/bin) run completely standalone.
The inputs that matter
- main_model - the file picker; auto-detection kicks off from the selection.
- clip_type - a 36-choice dropdown mirroring the official CLIPLoader types (sdxl, flux, flux2, sd3, wan, qwen_image, joyimage, mage, minimax, etc.). AIO mode sets it automatically; standalone-UNET mode needs you to pick the one matching your CLIP file, and unselected falls back to
stable_diffusion. - clip_name and vae_name - external CLIP/VAE selection, only active in standalone/GGUF modes.
- vae2_name - the second VAE, aimed at video models that carry both a video VAE and an audio VAE (LTX, MMAudio, SA3, MiniMax H3). It auto-converts official
audio_vae./vocoder.weight prefixes so you don't have to rename files, and it lists bothmodels/vaeandmodels/checkpointsbecause audio VAEs often sit in the latter. - lock_unet_vram (default on) - the "keep the UNET alive" switch. It preheats the UNET to the GPU on load and keeps it resident across reruns, so reusing a workflow skips the reload. The tooltip is honest that new ComfyUI already keeps models resident after first use - this mainly gets you the preheat and guaranteed residency, without force-holding VRAM.
Outputs
Four ports: MODEL, CLIP, VAE1, and VAE2. Same shapes ComfyUI's loaders always emitted, so it drops into an existing workflow as a straight swap - that's the entire compatibility pitch.
Install
The pack itself is dependency-free:
cd ComfyUI/custom_nodes
git clone https://github.com/Josia-doit/ComfyUI_JosiaNodes
or via ComfyUI Manager (search ComfyUI_JosiaNodes), then restart. If you plan to load GGUF models, you also need:
cd ComfyUI/custom_nodes
git clone https://github.com/city96/ComfyUI-GGUF
and restart again. The README's diagnostic: if the node says it can't find a GGUF loader, the plugin isn't installed or isn't enabled - the node only schedules, it doesn't decode.
Honest takes
This is the most ambitious node in a pack that's otherwise small utilities, and it's genuinely clever about the video-era stuff - dual VAE support with automatic prefix conversion is a real convenience nobody else's one-node loader bothers with. But the "100% replacement" framing is doing work. If you mostly load one standard checkpoint, the stock CheckpointLoader has one dropdown and no learning curve; this node's 36-type CLIP dropdown is power you don't need. Where it earns its keep: mixed workflows hopping between AIO checkpoints, standalone flux UNETs, and GGUF quants, where remembering which loader each file needs is exactly the kind of bookkeeping a single auto-detecting node should kill. Just be ready for the Chinese UI and the busy panel - and know that if a GGUF load errors, the plugin, not this node, is where the bug usually lives.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| main_model | COMBO | 🖼️ 请选择模型… | 支持 ckpt / safetensors / bin / gguf 全格式。 选中后自动识别:AIO三合一 / 独立UNET / GGUF UNET。 识别后自动联动下方CLIP/VAE选框状态。 ★ GGUF 模型:本节点直接复用已安装的 ComfyUI-GGUF 插件 (UnetLoaderGGUF / CLIPLoaderGGUF)进行加载,无需额外配置; 若提示找不到 GGUF 加载器,请先安装并启用 ComfyUI-GGUF 插件。 |
| clip_name | COMBO | 🧠 请选择模型… | • AIO模型:自动禁用,复用模型内置CLIP • GGUF UNET:可选择任意格式CLIP(GGUF或非GGUF均可) • 独立UNET:可自由选择任意格式CLIP 选「请选择模型…」可由下游节点直接接入外部CLIP。 |
| clip_type | COMBO | 🏷️ 请选择类型… | 手动选择CLIP模型的tokenization架构类型。 • AIO模型:自动适配,无需手动选择 • GGUF UNET:可手动选择CLIP类型(含GGUF格式CLIP) • 独立UNET:须正确选择以匹配CLIP模型架构 未选择类型时运行会使用STABLE_DIFFUSION兜底。 |
| vae_name | COMBO | 🎨 请选择模型… | • AIO模型:自动禁用,复用模型内置VAE • 其他模式:可自由选择任意格式VAE,无格式限制 选「请选择模型…」可由下游节点直接接入外部VAE。 |
| vae2_name | COMBO | 🎵 请选择模型… | 第二 VAE(常用于视频模型的音频 VAE:LTX / MMAudio / SA3 / MINIMAX H3 等)。 • 节点会同时输出 VAE1 与 VAE2 两个端口,下游按需接入。 • AIO 视频模型:内置视频 VAE 走 VAE 端口,音频 VAE 走此处。 • 兼容官方音频 VAE(带 audio_vae./vocoder. 前缀者自动转换)。 • 下拉仅列出 models/vae 中的 VAE 模型。 |
| lock_unet_vram | BOOLEAN | true | 【开启(推荐)】UNET 保活:加载即预热到 GPU,复用工作流零延迟。 • 新版 ComfyUI 本身也会在首次使用后保持 UNET 常驻,本开关主要 价值是“提前预热 + 多轮复用不重新加载”,不会造成旧版“分时显存 优化”那种出图降速,属可选增益而非拖累。 • 不强制占满 VRAM,ComfyUI 仍按显存压力智能调度。 • 显存吃紧且工作流内含多个重型模型时,可关闭以释放余量。 |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| MODEL | MODEL | — |
| CLIP | CLIP | — |
| VAE1 | VAE | — |
| VAE2 | VAE | — |