●Change8

Migrating to ComfyUI v0.3.69

Version v0.3.69 introduces 2 breaking changes. This guide details how to update your code.

Released: 11/18/2025

2
Breaking Changes
4
Migration Steps
8
Affected Symbols

⚠️ Check Your Code

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

Rodin3D nodes (API client)ScaleROPE nodeqwen controlnettokenizers (padding)/history API/queue APIOpenAIDalle2 node (deprecated intent)OpenAIDalle3 node (deprecated intent)

Breaking Changes

●Issue #1

Rodin3D nodes now use a new client; the old API client was removed. Users relying on the old client implementation in Rodin3D nodes must update their workflows or custom nodes to use the new client.

●Issue #2

The logic for handling pinned memory has been refined. If you experienced issues with memory pinning (especially on AMD or with specific operations), review changes related to explicitly pinning/unpinning tensors and ensuring only ComfyUI-pinned tensors are unpinned.

Migration Steps

  1. 1
    If you use Rodin3D nodes, ensure you are using the new client implementation.
  2. 2
    If you encounter memory issues, review changes regarding tensor pinning/unpinning, especially if you manually manage pinned memory.
  3. 3
    Update Intel Arc GPU installation instructions by removing IPEX as per the README update.
  4. 4
    If using ROCm, ensure you are using the correct nightly install command referencing version 7.1.

Release Summary

This release focuses heavily on memory optimization across various models (Qwen, Flux) by refining tensor pinning logic and reducing VRAM usage. It also includes several bug fixes for controlnets, quantized operations, and API node updates.

Need More Details?

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

View Full Changelog