Universal Checkpoint Blender (SDXL & SD 1.5)
A lightweight, standalone Python tool for blending Stable Diffusion checkpoints.
This tool was designed as a RAM-efficient alternative to bloated WebUIs, allowing for precise control over model architecture without the overhead.
✨ Key Features
- Architecture Agnostic: Works with SDXL, Pony, Illustrious, NoobAI, and SD 1.5 models.
- Smart Blending: Adjust the ratio between Model A (Base) and Model B (Mix-in) with a precise slider.
- RAM Optimized: Includes an aggressive memory flush system to allow multiple merges in one session on 32GB (or more) systems.
- Space Saving: Optional "Prune to FP16" checkbox to keep your model files at standard sizes (~6GB for SDXL, ~2GB for SD 1.5).
- Simple UI: The "Model Blender" interface is designed for anyone—just browse, slide, and blend.
🚀 How to Use
1. Install Requirements
Ensure you have Python installed, then install the necessary "math engines" via terminal:
pip install torch safetensors
2. Run the App
Download the script and run it from your terminal or command prompt:
python blender.py
3. Blending Logic
- Model A: Your primary base model.
- Model B: The model you want to "flavor" the base with.
- The Slider: Moving the slider to 0.15 adds 15% of Model B into Model A. This is the "sweet spot" for adding Pony/Illustrious logic to standard SDXL models without breaking prompt adherence.
📝 Technical Notes
- History: The tool automatically creates a merge_history.txt file in its folder, acting as a "recipe book" for every model you create.
- OS Support: Tested and confirmed on Ubuntu 20.04+, but works on Windows 10/11 and macOS as well.
🤝 Credits
Designed and built by Human and A.I.
