ArchAi3D_Color_Correction_BT709

Every now and then you feed a perfectly normal-looking photo into a Qwen-VL editor and get back an image with a green cast, blown highlights, or shadows with all the detail crushed out. It's not the model being broken - it's that the model was trained on clean, well-exposed imagery, and your input had a color/exposure problem it dutifully amplified. ArchAi3D_Color_Correction_BT709 is a preprocessing step that fixes the input before the model ever sees it. One image in, one corrected image out, nothing to tune. That's the whole node, and that's fine.

How it works

It's a small pipeline from the colour-science library, chained together:

1. Convert sRGB → linear RGB using the standard BT.709 transfer curve.
2. Do highlight and lowlight attenuation in that linear space - this is the part that stops bright-scene green shift, clipped highlights, and lost shadow detail.
3. Convert back and hand you the result.

The BT.709 math is worth knowing even if you never touch the node: sRGB displays use a slightly different gamma than the BT.709 broadcast standard, and when a model's training data lives in one space and your input lives in the other, you get the color shifts that "look wrong but you can't say why." The node normalizes the input toward what the model expects.

When to reach for it

The author's own docstrings position it as "pre-processing for Qwen" - put it between your image loader and the Image Scale / encoder chain. Real-world cases where it earns its keep:

• Bright, white-heavy interior shots (this pack is an interior-design toolkit) that come back with a green tint after an edit pass.
• HDR or phone photos with clipped highlights - the attenuation pulls them back into a range the model can interpret.
• Old scans and flat JPEGs where the shadows are a black mush.

If your image already looks clean and neutral, skip it. It's a correction node, not a style node - on a well-exposed input it should be nearly a no-op, and if you're seeing visible changes on a good image, that's the point where you should ask whether your input was actually as good as you thought.

Install and the honest caveat

Part of the ArchAi3D Qwen pack:

cd ComfyUI/custom_nodes
git clone https://github.com/amir84ferdos/ComfyUI-ArchAi3d-Qwen.git
cd ComfyUI-ArchAi3d-Qwen && pip install -r requirements.txt

It needs colour-science, which is in requirements.txt (or install just the color group via the pack's ArchAi3D_Dependency_Installer node → "Install Color Tools"). ComfyUI Manager → search "ArchAi3d Qwen" works too.

The caveat: BT.709 linearization is the author's prescription, not a universal truth - some Qwen workflows deliberately skip color preprocessing because the model handles sRGB fine. If your inputs aren't exhibiting green shift or clipping, you're adding a transformation for no benefit. Reach for this when you have the problem, not preemptively. And yes - personal use is free, commercial use needs the pack's paid license, preprocessing node or not.