---
library_name: peft
tags:
  - image-editing
  - lora
  - robotics
  - hand-editing
base_model:
  - meituan-longcat/LongCat-Image-Edit
  - Shitao/OmniGen-v1
  - black-forest-labs/FLUX.2-klein-base-4B
  - stepfun-ai/Step1X-Edit
---

# HandEdit LoRA

HandEdit provides parameter-efficient LoRA adapters that specialize four
open-source image-editing backbones for human-to-robot-hand replacement.

We build more than 20K aligned training pairs from the HandEdit data. Each pair
contains an input image with a real human hand interacting with an object and a
corresponding target image in which only the hand is replaced by an Inspire
robotic hand. The training instruction asks the model to preserve the original
wrist pose, finger configuration, grasp relation, object contact points,
interaction object, background, lighting, and camera viewpoint as closely as
possible.

Only LoRA parameters are released; the full base-model weights are not
redistributed.

## Models

| Adapter | Official base model | Local checkpoint |
| --- | --- | --- |
| LongCat-Image-Edit | [`meituan-longcat/LongCat-Image-Edit`](https://huggingface.co/meituan-longcat/LongCat-Image-Edit) | `checkpoints/longcat/` |
| OmniGen-v1 | [`Shitao/OmniGen-v1`](https://huggingface.co/Shitao/OmniGen-v1) | `checkpoints/omnigen/` |
| FLUX.2 Klein Base 4B | [`black-forest-labs/FLUX.2-klein-base-4B`](https://huggingface.co/black-forest-labs/FLUX.2-klein-base-4B) | `checkpoints/flux2/handedit_flux2_klein4b_lora.safetensors` |
| Step1X-Edit | [`stepfun-ai/Step1X-Edit`](https://huggingface.co/stepfun-ai/Step1X-Edit) | `checkpoints/step1x/inspire_step1x_r32_a16_res512.safetensors` |

## Download

**[Download all four sanitized LoRA checkpoints](https://huggingface.co/HandEdit/HandEdit-LoRA/resolve/main/checkpoints.zip?download=true)**

Or download and verify them from the command line:

```bash
pip install huggingface_hub
python scripts/download_weights.py
python scripts/verify_weights.py
```

The published ZIP and individual adapter files are hosted in
[`HandEdit/HandEdit-LoRA`](https://huggingface.co/HandEdit/HandEdit-LoRA).

## Inference

Detailed environment setup and commands are in
[`docs/INFERENCE.md`](docs/INFERENCE.md). The shortest examples are:

```bash
# LongCat-Image-Edit
python scripts/infer_longcat_lora.py \
  --input_dir ./examples/input --output_dir ./outputs/longcat

# OmniGen-v1
python scripts/infer_omnigen_lora.py \
  --input_dir ./examples/input --output_dir ./outputs/omnigen

# FLUX.2 Klein Base 4B
python scripts/infer_flux2_lora.py \
  --input_dir ./examples/input --output_dir ./outputs/flux2

# Step1X-Edit
python scripts/infer_step1x_lora.py \
  --repo_dir ./third_party/Step1X-Edit \
  --model_dir ./weights/Step1X-Edit \
  --input_dir ./examples/input --output_dir ./outputs/step1x \
  --quantized --offload
```

## Release hygiene

The public weights are sanitized copies. Training-data identifiers, dataset
sizes, local paths, author fields, timestamps, session information, and other
training-process metadata were removed without changing tensor bytes. See
[`SANITIZATION.md`](SANITIZATION.md) and `weights_manifest.json`.

## Base-model licenses

Users must follow the license and access terms of each official base model.
This repository does not redistribute the four base models.