Nodes/XB_ToolBox/XB-BOX - 📦 模型加载大全V3 (GGUF)
ComfyUI Node

XB-BOX - 📦 模型加载大全V3 (GGUF)

LTX 2.3's dual-CLIP, dual-VAE stack, quantized to fit

By wjluoxiao·Created 5 months ago·Updated 6 days ago· 302
XB-BOX - 📦 模型加载大全V3 (GGUF)
    • MODEL
    • CLIP
    • VAE1
    • VAE2
    model_type
    model
    clip1
    clip2
    clip_typeltxv
    lora_1
    lora_1_ontrue
    lora_1_strength1.00
    vae1
    vae2
    sage_preset关闭
    blocks_to_swap0
    lora_2
    lora_2_onfalse
    lora_2_strength1.00
    lora_3
    lora_3_onfalse
    lora_3_strength1.00
    lora_4
    lora_4_onfalse
    lora_4_strength1.00
    lora_5
    lora_5_onfalse
    lora_5_strength1.00
    lora_6
    lora_6_onfalse
    lora_6_strength1.00
    lora_7
    lora_7_onfalse
    lora_7_strength1.00
    lora_8
    lora_8_onfalse
    lora_8_strength1.00

    LTX 2.3 is 22B. On anything short of a 24GB card, running it at full fp16 is a prayer, and even fp8 is tight on a 16GB. XB_ModelLoaderV3_GGUF is the pack's answer: the same dual-CLIP, dual-VAE loader as V3, but the UNet and text encoders load from .gguf quantized files so the whole LTX 2.3 stack has a chance of fitting a consumer card.

    Same contract as V3, same job: one node that loads model, two CLIPs (merged into one output), and two VAEs - the video VAE and the audio VAE that LTX 2.3 needs for its synchronized audio-video generation. If you're wiring the pack's XB_LTX23_InfiniteStreamer, this is the loader to pair with it when VRAM is the constraint.

    How it works

    The GGUF variant of V3, which means:

    • model - .gguf UNet via ComfyUI-GGUF's UnetLoaderGGUFAdvanced.
    • clip1 + clip2 - both .gguf, merged through ComfyUI-GGUF's DualCLIPLoaderGGUF into a single CLIP output, mirroring how the safetensors V3 uses the official DualCLIPLoader. Same contract, quantized encoders.
    • vae1 + vae2 - plain safetensors VAE loaders. The video and audio VAEs stay full precision - this node quantizes the big DiT and the text encoders, not the VAEs.
    • LoRA stack - eight slots (lora_1..8 with _on/_strength).
    • sage_preset + blocks_to_swap - attention acceleration and block offload, same hooks as the safetensors V3.

    Outputs: MODEL, CLIP, VAE1, VAE2. No model_weight_dtype dropdown - the quant is in the file.

    The inputs that matter

    • model - pick your Q. Q4_K_M is the "make it fit" pick for 12–16GB; Q8 if you have headroom and want the quality back.
    • clip_type - default ltxv, and keep it there; the dual encoder pairing is LTX-specific.
    • clip1 / clip2 - the quantized encoders. LTX 2.3's text encoder is big, so a Q4/Q5 T5-style encoder is usually the difference between fitting and not.
    • vae1 / vae2 - video and audio VAE. Watch the order, same as V3: getting them swapped produces nonsense audio latents.

    Install

    # ComfyUI-GGUF first - this node errors without it:
    cd ComfyUI/custom_nodes
    git clone https://github.com/city96/ComfyUI-GGUF.git
    
    # then:
    cd ComfyUI/custom_nodes
    git clone https://github.com/WJLUOXIAO/XB_ToolBox.git
    # or: ComfyUI Manager → "XB_ToolBox"
    

    The hard "ComfyUI-GGUF 未安装" error when it can't find the pack is the #1 support complaint, and it's the one the README's "no dependencies" line doesn't cover.

    Notes

    The quality math is friendly here: the VAEs stay full precision (the lossiest part of most pipelines), and LTX 2.3's DiT tolerates quantization about as well as any transformer. Q8 for the model is basically indistinguishable from fp8 at half the size; Q4_K_M is where the tradeoff starts showing. And the dequant tax on LoRAs applies to the GGUF UNet - if you're stacking several character LoRAs onto a Q4 model, expect a real speed hit and consider whether V3 at fp8 fits instead.

    CategoryXB_ToolBox/Model_Loader_GGUF

    Inputs (33)

    NameTypeDefaultDescription
    model_typeSTRING
    modelCOMBO1 options: (请先输入模型类型)
    clip1COMBO1 options: (请先输入模型类型)
    clip2COMBO1 options: (请先输入模型类型)
    clip_typeCOMBOltxv12 options: sdxl, sd3, flux, hunyuan_video, hidream, hunyuan_image, +6
    lora_1COMBO1 options:
    lora_1_onBOOLEANtrue
    lora_1_strengthFLOAT1.00-100–100
    vae1COMBO1 options: (请先输入模型类型)
    vae2COMBO1 options: (请先输入模型类型)
    sage_presetCOMBO关闭9 options: 关闭, 自动, 内置模式 A (128x128x32), 内置模式 B (128x64x96), 内置模式 C (128x16x16), 内置模式 D (64x64x16), +3
    blocks_to_swapINT00–200
    lora_2COMBO1 options:
    lora_2_onBOOLEANfalse
    lora_2_strengthFLOAT1.00-100–100
    lora_3COMBO1 options:
    lora_3_onBOOLEANfalse
    lora_3_strengthFLOAT1.00-100–100
    lora_4COMBO1 options:
    lora_4_onBOOLEANfalse
    lora_4_strengthFLOAT1.00-100–100
    lora_5COMBO1 options:
    lora_5_onBOOLEANfalse
    lora_5_strengthFLOAT1.00-100–100
    lora_6COMBO1 options:
    lora_6_onBOOLEANfalse
    lora_6_strengthFLOAT1.00-100–100
    lora_7COMBO1 options:
    lora_7_onBOOLEANfalse
    lora_7_strengthFLOAT1.00-100–100
    lora_8COMBO1 options:
    lora_8_onBOOLEANfalse
    lora_8_strengthFLOAT1.00-100–100

    Outputs (4)

    NameTypeDescription
    MODELMODEL
    CLIPCLIP
    VAE1VAE
    VAE2VAE