●Change8

Migrating to ComfyUI v0.20.1

Version v0.20.1 introduces 1 breaking change. This guide details how to update your code.

Released: 4/27/2026

1
Breaking Changes
2
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

InterruptProcessingExceptionnodes_ace.pyStable_Zero123LTXV Reference Audio nodeGPTImage nodesblur/sharpen shadersEmptySD3LatentImage nodecomfy-aimdo

Breaking Changes

●Issue #1

Derive InterruptProcessingException from BaseException. Code relying on InterruptProcessingException being a subclass of Exception might need updating, although this is generally safer for control flow exceptions.

Migration Steps

  1. 1
    If you rely on InterruptProcessingException being strictly a subclass of Exception, review usage as it now derives from BaseException.
  2. 2
    If using Sora nodes, prepare for upcoming deprecation.

Release Summary

This release introduces significant new model support, including SUPIR, RIFE, FILM, and SAM 3.1, alongside various optimizations and bug fixes across video handling and partner nodes. A key change is updating the base exception class for InterruptProcessingException.

Need More Details?

View the full release notes and all changes for ComfyUI v0.20.1.

View Full Changelog