Add scene-harmonisation final pass: match the photo's grain + colour cast over the swapped head so the GAN-smooth face/hair stop looking synthetic/pasted and read as photographed with the scene

Hair robustness (100-img batch): lighting match only DARKENS hair (no grey wash on bright bg) + conservative grey-edge trim that won't cut lit/highlighted hair

Fix facial discolour patches: restrict the neck/body skin pass to strictly below the chin (it was recolouring lips + cheek-ring -> patches on the face)

Hair edge: soft strand edge for both paths (loosen clamp) + remove portrait grey crown by COLOUR not cropping -> no website grey line AND no hard cut-out, local/HF identical

Fix website grey hair line: raise scene-fill threshold + clamp matte to confident-hair extent (kills the faint grey crown haze); drop guided filter for local/HF parity (no ximgproc on HF)

Hair/forehead high-precision edge via guided filter (edge-aware matte) + gentle neck/body skin pass; opencv-contrib-headless on HF for ximgproc

Hair edge: composite with BiSeNet SOFTMAX hair matte (soft strand alpha) instead of a feathered binary mask -> real wispy hair edges, no cut-paste look, both genders

Hair edge: smoother feather (0.025) for natural soft edges both genders, no hard cut-off; gentler lighting keeps it grey-free

Hair edge: crisper feather + erode-to-solid + gentler lighting match -> natural hairline, no grey fringe on dark hair

Hair blend: fill portrait grey padding with the scene before feathering (kills the blurry pasted halo) + tighter edge feather -> natural hair edges

Hair swap: run Laplacian blend BEFORE hair (it was overwriting transferred hair with target's); opaque core + soft edge + recolour residual old hair for a seamless blend, both genders

Skin tone: single uniform LAB offset over whole skin (no gate/per-region) -> no patches; verified clean across 10 tones light-to-dark, strength 0.92

Skin tone: recolour face-skin + body to SOURCE complexion (sampled from clean parsed skin, lips/eyes excluded, relative luminance gate) — clean on normal faces

Skin tone: leave face untouched (swap already source-toned), only lift neck/arms/hands to match face — fixes blue/blotchy face patch

Skin tone: drive face+neck+body to SOURCE complexion (per-region delta), with luminance gate so beard/brows don't go blue

Skin tone: blend across whole body (face+neck+arms+hands) via adaptive chroma mask, clothes/background excluded

Fix close-up selfie detection: pad margin so face-fills-frame photos are found (0 faces -> crude paste was the no-hair/skin bug)

Fix hair composite: widen parse crop + region clamp so long hair transfers into scene (re-enable hair by default)

Auto de-roll tilted source faces (eye-line alignment) before swap

Enable GPU for InsightFace: auto-add CUDA12 + cuDNN9 DLL dirs on Windows

Swap only the main subject + always run face swap (fixes the mess)

Fix: list_locations resilient when message column missing (was showing 0)

Custom per-location result messages + unique defaults; remove em-dashes & "4K"

Fix core swap: auto-download InsightFace buffalo_l + glasses in both paths

Add Supabase migration script + explicit sort_order; gitignore Location images

Store target images in Supabase (table + Storage) with local FS fallback

Improve face-neck-hair pipeline per 7-step checklist

Fix all listed technical challenges across detection, landmarks, segmentation

feat: head swap — keep the SOURCE's face shape (not just identity)

fix: natural 4K upscale + hair/glasses on by default (toggles hidden)

fix: glasses look natural — eye-locked alignment + see-through lenses

fix: hair paste-back + transfer source glasses onto the swap

feat: local GPU HairFastGAN hair transfer (auto-selects local, else HF Space)

feat: high-quality hair transfer via hosted HairFastGAN Space (opt-in)

fix: match face AND neck to source tone (kill the pasted-jaw seam)

feat: experimental hair/head swap (opt-in)

feat: match swapped face complexion to the source

fix: full-identity swap — stop pasting target eyes back over every swap

feat: enable GFPGAN on HF CPU deploy; CPU-aware upscaling

fix: GFPGAN face restoration removes swap blur; simplify pipeline; GPU 4K

test: fix false-positive pipeline test + cover super-res and face-mask paths

fix: sharp output, source skin tone preservation, 4K upscaling pipeline

feat: restore glasses/eye region from target after swap, preserve spectacles cleanly

feat: sharpen face region + bilateral skin smoothing after InsightFace swap

fix: add explicit cv2.data import, add onnxruntime to CI deps

feat: auto-detect GPU/CPU for InsightFace and PyTorch (RTX 4060 locally, CPU on HF)

fix: correct retry logic for background model downloads, fix pyrightconfig extraPaths

fix: use relative import in swapper, add pyrightconfig for IDE

fix: deduplicate InsightFace instance, add load-once sentinel to prevent retry loops

fix: use popup auth (redirect needs Firebase Hosting), fix BGR/RGB bug in InsightFace calls