⚡ Ultra Pro Face Swap 4K Pipeline — Dual Restoration + ESRGAN | ComfyUI — v1.0

📋 Version History

---

⚡ v4.3.0 — Current Release

Stability Fix

• Fixed ReActorFaceBoost node — correctly configured as settings-only node (no image input)

• Removed incorrect image connection to FaceBoost

• FACE_BOOST output now properly feeds into ReActorFaceSwap enhancement slot

---

🔧 v4.2.0

Compatibility Fix

• Fixed interpolation value: 'lanczos' → 'Lanczos' (case-sensitive ComfyUI requirement)

• Replaced unavailable upscale model with 8x_NMKD-Faces_160000_G.pth

• Switched to face-optimized 8x upscaler for superior portrait results

---

🔗 v4.1.0

Pipeline Architecture Fix

• Fixed critical type mismatch: FACE_BOOST output was incorrectly routed to ImageUpscaleWithModel (expects IMAGE )

• Corrected FaceBoost role: now feeds as enhancement input to ReActorFaceSwap, not post-processor

• Fixed ESRGAN upscale input to receive SWAPPED_IMAGE directly from ReActorFaceSwap

---

🚀 v4.0.0 — Initial Release

Full Pipeline Build

• 18-node professional workflow

• Dual restoration: GFPGAN (inline) + ReActorFaceBoost (enhancement pass)

• 3-stage source preparation: 512px → 1024px

• 2048px target preparation for maximum detail preservation

• 8x ESRGAN face-optimized upscaling

• Dual output: HD 1536px + 4K 4096px simultaneously

• 6 color-coded node groups

• Full in-workflow documentation (Guide + Requirements + Pro Tips)

---

🗑️ Deprecated (from base workflow)

| What | Why Removed |

|---|---|

| center crop on source | Was cutting face edges |

| 768px source optimization | Replaced with 1024px |

| codeformer_weight: 0.5 | Raised to 0.75 for sharper results |

| Inconsistent 1316×1365 output | Replaced with clean 4096×4096 |