Files
tenser-tensor-ComfyUI-Tense…/web/docs/TT_Flux2GgufModelsLoaderAdvancedNode.md

4.2 KiB
Raw Permalink Blame History

TT FLUX2 GGUF Models Loader (Advanced) TT_Flux2GgufModelsLoaderAdvancedNode

This description was generated with AI assistance. If you spot any errors, please create an issue on GitHub.

Extended GGUF pipeline loader with dequantization control, sampling shift, up to 4 LoRA slots, and advanced device/dtype configuration.

Inputs

Parameter Type Required Description
diffusion_model COMBO Yes GGUF-quantized diffusion model file
dequant_dtype COMBO Yes Data type for dequantization (default: "bfloat16") (advanced)
patch_dtype COMBO Yes Data type for model patches (default: "bfloat16") (advanced)
apply_sampling BOOLEAN Yes Enable resolution-based sampling shift ("Flux Shift" / "No Shift", default: enabled)
base_sampling_shift FLOAT Yes Base shift value for sampling schedule (0.0–100.0, default: 0.5) (advanced)
max_sampling_shift FLOAT Yes Maximum shift value for sampling schedule (0.0–100.0, default: 1.15) (advanced)
sampling_width INT Yes Reference width for shift calculation (16–MAX, step: 8, default: 1024) (advanced)
sampling_height INT Yes Reference height for shift calculation (16–MAX, step: 8, default: 1024) (advanced)
clip COMBO Yes GGUF-quantized text encoder file
clip_device COMBO Yes Device for CLIP inference (default: "default") (advanced)
lora_name_1 COMBO Yes LoRA file for slot 1
strength_1 FLOAT Yes Strength for LoRA slot 1 (-10.0–10.0, default: 1.0)
lora_name_2 COMBO Yes LoRA file for slot 2
strength_2 FLOAT Yes Strength for LoRA slot 2 (-10.0–10.0, default: 1.0)
lora_name_3 COMBO Yes LoRA file for slot 3
strength_3 FLOAT Yes Strength for LoRA slot 3 (-10.0–10.0, default: 1.0)
lora_name_4 COMBO Yes LoRA file for slot 4
strength_4 FLOAT Yes Strength for LoRA slot 4 (-10.0–10.0, default: 1.0)
vae_name COMBO Yes VAE model file for image encoding/decoding
vae_device COMBO Yes Device for VAE inference (default: "default") (advanced)
vae_dtype COMBO Yes Data type for VAE computation (advanced)

Outputs

Parameter Type Description
MODEL MODEL Loaded GGUF diffusion model
CLIP CLIP Loaded GGUF text encoder
VAE VAE Loaded VAE

Usage

Advanced GGUF pipeline loader with full control over quantization and loading parameters. Use dequant_dtype and patch_dtype to balance precision and VRAM usage during dequantization. Supports up to 4 simultaneous LoRAs applied at load time. Enable "Flux Shift" to apply resolution-aware sampling shift — adjust base_sampling_shift, max_sampling_shift, and the reference resolution to tune the shift curve. Use advanced device options to offload components as needed.


View on GitHub