ComfyUI-Easy-Loaders

🚀 ComfyUI Easy Loaders

ComfyUI Easy Loaders is a set of custom nodes designed to make loading models (Checkpoints & GGUF) smarter and more convenient.

Stop struggling with "clean" filenames for saving images or digging through metadata blindly. These loaders provide formatted filename strings and detailed model info right out of the box.

✨ Features

• Smart Filename Generation: Automatically generates clean, OS-friendly filename strings (snake_case) from your model names. Perfect for connecting to Save Image nodes to organize your generations.
• Deep GGUF Scanning: Automatically finds .gguf files in unet, diffusion_models, and checkpoints folders, ignoring standard ComfyUI filters that might hide them.
• Metadata Viewer: Outputs a text string with internal model metadata (Architecture, Quants, internal names, etc.) which can be viewed using a text display node.
• Customization:
  • Set prefixes and suffixes for filenames.
  • Limit character length (e.g., trim long names to 30 chars).
  • Toggle between Original, Clean, and Formatted naming modes.

📦 Installation

Option 1: Git Clone

Navigate to your ComfyUI custom_nodes folder and run:

git clone https://github.com/RevengerNick/ComfyUI-Easy-Loaders.git

Option 2: Manual Download the zip file and extract it into ComfyUI/custom_nodes/. 🛠️ Usage You will find the nodes under the category EasyLoaders.

1. Checkpoint Loader (Info) A replacement for the standard checkpoint loader. Outputs: model, clip, vae: Standard outputs. filename_str: The cleaned name of the model (e.g., flux_dev_v1) to plug into filename_prefix. model_info: Technical details about the checkpoint.
2. GGUF Loader (Info) A powerful loader for GGUF diffusion models (Flux, etc.). Features: It uses a custom scanner to find GGUF files anywhere in your model paths. Outputs: Same as above, but specifically handles GGUF quantization loading using the PIG architecture engine. Credits & License Developed by RevengerNick. Acknowledgements This project utilizes the GGUF loading engine from gguf-node by calcuis (pig architecture). Huge thanks to the original authors for their work on GGUF support in ComfyUI. Licensed under the Apache 2.0 License.