●Change8

Migrating to ComfyUI v0.5.0

Version v0.5.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 12/17/2025

3
Breaking Changes
2
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

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

Kling Omni Image nodeKling TextToVideoWithAudio nodeImageToVideoWithAudio nodez image fun control union 2.0seeds_2phi_2 samplercomfy_apiTypeListDicttorch.compileZImageFunControlnet nodeWan2.6 modelexp_heun_2_x0 sampler series

Breaking Changes

●Issue #1

The comfy_api removed usage of the generic Python types "Type", "List", and "Dict". If you were relying on these specific type representations in the API structure, you may need to update your client code to handle the new structure.

●Issue #2

Very old Kling models have been dropped from the API nodes.

●Issue #3

Pika API nodes have been dropped.

Migration Steps

  1. 1
    If using API clients that relied on "Type", "List", or "Dict" in the comfy_api structure, update them to reflect the removal of these specific type representations.
  2. 2
    If using very old Kling models or Pika API nodes, they must be replaced or removed as they have been dropped.

Release Summary

This release focuses heavily on memory optimization, especially around Z Image and VAE loading, alongside introducing several new video and image generation nodes (Kling, Tripo 3.0, new samplers). Several old API nodes (Kling, Pika) were dropped, and internal API type handling was cleaned up.

Need More Details?

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

View Full Changelog