🔬 Forge Grid: Sampler × Scheduler — Your Key to Smart Stable Diffusion Experiments!
Curious about how samplers and schedulers affect your Stable Diffusion images?
Forge Grid: Sampler × Scheduler is a powerful extension for Stable Diffusion Forge that lets you create image grids to compare sampler and scheduler combinations with ease. User-friendly, robust, and flexible, it’s your go-to tool for testing and optimizing image generation.
🌟 What Can Forge Grid Do?
The script offers two modes to explore Stable Diffusion settings in a way that suits you:
XY Grid: Generates a grid of all possible combinations of samplers and schedulers selected via dropdowns. Perfect for bulk testing!
Batch Grid: Lets you manually specify sampler-scheduler pairs via text input or add them using the “Add Pair” button in the interface.
With this tool, you can visualize how different settings impact image quality, save results for analysis, and work with maximum convenience.
✨ Why Try It?
🤸♂️ Flexible Modes: XY Grid for automatic combinatorial testing and Batch Grid for custom pairs added via interface and/or manual input.
🔮 Intuitive Interface: Gradio interface with dropdowns, text fields, and buttons for easy configuration.
📋 Detailed Logging: Each pair (sampler and scheduler) generation is logged in the terminal with progress, and errors are logged in detail.
🪄 Auto-Downscaling: Grids exceeding 16,383 pixels are automatically resized without quality loss to maintain performance.
🎯 Auto-Activation of save_large: For 50+ cells, protection against errors for large grids is automatically enabled.
🛠️ Customizable Output: Text labels for sampler and scheduler with a custom font
Barlow-SemiBold.ttf).⚠️ Fallback Images: Shown for generation failures with invalid pairs and replaced with fallback images with readable error messages.
🚰 Duplicate Filtering: Duplicate pairs in Batch Grid are automatically removed to prevent errors.
🔀 Flexible Parameters: Configure prompts, seed, steps (1–100), CFG (1.0–30.0), dimensions (256–2048 px), padding (0–200 px).
📅 Individual Cell Saving: Save to
/cellsvia button, convenient for analysis.💾 PNG and WEBP Support: Choose one or both formats.
⚙️ Installation
Clone the repository into your Forge
/extensions/folder:
git clone https://github.com/PupaBoo/Forge-Grid-Sampler-SchedulerNavigate to the project directory:
cd Forge-Grid-Sampler-SchedulerInstall dependencies:
pip install -r requirements.txt(Optional) Place the
Barlow-SemiBold.ttffont in thefonts/folder for improved label display.
🚀 Usage
Launch Forge WebUI and select
Forge Grid: Sampler × Schedulerfrom thetxt2imgscript dropdown.
Choose a mode:
XY Grid: Select samplers and schedulers for X and Y axes via dropdowns. The grid forms all possible combinations.
Batch Grid: Add sampler-scheduler pairs via dropdowns (using the “Add Pair” button) or manually in the text field (e.g.,
Euler a,Automaticper line).
Configure parameters:
Positive/negative prompt.
Seed (leave blank for random).
Steps, CFG, image dimensions, padding, save format (WEBP/PNG).
Enable labels and individual cell saving.
Click “Generate” to create the grid. Pair progress and errors are logged in the terminal. Use “Stop Grid Generation” to interrupt.
🛠 Requirements
Python 3.7+
Libraries:
gradio,Pillow,numpy(Optional)
Barlow-SemiBold.ttffont
⚠️ Limitations
Generation stops on errors (e.g., invalid pairs or empty axes in XY Grid).
Duplicate pairs in Batch Grid cause generation to stop.
📜 License
Licensed under the [MIT License](LICENSE) © 2025 PupaBoo.
Free to use with attribution—see LICENSE.
🙌 Acknowledgments
Built with
Gradio,Pillow, andNumPy.Developed with assistance from Microsoft Copilot, Grok 3, and ChatGPT.
🤝 Contributing
Ideas, bug reports, and pull requests are welcome on GitHub
📸 Examples
XY Grid
Batch Grid
