Skip to content

Fix: Add ComfyUI API compatibility shims for Blend and SDXL encoders#166

Open
Alaric07 wants to merge 1 commit intoSeargeDP:mainfrom
Alaric07:fix/comfyui-sdxl-api-shims
Open

Fix: Add ComfyUI API compatibility shims for Blend and SDXL encoders#166
Alaric07 wants to merge 1 commit intoSeargeDP:mainfrom
Alaric07:fix/comfyui-sdxl-api-shims

Conversation

@Alaric07
Copy link

@Alaric07 Alaric07 commented Nov 6, 2025

This update adds compatibility patches for the latest ComfyUI API changes that caused breakage in the SeargeSDXL workflow.

Summary

ComfyUI recently refactored internal APIs for both post-processing nodes and SDXL text encoders, which led to the following runtime errors:

'Blend' object has no attribute 'blend_images'

'SeargeStageClipConditioning' object has no attribute 'encode_base'

index 1 is out of bounds for dimension 0 with size 1

This patch introduces lightweight shims to restore functionality while remaining backward-compatible.

Changes

Added a Blend compatibility shim to dynamically attach a blend_images() method when missing.

Falls back gracefully to blend(), execute(), or a manual torch-based blend.

Added SDXL encoder compatibility shims for encode_base() and encode_ref() ensuring proper operation with the new ComfyUI text-encoder API (mid-2025+).

Preserved legacy tuple [0] returns to maintain workflow compatibility with older node logic.

Tested Environment

OS: Fedora Linux 43 (Wayland)

Desktop: KDE Plasma 6.5.1 / Frameworks 6.19.0 / Qt 6.10.0

Kernel: 6.17.7-300.fc43.x86_64

CPU: Intel® Core™ Ultra 7-265KF (20 threads)

GPU: NVIDIA GeForce RTX 4090 (ASUS)

RAM: 64 GiB

Verification

Tested successfully with:

ComfyUI master (Nov 2025 build)

JuggernautXL SDXL model (with baked-in VAE)

SeargeSDXL full workflow, including refiner and upscale paths

Notes

This patch is backward-compatible and intended as a temporary fix until upstream adjustments are merged into SeargeSDXL.

Acknowledgment

Submitted by Eric Weiss (Alaric07) — tested on Fedora 43 Workstation.

@Alaric07
Copy link
Author

Alaric07 commented Nov 6, 2025

Hi everyone,
I noticed that recent builds of ComfyUI caused errors in the SeargeSDXL workflow (specifically in the CLIPTextEncodeSDXL .encode() method and the Blend.blend_images() method).
This PR adds lightweight compatibility shims so existing pipelines continue to function while upstream updates are still in progress.
I tested this locally on Fedora 43 with an RTX 4090 and JuggernautXL (baked-in VAE) and the workflow now runs end-to-end without error.
Looking forward to your review — happy to make any tweaks if useful.
Thanks for maintaining this great pack!
— Eric Weiss (Alaric07)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant