Instructions to use thedeoxen/refcontrol-FLUX.2-klein-9B-reference-normal-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-normal-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-normal-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 Normal LoRA
π Short description
A LoRA for FLUX.2 Klein 9B Base that fuses a reference image (identity) with a normal map (structure / surface orientation).
It preserves identity and style from the reference while following the 3D shape and composition from the normal control map.
Trigger word: refcontrol
π Examples
Each preview is a single combined image from ComfyUI: Normal β Reference β Result (left to right).
| Normal β 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 structure and surface orientation defined by the normal map.
FLUX.2 Klein 9B Base already handles reference + normal-guided transfer reasonably well with the right prompt alone. This LoRA builds on that capability β it improves consistency and better preserves character identity and normal-map 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 normal map (structure / surface orientation).
- Use the second image as the reference (character, person, or object).
- Add the trigger word
refcontrolin your prompt. - Adjust LoRA weight (recommended 0.8β1.0) depending on how strongly you want to preserve identity.
ComfyUI requirements
Normal map extraction in the included workflow uses DSINE-NormalMapPreprocessor (via comfyui_controlnet_aux):
https://github.com/Fannovel16/comfyui_controlnet_aux
You can disable the built-in normal preprocessor if your input is already a normal map image.
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 normal-map fidelity β compared to the Base model.
β Example prompt
refcontrol
π― What it does
- Preserves character or object identity across generations.
- Adapts the subject to a new structure or composition defined by the normal map.
- Works best when the normal map has similar proportions and scale to the reference.
β‘ Tips
- Best results when the normal map is not drastically different in body scale or framing from the reference.
- Combine with text prompts to refine background, lighting, or mood.
- Normal maps with clear surface orientation and consistent lighting work well as control input.
π Use cases
- Character restyling while keeping identity and normal-defined structure.
- Consistent character design across different compositions.
- Illustration and storyboard generation with normal-guided layout.
- Object transformations with surface-orientation-guided placement.
π¦ Files
- Weights:
flux2_klein_9b_refcontrol_normal.safetensors - ComfyUI workflow:
refcontrol_normal_flux_klein_9b.json - Repo: thedeoxen/refcontrol-FLUX.2-klein-9B-reference-normal-lora
- Downloads last month
- -
Model tree for thedeoxen/refcontrol-FLUX.2-klein-9B-reference-normal-lora
Base model
black-forest-labs/FLUX.2-klein-base-9B.png)
.png)
.png)
.png)
.png)