🚫 LTX Reference Bypass

LTX Reference Bypass is the smallest node in the reference family and the easiest to underestimate: one MODEL in, one MODEL out, no settings. Its entire job is to strip any attached reference latent off the model so downstream samplers run clean.

Here's why that matters. The reference-token mechanism is great for your primary generation pass - it keeps identity consistent across every frame. But run a second, upscale/refinement pass with the reference still attached and those reference tokens keep injecting into the attention, and the first frame's attention to memory tokens can smear minor distortion into your upscale. The fix isn't to redesign the graph; it's to close the valve between passes.

The two-pass pattern

Branch the model after Reference Enable so both paths start from the same patched model:

Load Model → LTX Reference Enable → LTX Reference Conditioning → KSampler   (primary pass)
                        └──────────→ LTX Reference Bypass → LTX Tiled Sampler (upscale pass)

Pass 1 gets the identity reference; pass 2 clears it before the refinement sampler. That's the workflow the README recommends, and it's the cleanest way to think about the node: you're not disabling the feature, you're scoping it to the pass where it earns its keep.

How it works

Bypass clones the model, then removes the reference state from both places the reference family stores it: the reference_latent / reference_position_mode keys in model_options.transformer_options (plus the legacy memory_video names), and the attribute side-channel on the diffusion model itself. Once that's cleared, the Enable patches downstream see no reference and degrade to safe passthrough - exactly the dormant state Enable had before you attached anything. It's idempotent too: bypass a model with no reference attached and nothing happens, just a log line.

Installing it

Same pack, same install:

cd ComfyUI/custom_nodes
git clone https://github.com/TenStrip/10S-Comfy-nodes.git 10S_Nodes

or ComfyUI Manager → "10S". Restart. No dependencies beyond ComfyUI.

When you'd actually reach for it

• Any two-pass LTX2 workflow (generate → upscale/refine). This is the main use.
• A/B testing - put Bypass on one branch to see exactly what the reference is contributing.
• Debugging first-frame distortion - bypass and rerun the same pass to isolate whether the reference or the sampler is at fault.

If you're not doing a second pass, you probably don't need this node. The reference family composes with the tiled sampler because of it, though, so if you're building the classic "reference + tiled upscale" pipeline, it's the piece that stops the two interventions from fighting.