Instructions to use thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora with Diffusers:
pip install -U diffusers transformers accelerate
from diffusers import ControlNetModel, StableDiffusionControlNetPipeline controlnet = ControlNetModel.from_pretrained("thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora") pipe = StableDiffusionControlNetPipeline.from_pretrained( "black-forest-labs/FLUX.2-klein-base-9B", controlnet=controlnet ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- Draw Things
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 phrase: apply pose from image 1 with reference from image 2
π Examples
Each preview is a single combined image from ComfyUI: Pose β Reference β Result (left to right).
| Pose β Reference β Result |
|---|
![]() |
![]() |
![]() |
![]() |
![]() |
π 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.
FLUX.2 Klein 9B Base already handles reference + pose transfer reasonably well with the right prompt alone. This LoRA builds on that capability β it improves consistency and better preserves character identity and pose fidelity than the base model without LoRA.
Part of the RefControl family: reference + control fusion for consistent, controllable generation on FLUX.2 Klein 9B Base.
βοΈ How to use
- Use the first image as the pose control map (skeleton / keypoints).
- Use the second image as the reference (character, person, or object).
- Add the trigger phrase
apply pose from image 1 with reference from image 2in your prompt. - Adjust LoRA weight (recommended 0.8β1.0) depending on how strongly you want to preserve identity.
ComfyUI requirenments
Pose extraction in the included workflow uses DWPose (via comfyui_controlnet_aux):
https://github.com/Fannovel16/comfyui_controlnet_aux
Base model
Trained on and recommended with 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).
The LoRA also works with the 4-step distilled black-forest-labs/FLUX.2-klein-9B for faster inference (~4 steps, guidance_scale ~1.0), but quality may be slightly lower β especially for identity and pose fidelity β compared to the Base model.
β Example prompt
apply pose from image 1 with reference from image 2
π― 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.
- 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.
π¦ Files
- Weights:
refcontrol_v2_poses.safetensors - ComfyUI workflow:
refcontrol_pose_flux_klein_9b.json - Repo: thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora
- Downloads last month
- 16
Model tree for thedeoxen/refcontrol-FLUX.2-klein-9B-reference-pose-lora
Base model
black-forest-labs/FLUX.2-klein-base-9B.png)
.png)
.png)
.png)
.png)