ComfyUI-ClybsChromaNodes
A small collection of nodes intended for use with Lodestone Rock's Chroma model, for ComfyUI.
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:
| Group | Nodes |
|---|---|
| Guidance | ClybGuidance |
| Samplers | SamplerClyb_BDF, SamplerTaylorFlow, SamplerWrapperCFGPP |
| Schedulers | InverseSquaredScheduler, PrintSigmas |
| LoRA Loaders | ClybAdaptiveLoraLoader, 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 byeta, the orthogonal component is left alone.eta = 1.0recovers default CFG. - Norm clamping (
norm_threshold) — if the L2 norm of the guided output exceeds the conditional's norm timesnorm_threshold, the guided output is rescaled back down. Disabled at0.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 = 0disables it. - Scalar projection (
scalar_projection,scalar_logsumexp) — projects the conditional onto the unconditional as a scalar (logsumexporsumreduction), 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 = 0disables it. - Sine-bell schedule (
scale_up_ratio,scale_up_shift) — animates the effective CFG scale from1.0at the start, up to the configured CFG scale at the middle of diffusion, and back down to1.0at the end.scale_up_ratio = 0disables it.scale_up_shift < 1.0shifts the bell later,> 1.0earlier. - atan2/sin blend (
atan2sin_ratio) — blends the unconditional withuncond.atan().sin() / cond.atan().cos()(a Chroma-specific twist on the guidance direction).
| Input | Type | Default | Range | Description |
|---|---|---|---|---|
model | MODEL | — | — | Model to patch |
eta | FLOAT | 1.0 | -50, 50 | Parallel guidance scale |
norm_threshold | FLOAT | 0.0 | 0, 50 | Norm clamp (0 = off) |
momentum | FLOAT | 0.0 | -10, 10 | Momentum weight (0 = off) |
momentum_beta | FLOAT | 0.75 | 0, 0.999 | Running-average smoothing |
momentum_renorm | FLOAT | 1.0 | 0, 1 | Renormalize after momentum |
scalar_projection | BOOLEAN | False | — | Scalar projection of cond onto uncond |
scalar_logsumexp | BOOLEAN | False | — | Use logsumexp (else sum) |
rescale_phi | FLOAT | 0.0 | 0, 1 | STD-rescale blend (0 = off) |
var_rescale | BOOLEAN | False |
Nós neste pacote
Nós 10
Nós neste pacote
Nós 10- ChromaNAG
- ClybAdaptiveLoraLoader
- ClybAdaptiveLoraLoaderModelOnly
- ClybGuidance
- InverseSquaredScheduler
- PrintSigmas
- SamplerClyb_BDF
- SamplerClyb_GeomExtrap
- SamplerTaylorFlow
- SamplerWrapperCFGPP
Fontes
3 fontes
Fontes
3 fontesVerificado 25 de out.
Verificado 25 de out.
Trechos de fonte
1 trecho
Trechos de fonte
1 trechoSource context: Repo Clybius/ComfyUI-ClybsChromaNodes
