SwarmUI-AdaptiveProjectedGuidance

A SwarmUI extension that adds parameters for MythicalChu's ComfyUI-APG_ImYourCFGNow custom node to the generate tab. Retain the quality-boosting advantages of CFG while enabling the use of higher guidance scales without oversaturation.

Changelog

11 March 2025

• Added parameters for Guidance Limiter (Thanks to derrian-distro), described in the APG repo as:

Added "Guidance Limiter" : https://arxiv.org/abs/2404.07724 It drops the cfg (also, APG's functions) outside the specified range (ideally at the early steps and the later ones) improving variability and combating oversaturation. Starting and ending parameters set as per the paper suggestion, but may need further tweaking depending on model and other conditions.

16 November 2024

• Initial Release

Installation (Simple)

1. Update SwarmUI first, if you have an old version this extension may not work
2. In SwarmUI go to the Server/Extensions tab
3. Find AdaptiveProjectedGuidance in the list and click the 'Install' button
4. Refresh the page and go back to the generate tab, if you see the parameters then the required ComfyUI dependencies are installed and you can start using the extension, otherwise continue below.
5. If the ComfyUI-APG_ImYourCFGNow custom node is not installed in the backend an install button will be shown in the parameter group, install it and follow the prompts
6. Now the parameters should appear and you are good to go

Installation (Advanced)

1. Update SwarmUI first, if you have an old version this extension may not work
2. Shutdown SwarmUI
3. Open a cmd/terminal window in SwarmUI\src\Extensions
4. Run git clone https://github.com/Quaggles/SwarmUI-AdaptiveProjectedGuidance.git
5. Run SwarmUI\update-windows.bat or SwarmUI\update-linuxmac.sh to recompile SwarmUI
6. Launch SwarmUI and follow on from Step 4 of Installation (Simple)

Updating

1. Update SwarmUI first, if you have an old version this extension may not work
2. In SwarmUI go to the Server/Extensions tab
3. Click the update button for 'AdaptiveProjectedGuidanceExtension'

Usage

I'd recommend first experimenting by comparing a generation with and without the Adaptive Projected Guidance, then experiment with turning up your CFG Scale to 8-12 and decreasing Momentum and Norm Threshold params to control the saturation/burn.