◎ Radiance v2.3.3 — Professional VFX & HDR Suite for ComfyUI
Radiance is a professional, VFX-grade 32-bit float color science suite for ComfyUI. Built for film colorists and VFX artists who require absolute precision in their AI-assisted workflows.
Installation · Getting Started · Node Reference · Quick Start · Viewer Shortcuts · Documentation · Support
Important
Native 32-Bit Scene-Linear Engine
Unlike standard ComfyUI nodes that clamp to 8-bit, Radiance preserves full IEEE 754 floating-point precision across the entire chain. Zero banding. Zero data loss.
- Smart Overwrite Protection —
Radiance WriteandEXR Savenow feature automated index detection to prevent accidental file destruction. - Universal Digital Cinema I/O — Consolidated Video, Image Sequence, and Single Image handling into a high-performance unified pipeline.
- Robust Pipeline Validation — Enhanced null-safety and input checking for high-load production environments.
- Terminal HUD & Live REPL — Nuke-style Python interaction directly inside the viewer for real-time data inspection.
- Interactive Mask Editor — Non-destructive brush masking in
◎ Radiance Load Image. - ◎ Radiance Grade Match — Shot-to-shot color statistics transfer using CIE L*a*b* mean/std math.
The Radiance Workspace node is the command center for your production. It handles project paths, versioning, and state management, ensuring that all 32-bit data is tracked correctly across your workflow.
- Add the Workspace Node: Right-click > Radiance > Project > Radiance Workspace.
- Set your Project Path: Point it to your production directory.
- Connect to Viewer: Link the
workspaceoutput to the Radiance Viewer to enable live telemetry and Python REPL.
The suite is organized into 11 specialized production zones to mirror industry-standard VFX software topology.
◎ Project, Metadata & DNA (8 Nodes)
| Node | Description |
|---|---|
| Radiance Workspace | Local Project, Shot & Version management with secure .rad v2 containers |
| Radiance Manager | Cinematic Prompt Studio with 30+ Camera/Lens profiles |
| Radiance DNA Reader/Writer | Extraction and injection of cinematic metadata |
| Radiance DNA Validator | SHA256 integrity and version checking for workflow files |
| Radiance Metadata Overlay | Custom burned-in metadata (Project, Shot, Resolution) |
◎ Production I/O & Loaders (10 Nodes)
| Node | Description |
|---|---|
| Radiance Read / Write | Universal 32-bit I/O with auto-increment and high-bitrate support (H.265 10-bit, ProRes) |
| Radiance Unified Loader | Smart model loader (Flux/SDXL) with precision auto-detection |
| Radiance LoRA Stack | Multi-layer LoRA management in a single node |
| Radiance CLIP Slot | Specialized CLIP conditioning slots for multi-prompt chains |
| Radiance Image & Mask | Professional loader with non-destructive mask layering |
◎ HDR Imaging & Color Science (23 Nodes)
| Node | Description |
|---|---|
| OCIO Color Transform | Industry-standard OpenColorIO v2.2 integration |
| ACES 2.0 Output | Professional ACES 2.0 Display/View transforms |
| Log Curve Decode/Encode | Precise curves for LogC3/C4, S-Log3, REDLog, etc. |
| HDR Tone Map / Expand | Advanced dynamic range recovery and tonemapping |
| Radiance VAE Encode/Decode | 16-bit precision VAE processing for high-fidelity latents |
| Radiance LUT Apply/Blend | GPU-accelerated 33³ LUT processing with smooth blending |
| Wide Gamut Utilities | DaVinci and ARRI Wide Gamut color space primitives |
◎ VFX Grading & Analysis (15 Nodes)
| Node | Description |
|---|---|
| Radiance Grade | 32-bit Lift/Gamma/Gain/Offset with cinematic presets |
| Radiance Grade Match | CIE L*a*b* mean/std statistics transfer for shot matching |
| Apply Grade Info | Replay saved grade JSON strings onto new shots with strength control |
| Radiance Waveform | GPU-accelerated RGB Parade / Luma / Overlay |
| Radiance Vectorscope | Phase-accurate hue/sat monitoring with Skin Tone line |
| Radiance False Color | IRE-calibrated 7-zone exposure mapping |
| Radiance QC Pro | Automated technical QC (Gamut, Clip, Banding) |
◎ AI Vision & Temporal (15 Nodes)
| Node | Description |
|---|---|
| Radiance Sampler Pro | High-end sampling (Flux/WAN) with AYS and Dynamic Guidance |
| Radiance Resolution | Advanced resolution selection with 8-pixel alignment |
| Depth Anything V2 | Professional monocular depth estimation |
| Radiance Temporal Smooth | Motion-aware EMA flicker reduction for AI video |
| Radiance Pro Upscale | Vectorized kernel upscaling (Lanczos/Mitchell/Catmull-Rom) |
- Open ComfyUI Manager
- Search for Radiance
- Click Install
cd ComfyUI/custom_nodes
git clone https://github.com/fxtdstudios/radiance.git
cd radiance
pip install -r requirements_windows.txt # Or linux/mac_siliconTip
Linux/macOS Users: Ensure you have libopenexr-dev installed via your package manager before running the requirements install.
If ComfyUI Manager refuses to install Radiance because only the default channel is allowed, install manually with Git:
cd ComfyUI/custom_nodes
git clone https://github.com/fxtdstudios/radiance.git
cd radiance
pip install -r requirements.txtRestart ComfyUI after installation. If you use a platform-specific requirements file, choose requirements_windows.txt, requirements_linux.txt, or requirements_mac_silicon.txt.
Radiance avoids strict upper version caps where possible so ComfyUI and other custom nodes can resolve shared packages. If another extension conflicts, reinstall Radiance dependencies last, then restart ComfyUI.
Use ◎ Radiance Write, ◎ Radiance Save EXR, or ◎ Save Image 16-bit for managed outputs. Radiance writes non-overwriting filenames and reports saved files to ComfyUI history so API users can discover generated outputs from prompt history.
For EXR support, Radiance sets OPENCV_IO_ENABLE_OPENEXR=1 at import time, but the Python EXR packages must still be installed. On Linux, install the system OpenEXR development package before pip install -r requirements_linux.txt.
The viewer preview is interactive. To bake the result, run the workflow first, open the Radiance Viewer controls, then use the delivery/export controls. Grain, bloom, halation, diffusion, and denoise are baked by the delivery path; purely interactive display/navigation overlays are not part of the source image.
Radiance preserves 32-bit float values when upstream data contains them. It cannot recover highlight or shadow detail that was already clipped in an 8-bit source image. For true HDR workflows, start from EXR/HDR, scene-linear, or float outputs where possible.
◎ Radiance Viewer is the current viewer node. Legacy workflows that reference the older Pro Viewer name are mapped to the current viewer. Lens effects are in the Viewer Lens tab; use 32-bit mode for the widest HDR preview range and use the Strong Preview preset when tuning bloom, halation, and anamorphic streaks.
Use the .rad workflows in the workflows/ folder for current node layouts. Very old JSON workflows may contain stale widget order or renamed nodes and should be rebuilt or imported through the current Radiance Workspace tools.
Radiance is designed for a keyboard-driven VFX workflow. Use these shortcuts to monitor, grade, and navigate your shots with industry-standard precision.
| Key | Action |
|---|---|
| Space | Toggle Playback |
| ← / → | Previous / Next Frame |
| F | Fit to View |
| 1 | 1:1 Pixel Zoom |
| Shift + Drag | Pan Image |
| Esc | Exit Fullscreen / Close Panels |
| Key | Action |
|---|---|
| C | RGB (Color) View |
| R | Red Channel |
| G | Green Channel |
| B | Blue Channel |
| L | Luma Channel |
| Shift + A | Alpha Channel |
| Key | Action |
|---|---|
| W | Toggle Waveform (HDR-Aware) |
| M | Toggle Waveform Parade Mode |
| V | Toggle Vectorscope (w/ Skin Tone Line) |
| S | Cycle Safe Area Overlays |
| Shift + G | Cycle Grid Modes |
| A | Cycle A|B Compare Modes |
Radiance is backed by a professional team of VFX Technical Directors. Engage with us through our official channels:
- Production Workflows: Access exclusive
.radtemplates and cinema-grade JSON presets. - Direct Engineer Support: Real-time troubleshooting and feature requests.
- Showcase: share your work and get feedback from industry veterans.
- Beta Access: Test experimental HDR and temporal nodes before public release.
- Documentation: radiance.fxtd.org
- Issue Tracker: GitHub Issues
- Official Site: fxtd.org
- License: GPL-3.0
- Authors: Created by the FXTD Studios team.
- Technology: Built on OpenColorIO v2.2, OpenEXR, and Colour-Science.
- Special Thanks: The ComfyUI community for pushing the boundaries of AI generation.
- Reinhard, E., Ashikhmin, M., Gooch, B., Shirley, P. Color Transfer between Images. IEEE CGA, 2001.
- Hable, J. Filmic Tonemapping Operators. GDC 2010.
- Hill, S. HDR Color in Call of Duty. SIGGRAPH 2014.
- Academy of Motion Picture Arts and Sciences. ACES 2.0 Reference Rendering Transform. 2024.
- Sobotka, T. AgX: A Minimal Color Transform. Blender Institute, 2023.
- Magnor, M. et al. Digital Video Processing for Engineers. Morgan & Claypool, 2012.
- OpenColorIO Contributors. OpenColorIO v2 Architecture. ASWF, 2023.
- Colour-Science for Python. https://www.colour-science.org/. 2024.
- Narkowicz, K. ACES Filmic Tone Mapping Curve. Blog, 2016.
- ITU-R BT.1203. Subjective Picture Quality Assessment for Digital Cable Television Systems. ITU, 1994.