Duplicate from Alissonerdx/BFS-Best-Face-Swap

Co-authored-by: Alisson Pereira Anjos <Alissonerdx@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,39 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+images/ComfyUI_04745_.png filter=lfs diff=lfs merge=lfs -text
+images/ComfyUI_04755_.png filter=lfs diff=lfs merge=lfs -text
+images/ComfyUI_04759_.png filter=lfs diff=lfs merge=lfs -text
+images/ComfyUI_04761_.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,191 @@
+---
+license: mit
+base_model:
+- black-forest-labs/FLUX.2-klein-9B
+- black-forest-labs/FLUX.2-klein-4B
+- black-forest-labs/FLUX.2-klein-base-4B
+- black-forest-labs/FLUX.2-klein-base-9B
+- black-forest-labs/FLUX.2-klein-9b-fp8
+- black-forest-labs/FLUX.2-klein-4b-fp8
+- Qwen/Qwen-Image-Edit-2511
+pipeline_tag: image-to-image
+tags:
+- lora
+- qwen-image-edit
+- face-swap
+- head-swap
+- image-editing
+- ai-generated
+- comfyui
+- bfs
+- flux 2
+- flux
+- klein
+language:
+- en
+library_name: diffusers
+---
+
+# 🧬 BFS — Best Face Swap (Qwen Image Edit 2509/2511, Flux 2 Klein 4b/9b)
+
+The **BFS (Best Face Swap)** LoRA series was created for **Qwen Image Edit 2509/2511, Flux 2 Klein 4b/9b**, designed to perform high-fidelity face and head swaps with natural tone blending and consistent lighting.
+
+Each version focuses on a different level of replacement, from subtle face swaps to full head transfers.  
+All models can be used directly with **Qwen Image Edit 2509/2511, Flux 2 Klein 4b/9b** or any compatible image-editing workflow.
+
+👉 **Workflows** for all BFS versions can be downloaded here:  
+[Head/Face Swap Workflow — Qwen Image Edit 2509 (Civitai)](https://civitai.com/articles/20190/headface-swap-workflow-qwen-image-edit-2509)
+
+---
+
+## 🔹 Versions Overview
+
+| Version | File(s) | Description |
+|---|---|---|
+| **BFS Face V1 – 2509** | `bfs_face_v1_qwen_image_edit_2509.safetensors` | Swaps **only the face**. Preserves target hair, lighting, and background. |
+| **BFS Head V1 – 2509** | `bfs_head_v1_qwen_image_edit_2509.safetensors` | Full head swap with natural blending between head/hair and target body. |
+| **BFS Head V2 – 2509** | `bfs_head_v2_qwen_image_edit_2509.safetensors` | Improved skin tone matching, pose alignment, and anatomical consistency. |
+| **BFS Head V3 – 2509 (Recommended)** | `bfs_head_v3_qwen_image_edit_2509.safetensors` | Stable and accurate. **Input order is inverted** (body first, then face). |
+| **BFS Head V4 – 2509/2511** | `bfs_head_v4_qwen_image_edit_2509.safetensors` | Stronger expression transfer and robustness. **Inverted input order**. |
+| **BFS Head V5 – 2511 (Recommended)** | `bfs_head_v5_2511_original.safetensors`<br>`bfs_head_v5_2511_merged_version_rank_16_fp16.safetensors`<br>`bfs_head_v5_2511_merged_version_rank_32_fp32.safetensors` | Latest release for 2511 workflows. **Inverted input order**. See details below. || **Head V5** | **Body** | **Face** | ⚠️ Inverted order — send body first, then face. |
+| **BFS Head V1 – Flux 2 Klein 4/9b (Recommended)** | `bfs_head_v1_flux-klein_4b.safetensors`<br>`bfs_head_v1_flux-klein_9b_step3500_rank128.safetensors`<br>`bfs_head_v1_flux-klein_9b_step3750_rank64.safetensors` | **Inverted input order**. See details below. |
+
+---
+
+## 🧠 BFS Head V5 details (2511)
+
+This release includes multiple variants:
+
+- **100% original**: direct result of training for **5,500+ steps** on model 2511  
+- **Merged versions**: a merge of **BFS Head V4 (2509)** into the 2511-trained original
+
+In my evaluation, the **merged version performs better**, especially at reproducing a wider range of expressions.  
+It is not perfect yet, but it indicates we are moving in the right direction.
+
+---
+
+## 🖼️ Input Structure (Control Images)
+
+| Version | Image 1 | Image 2 | Notes |
+|---|---|---|---|
+| **Face V1** | Face | Body | Standard order. Swaps face only. |
+| **Head V1** | Face | Body | Standard order. Full head swap with blending. |
+| **Head V2** | Face | Body | Standard order. Improved tone and alignment. |
+| **Head V3** | **Body** | **Face** | ⚠️ Inverted order — send body first, then face. |
+| **Head V4** | **Body** | **Face** | ⚠️ Inverted order — send body first, then face. |
+| **Head V5** | **Body** | **Face** | ⚠️ Inverted order — send body first, then face. |
+| **Head V1 Flux 2 Klein 4/9b** | **Body** | **Face** | ⚠️ Inverted order — send body first, then face. |
+---
+
+## 💬 Prompts
+
+### 🧠 BFS Face V1
+
+**Base prompt:**
+```
+
+face swap face from Image 1 to Image 2.
+
+```
+
+**Alternative:**
+```
+
+face swap face from Image 1 to Image 2. swap only the face (not the hair), match the skin tone to Image 2, keep Image 2 pose and lighting.
+
+```
+
+---
+
+### 🧩 BFS Head V1 – 2509 (Likely works with 2511)
+
+**Base prompt:**
+```
+
+head swap from Image 1 to Image 2
+
+```
+
+**Alternatives:**
+```
+
+head swap from Image 1 to Image 2 with perfect skin match
+Head swap from Image 1 to Image 2, keep all facial details and hair from Image 1, blend naturally with Image 2’s body.
+head swap face from Image 1 to Image 2, keep all facial details and hair from Image 1, blend naturally with Image 2’s body, remove all hair of Image 2 and replace by hair from Image 1 and keep the same expression and head proportion as in Image 2
+
+```
+
+---
+
+### 🧬 BFS Head V2 – 2509 (Likely works with 2511)
+
+```
+
+head swap, transfer head from Image 1 to Image 2
+
+```
+
+---
+
+### ⚡ BFS Head V3 – 2509 (Recommended) (Likely works with 2511)
+
+```
+
+head_swap: start with Picture 1 as the base image, keeping its lighting, environment, and background. remove the head from Picture 1 completely and replace it with the head from Picture 2. ensure the head and body have correct anatomical proportions, and blend the skin tones, shadows, and lighting naturally so the final result appears as one coherent, realistic person.
+
+```
+
+---
+
+### ⚡ BFS Head V4 – 2509 (Likely works with 2511)
+
+```
+
+h34d_sw4p: replace the head of Picture 1 by the head from Picture 2, strictly preserving the identity, facial features (eyes, nose, mouth), and skin texture of Picture 2. ensure the new head mimics the identical expression, angle, and rotation found in Picture 1.
+
+```
+
+---
+
+### ⚡ BFS Head V5 – 2511 (Recommended)
+
+```
+
+head_swap: start with Picture 1 as the base image, keeping its lighting, environment, and background. remove the head from Picture 1 completely and replace it with the head from Picture 2, strictly preserving the hair, eye color, and nose structure of Picture 2. copy the eye direction, head rotation, and micro-expressions from Picture 1. high quality, sharp details, 4k
+
+```
+
+
+### ⚡ BFS Head V1 – Flux 2 Klein 4b/9b (Recommended)
+
+```
+
+head_swap: start with Picture 1 as the base image, keeping its lighting, environment, and background. remove the head from Picture 1 completely and replace it with the head from Picture 2, strictly preserving the hair, eye color, nose structure of Picture 2. copy the direction of the eye, head rotation, micro expressions from Picture 1, high quality, sharp details, 4k.
+
+[Optional]Describe the expression in Picture 1 and copy it to the new image.
+
+[Optional][You can describe the facial expression or other details here.]
+
+```
+
+<p align="center"> <img src="images/ComfyUI_04745_.png" width="100%" /> <img src="images/ComfyUI_04755_.png" width="100%" /> <img src="images/ComfyUI_04759_.png" width="100%" /> <img src="images/ComfyUI_04761_.png" width="100%" /> </p>
+
+---
+
+## 🧾 Notes
+
+- Works best with **Qwen Image Edit 2509** base model (and some versions also perform well on 2511).
+- Control image order:
+  - **Face V1 / Head V1 / Head V2** → **Image 1 = Face**, **Image 2 = Body**
+  - **Head V3 / Head V4 / Head V5** → **Image 1 = Body**, **Image 2 = Face** (inverted order)
+- For improved alignment, you may optionally use pose or face mesh controls.
+- Please **do not use or share results involving public figures or individuals who have not given consent**.
+
+---
+
+## ☕ Support
+
+If this project helped you, consider supporting my work:  
+https://buymeacoffee.com/nrdx
+
+---

bfs_face_v1_qwen_image_edit_2509.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c9f18ba062d0c8aa3c98169005b616bc95866fe9956c2608dcfd29b1e9b20359
+size 590058816

bfs_head_v1_flux-klein_4b.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:77aabcd6144612dd4873080b99283dd9a27977712548bee161894f62c91ff09c
+size 369644384

bfs_head_v1_flux-klein_9b_step3500_rank128.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:70d8aaf332d710b905d5085afaa87c3ef577edffd54ffcfadeb8c47a854f9044
+size 662729912

bfs_head_v1_flux-klein_9b_step3750_rank64.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:49907a240602488d2846861d7570dd95d80609f44be7e3347965735712b1be16
+size 331379568

bfs_head_v1_qwen_image_edit_2509.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d71ee1612e4b416fc0f62a1a59a3d66b7ee6d86a1a7c35aacc2f929e0326f68d
+size 590058808

bfs_head_v2_qwen_image_edit_2509.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a928f106fcba6e4b196ef511289f075b4690eba0f6bc3fa3755fdba2ec2a428c
+size 147687224

bfs_head_v3_qwen_image_edit_2509.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:49aac5a55175ab5ebd89ffdae4c336eaca1899f5b725b70c0c039f6d4a8d86e6
+size 73957904

bfs_head_v4_qwen_image_edit_2509.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:cd3278c33c7df36bb87169d0a283851d60e88ecac48123b5c8dcc82551d6e402
+size 147794944

bfs_head_v5_2511_merged_version_rank_16_fp16.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:1315a08947e5d6d7c53ea4fc59f272e0d54efd7f2da35999b7d873a7cf4fa89b
+size 307464216

bfs_head_v5_2511_merged_version_rank_32_fp32.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0a137e61245781412421f5dee5db4ccac28b6c9952c042d1123a84609107cd10
+size 1206402600

bfs_head_v5_2511_original.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5055ec271228d4767fd327efa59dbdea6f2a628d6d890101eb4fd5015cb1ac57
+size 147685552