<h1 id="adaptive-reactor-face-swapper">Adaptive ReActor Face Swapper</h1>An adaptive ComfyUI video face-swapping workflow that uses ReActor, Florence-2, frame-similarity caching, and true lazy branch selection to process easy and difficult frames differently.Instead of applying expensive facial masking to every frame, the workflow analyzes frame difficulty and selects one of two processing paths:<ul><li>Easy frames: ReActor face swap only</li><li>Hard frames: ReActor face swap with ReActor Mask Helper</li></ul>Hard frames may include open mouths, visible tongues, hands or fingers near the face, facial obstructions, strong profile angles, or other situations where a basic face swap may blend poorly.<h2 id="main-features">Main features</h2><ul><li>Adaptive per-frame quality routing</li><li>ReActor face swapping</li><li>ReActor Mask Helper for difficult frames</li><li>Florence-2 frame descriptions</li><li>Frame-similarity caching</li><li>Reuses decisions for visually similar frames</li><li>True lazy branch execution</li><li>Sequential video processing</li><li>Support for long videos through VHS meta-batching</li><li>Optional Flux FaceDetailer section</li><li>Low-VRAM guidance</li><li>Built-in instructions and troubleshooting notes</li><li>H.264 MP4 video output</li></ul><h2 id="how-it-works">How it works</h2>The original video frame is sent to the AI Quality Controller.The controller compares the current frame with the previous frame:<ul><li>Similar frames reuse the previous Florence description and hard/easy decision.</li><li>Significantly changed frames are described again and receive a new decision.</li></ul>The decision is sent to a lazy image selector:<ul><li><code>False / Easy</code> selects the ReActor-only result.</li><li><code>True / Hard</code> selects the ReActor + Mask Helper result.</li></ul>Only the selected processing branch should execute.<h2 id="required-companion-workflow">Required companion workflow</h2>This workflow uses a saved ReActor face model.A separate Face Model Compiler is provided for building a compatible <code>.safetensors</code> face model from either:<ul><li>image folders</li><li>a source video with sampled frames</li></ul>Place the resulting face model in: "ComfyUI/models/reactor/faces/"Then select it through the included <code>ReActor Load Face Model</code> node.<h2 id="required-custom-nodes">Required custom nodes</h2>The workflow uses nodes from packages including:<ul><li> ComfyUI-ReActor </li><li> ComfyUI Video Helper Suite </li><li> Florence-2 nodes </li><li> ComfyUI Impact Pack / Impact Subpack </li><li> ComfyUI-GGUF for the optional FaceDetailer path </li><li> Frame Similarity Cache and Lazy Image Selector companion nodes </li></ul>Use ComfyUI Manager to install missing nodes where available.<h2 id="required-models">Required models</h2>Depending on the enabled sections, you may need:<ul><li><code>inswapper_128.onnx</code> </li><li> RetinaFace face detector </li><li> GFPGAN or another supported face-restoration model </li><li> Florence-2 model </li><li> SAM model for ReActor Mask Helper </li><li> saved ReActor face model </li><li> optional Flux, CLIP, VAE, and YOLO face detector for FaceDetailer </li></ul><h2 id="important-settings">Important settings</h2>Keep:"frames_per_batch = 1"The similarity cache compares frames sequentially and is not designed for multiple frames per meta-batch.Match the Video Combine frame rate to the source video.For lower-VRAM GPUs, begin with an input width of approximately <code>512–640</code>.<h2 id="important-preview-warning">Important preview warning</h2>ComfyUI <code>Preview Image</code> nodes are output nodes.Enabling a preview connected directly to either processing branch can force that branch to execute, defeating lazy routing.During normal rendering, keep these previews disabled:<ul><li> ReActor-only result </li><li> Mask Helper result </li><li> swapped-face preview </li><li> FaceDetailer preview </li></ul>The final lazy selector should be the only processed-image output connected to the active Video Combine node.<h2 id="starting-a-different-video">Starting a different video</h2>The frame-similarity cache may persist while ComfyUI remains open.Before processing a different source video:<ul><li> restart ComfyUI, or </li><li> reset the cache once and return the reset control to its normal state </li></ul>This prevents the first frames of a new video from reusing a decision from the previous video.<h2 id="performance-expectations">Performance expectations</h2>Processing speed depends heavily on the selected branch.<ul><li> Easy frames should remain close to normal ReActor processing time. </li><li> Hard frames will take longer because Mask Helper performs face detection, segmentation, and blending. </li><li> FaceDetailer adds substantial additional processing time. </li></ul><h2 id="optional-facedetailer">Optional FaceDetailer</h2>The included FaceDetailer section is disabled by default.It can improve small or compressed faces, but it may increase render time and cause identity drift if denoise is too high.Recommended starting values: Steps: 4-8Denoise: 0.10-0.15Seed: Fixed for videoGuide size: 384-512<h2 id="recommended-use">Recommended use</h2>This workflow is best suited for videos containing a mixture of:<ul><li> normal front-facing frames </li><li> mouth movement </li><li> profile changes </li><li> hands near the face </li><li> partial facial obstruction </li><li> varying expressions </li></ul><h2 id="limitations">Limitations</h2>The AI controller relies on Florence-2 descriptions and keyword rules. It may occasionally misclassify a frame.Results also depend on:<ul><li> the quality of the saved face model </li><li> source-video resolution </li><li> face size and visibility </li><li> motion blur </li><li> lighting </li><li> facial obstruction </li><li> selected restoration and masking settings </li></ul><h2 id="responsible-use">Responsible use </h2>Use this workflow only with content you are authorized to modify. Obtain appropriate consent and clearly disclose synthetic or altered media when it could reasonably be mistaken for authentic footage.

Adaptive ReActor Face Swapper – AI Quality Routing

v1.0 - Initial Public ReleaseFirst public release of the Adaptive ReActor Face Swapper workflow.Included features<ul><li>Adaptive hard/easy frame classification</li><li>ReActor-only processing for normal frames</li><li>ReActor Mask Helper processing for difficult frames</li><li>Florence-2 frame descriptions</li><li>Frame-similarity decision caching</li><li>True lazy branch execution</li><li>Sequential VHS meta-batch processing</li><li>Long-video support</li><li>Optional Flux FaceDetailer section</li><li>Built-in setup guide and troubleshooting notes</li><li>Low-VRAM recommendations</li><li>H.264 MP4 output configuration</li></ul>Important requirements<ul><li>Keep <code>frames_per_batch</code> set to <code>1</code>.</li><li>Keep processed branch preview nodes disabled during normal rendering.</li><li>Reset the frame-similarity cache or restart ComfyUI before processing a different video.</li><li>A compatible ReActor <code>.safetensors</code> face model is required.</li><li>The companion Face Model Compiler can create a face model from image folders or sampled video frames.</li></ul>Recommended first testUse a short video clip before attempting a full-length render. Verify that:<ul><li>ordinary frames take the ReActor-only path;</li><li>difficult mouth, profile, hand, or obstruction frames use Mask Helper;</li><li>the final video contains different sequential frames;</li><li>the output frame rate matches the source video.</li></ul>Known limitationsFrame classification relies on Florence-2 captions and keyword rules, so occasional misclassification is possible. Results depend heavily on the source resolution, face visibility, reference-model quality, motion blur, lighting, and obstruction.

Files with SHA256: a405086c93a407b47fa01f988d4ae4d94f3a3800686613372b6895542d7e93f3