ComfyUI > Nodes > ComfyUI > Tangential Damping CFG

ComfyUI Node: Tangential Damping CFG

Class Name

TCFG

Category
advanced/guidance
Author
ComfyAnonymous (Account age: 763days)
Extension
ComfyUI
Latest Updated
2026-05-13
Github Stars
112.77K

How to Install ComfyUI

Install this extension via the ComfyUI Manager by searching for ComfyUI
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Tangential Damping CFG Description

Enhances AI-generated outputs by aligning conditional and unconditional predictions through tangential damping for improved content quality.

Tangential Damping CFG:

The TCFG node, or Tangential Damping CFG, is designed to enhance the quality of AI-generated outputs by refining the alignment between conditional (positive) and unconditional (negative) predictions. This node operates within the advanced guidance category, focusing on improving the coherence and quality of generated content by applying a method known as tangential damping. The primary goal of TCFG is to adjust the unconditional predictions to better align with the conditional ones, thereby enhancing the overall output quality. This process involves calculating a tangential damping score that helps in refining the unconditional predictions, ensuring they are more in line with the desired conditional outcomes. By doing so, TCFG contributes to producing more accurate and aesthetically pleasing results in AI-generated content.

Tangential Damping CFG Input Parameters:

model

The model input parameter is the core AI model that the TCFG node will operate on. This parameter is crucial as it provides the foundational structure upon which the tangential damping adjustments will be applied. The model should be a pre-trained AI model capable of generating conditional and unconditional predictions. The TCFG node clones this model to apply its specific guidance techniques without altering the original model. There are no specific minimum, maximum, or default values for this parameter, as it depends on the model's architecture and training.

Tangential Damping CFG Output Parameters:

patched_model

The patched_model output parameter represents the modified version of the input model after the tangential damping adjustments have been applied. This output is crucial as it embodies the enhanced model that now produces more aligned and refined predictions. The patched model is expected to generate outputs with improved quality, thanks to the adjustments made to the unconditional predictions. This output is particularly important for users seeking to enhance the aesthetic and coherence of AI-generated content.

Tangential Damping CFG Usage Tips:

  • Ensure that the input model is well-trained and capable of generating both conditional and unconditional predictions, as the effectiveness of TCFG relies on the quality of these predictions.
  • Use TCFG in scenarios where the alignment between conditional and unconditional outputs is critical for the quality of the final result, such as in artistic AI applications where coherence and aesthetic quality are paramount.

Tangential Damping CFG Common Errors and Solutions:

"NoneType object is not iterable"

  • Explanation: This error may occur if the input model does not provide valid conditional or unconditional predictions, leading to a failure in the tangential damping process.
  • Solution: Verify that the input model is correctly configured and capable of generating both conditional and unconditional predictions. Ensure that the model's outputs are not None before passing them to the TCFG node.

"IndexError: list index out of range"

  • Explanation: This error might happen if the conds_out list does not contain the expected number of elements, which are necessary for the tangential damping calculation.
  • Solution: Check that the input model is producing the correct number of outputs and that these outputs are being correctly passed to the TCFG node. Ensure that the model's configuration aligns with the expectations of the TCFG node.

Tangential Damping CFG Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Tangential Damping CFG