Nodes/ComfyUI_JosiaNodes/Josia模型加载
ComfyUI Node

Josia模型加载

One loader to replace Checkpoint, UNET, CLIP, and VAE loaders

By Josia-doit·Created 6 months ago·Updated a day ago· 16
Josia模型加载
    • MODEL
    • CLIP
    • VAE1
    • VAE2
    main_model🖼️ 请选择模型…
    clip_name🧠 请选择模型…
    clip_type🏷️ 请选择类型…
    vae_name🎨 请选择模型…
    vae2_name🎵 请选择模型…
    lock_unet_vramtrue

    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/CLIPLoaderGGUF classes. 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 both models/vae and models/checkpoints because 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.

    Category⚡️JosiaNodes

    Inputs (6)

    NameTypeDefaultDescription
    main_modelCOMBO🖼️ 请选择模型…支持 ckpt / safetensors / bin / gguf 全格式。 选中后自动识别:AIO三合一 / 独立UNET / GGUF UNET。 识别后自动联动下方CLIP/VAE选框状态。 ★ GGUF 模型:本节点直接复用已安装的 ComfyUI-GGUF 插件 (UnetLoaderGGUF / CLIPLoaderGGUF)进行加载,无需额外配置; 若提示找不到 GGUF 加载器,请先安装并启用 ComfyUI-GGUF 插件。
    clip_nameCOMBO🧠 请选择模型…• AIO模型:自动禁用,复用模型内置CLIP • GGUF UNET:可选择任意格式CLIP(GGUF或非GGUF均可) • 独立UNET:可自由选择任意格式CLIP 选「请选择模型…」可由下游节点直接接入外部CLIP。
    clip_typeCOMBO🏷️ 请选择类型…手动选择CLIP模型的tokenization架构类型。 • AIO模型:自动适配,无需手动选择 • GGUF UNET:可手动选择CLIP类型(含GGUF格式CLIP) • 独立UNET:须正确选择以匹配CLIP模型架构 未选择类型时运行会使用STABLE_DIFFUSION兜底。
    vae_nameCOMBO🎨 请选择模型…• AIO模型:自动禁用,复用模型内置VAE • 其他模式:可自由选择任意格式VAE,无格式限制 选「请选择模型…」可由下游节点直接接入外部VAE。
    vae2_nameCOMBO🎵 请选择模型…第二 VAE(常用于视频模型的音频 VAE:LTX / MMAudio / SA3 / MINIMAX H3 等)。 • 节点会同时输出 VAE1 与 VAE2 两个端口,下游按需接入。 • AIO 视频模型:内置视频 VAE 走 VAE 端口,音频 VAE 走此处。 • 兼容官方音频 VAE(带 audio_vae./vocoder. 前缀者自动转换)。 • 下拉仅列出 models/vae 中的 VAE 模型。
    lock_unet_vramBOOLEANtrue【开启(推荐)】UNET 保活:加载即预热到 GPU,复用工作流零延迟。 • 新版 ComfyUI 本身也会在首次使用后保持 UNET 常驻,本开关主要 价值是“提前预热 + 多轮复用不重新加载”,不会造成旧版“分时显存 优化”那种出图降速,属可选增益而非拖累。 • 不强制占满 VRAM,ComfyUI 仍按显存压力智能调度。 • 显存吃紧且工作流内含多个重型模型时,可关闭以释放余量。

    Outputs (4)

    NameTypeDescription
    MODELMODEL
    CLIPCLIP
    VAE1VAE
    VAE2VAE