Ir para o conteúdo
Node packVerificadoExterno
Fonte aberta

ComfyUI-ClybsChromaNodes

A small collection of nodes intended for use with Lodestone Rock's Chroma model, for ComfyUI.

Mantenedor@ClybiusUnratednota

Perfil do pacote

Status
Verificado
Publicador
@Clybius
Fonte
GitHub

README

ComfyUI-ClybsChromaNodes

A small collection of custom nodes for ComfyUI, designed primarily for use with Lodestone Rock's Chroma model (and compatible flow-matching architectures like FLUX and SD3). The package bundles custom guidance, samplers, schedulers, and an adaptive multi-LoRA loader, all of which integrate as standard ComfyUI nodes.

Installation

Clone this repository into your ComfyUI custom_nodes directory and restart ComfyUI:

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/Clybius/ComfyUI-ClybsChromaNodes.git

No additional Python dependencies are required beyond a working ComfyUI install. The frontend extension is picked up automatically via WEB_DIRECTORY = "./js".

Node overview

The package registers 8 nodes, organized into four groups:

GroupNodes
GuidanceClybGuidance
SamplersSamplerClyb_BDF, SamplerTaylorFlow, SamplerWrapperCFGPP
SchedulersInverseSquaredScheduler, PrintSigmas
LoRA LoadersClybAdaptiveLoraLoader, ClybAdaptiveLoraLoaderModelOnly

In addition, the chroma_NAG.py module ships a ChromaNAG class (Normalized Attention Guidance for Chroma's DoubleStreamBlock) that is not currently registered in the node mappings — the class is available in code but does not appear in the ComfyUI node browser.


Guidance

ClybGuidance

File: clyb_Guidance.py Category: sampling/custom_sampling

A pre-CFG model patch that rewires how the conditional and unconditional predictions are combined at every sampling step. Stacks the following features on top of standard CFG:

  • Project-and-scale (eta) — the guidance vector is split into a component parallel to the conditional and a component orthogonal to it. The parallel component is scaled by eta, the orthogonal component is left alone. eta = 1.0 recovers default CFG.
  • Norm clamping (norm_threshold) — if the L2 norm of the guided output exceeds the conditional's norm times norm_threshold, the guided output is rescaled back down. Disabled at 0.0.
  • Momentum (momentum, momentum_beta, momentum_renorm) — adds a fraction of a running-average guidance vector to the current guidance, optionally re-normalized back to its original norm. momentum = 0 disables it.
  • Scalar projection (scalar_projection, scalar_logsumexp) — projects the conditional onto the unconditional as a scalar (logsumexp or sum reduction), then scales the unconditional by that scalar.
  • STD/var rescale (rescale_phi, var_rescale) — blends the guided output toward an output whose standard deviation (or variance) matches the conditional's. rescale_phi = 0 disables it.
  • Sine-bell schedule (scale_up_ratio, scale_up_shift) — animates the effective CFG scale from 1.0 at the start, up to the configured CFG scale at the middle of diffusion, and back down to 1.0 at the end. scale_up_ratio = 0 disables it. scale_up_shift < 1.0 shifts the bell later, > 1.0 earlier.
  • atan2/sin blend (atan2sin_ratio) — blends the unconditional with uncond.atan().sin() / cond.atan().cos() (a Chroma-specific twist on the guidance direction).
InputTypeDefaultRangeDescription
modelMODEL——Model to patch
etaFLOAT1.0-50, 50Parallel guidance scale
norm_thresholdFLOAT0.00, 50Norm clamp (0 = off)
momentumFLOAT0.0-10, 10Momentum weight (0 = off)
momentum_betaFLOAT0.750, 0.999Running-average smoothing
momentum_renormFLOAT1.00, 1Renormalize after momentum
scalar_projectionBOOLEANFalse—Scalar projection of cond onto uncond
scalar_logsumexpBOOLEANFalse—Use logsumexp (else sum)
rescale_phiFLOAT0.00, 1STD-rescale blend (0 = off)
var_rescaleBOOLEANFalse

Nós neste pacote

Nós 10
  • ChromaNAG
  • ClybAdaptiveLoraLoader
  • ClybAdaptiveLoraLoaderModelOnly
  • ClybGuidance
  • InverseSquaredScheduler
  • PrintSigmas
  • SamplerClyb_BDF
  • SamplerClyb_GeomExtrap
  • SamplerTaylorFlow
  • SamplerWrapperCFGPP

Fontes

3 fontes
GitHubFonte
github.com/Clybius/ComfyUI-ClybsChromaNodes

Verificado 6 de nov.

GitHubFonteVersão d05bb0bf95c2ddaea1b9f869dfd7547de63657f0
github.com/Clybius/ComfyUI-ClybsChromaNodes

Verificado 25 de out.

Trechos de fonte

1 trecho

Source context: Repo Clybius/ComfyUI-ClybsChromaNodes