Update README.md

README.md

@@ -1,52 +1,129 @@
 ---
+license: apache-2.0
+base_model:
+- black-forest-labs/FLUX.2-klein-base-9B
+pipeline_tag: image-to-image
 tags:
-- text-to-image
+- flux
+- flux2
+- klein
+- pose
+- openpose
+- controlnet
+- refcontrol
+- img2img
+- image
+- editing
 - lora
-- diffusers
-- template:diffusion-lora
-widget:
-- output:
-    url: images/ComfyUI_00165_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00166_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00167_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00170_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00183_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00198_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00211_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00217_.png
-  text: '-'
-- output:
-    url: images/ComfyUI_00219_.png
-  text: '-'
-base_model: black-forest-labs/FLUX.2-klein-base-9B
-instance_prompt: refcontrol
-license: apache-2.0
+library_name: diffusers
 ---
+
 # RefControl FLUX.2 Klein 9B – Reference Pose LoRA
 
+## 📝 Short description
+A LoRA for **FLUX.2 Klein 9B Base** that fuses a **reference image** (identity) with a **pose control map** (skeleton / keypoints).  
+It preserves **identity and style** from the reference while following the **body pose and structure** from the pose map.
+
+**Trigger word:** `refcontrol`
+
 <Gallery />
 
+---
+
+## 📊 Examples
+
+Each preview is a **single combined image** from ComfyUI: **Pose → Reference → Result** (left to right).
+
+<table>
+  <thead>
+    <tr>
+      <th>Pose → Reference → Result</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00165_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00166_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00167_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00170_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00183_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00211_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00217_.png" width="960" /></td>
+    </tr>
+    <tr>
+      <td><img src="https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/resolve/main/images/ComfyUI_00219_.png" width="960" /></td>
+    </tr>
+  </tbody>
+</table>
+---
+
+## 📖 Extended description
+This LoRA was primarily trained on **humans**, but it also works with **stylized characters** and some objects.  
+Its main purpose is to **preserve identity** — facial features, hairstyle, clothing, or object details — from the reference image, while adapting the subject to the **pose and skeleton structure** defined by the control map.
+
+Part of the **RefControl** family: reference + control fusion for consistent, controllable generation on **FLUX.2 Klein 9B Base**.
+
+---
+
+## ⚙️ How to use
+1. Use the **first image** as the **pose control map** (skeleton / keypoints).
+2. Use the **second image** as the **reference** (character, person, or object).
+3. Add the trigger word **`refcontrol`** in your prompt.
+4. Adjust LoRA weight (recommended **0.8–1.0**) depending on how strongly you want to preserve identity.
 
-## Trigger words
+## ComfyUI requirenments
+For extracting pose you need to install nodes with pose estimation in workflow used:
 
-You should use `refcontrol` to trigger the image generation.
+https://github.com/Fannovel16/comfyui_controlnet_aux
 
+### Base model
+Use with [`black-forest-labs/FLUX.2-klein-base-9B`](https://huggingface.co/black-forest-labs/FLUX.2-klein-base-9B).  
+The undistilled Base variant is intended for LoRA training and custom pipelines (~50 inference steps, `guidance_scale` ~4.0).
 
-## Download model
+### ✅ Example prompt
 
+```
+refcontrol
+```
+
+---
+
+## 🎯 What it does
+- Preserves **character or object identity** across generations.
+- Adapts the subject to a **new pose or action** defined by the skeleton map.
+- Works best when the pose map has **similar proportions and scale** to the reference.
+
+---
+
+## ⚡ Tips
+- Best results when the pose map is not drastically different in body scale or framing from the reference.
+- Combine with **text prompts** to refine background, lighting, or mood.
+- Can be combined with other **RefControl** LoRAs (depth, lineart, canny) on compatible pipelines for multi-constraint generation.
+- OpenPose / DWPose skeleton maps on a **black background** work well as control input.
+
+---
+
+## 📌 Use cases
+- Character posing for illustrations, comics, or storyboards.
+- Consistent **character design** across different poses.
+- Re-posing stylized characters while keeping their identity.
+- Creating animation keyframes from static references.
+
+---
 
-[Download](/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/tree/main) them in the Files & versions tab.
+## 📦 Files
+- **Weights:** [`flux2_klein_9b_refcontrol_pose.safetensors`](https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/blob/main/flux2_klein_9b_refcontrol_pose.safetensors)
+- **ComfyUI workflow:** [`image_flux2_klein_image_edit_9b_refcontrol_pose.json`](https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora/blob/main/image_flux2_klein_image_edit_9b_refcontrol_pose.json)
+- **Repo:** [thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora](https://huggingface.co/thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora)