nielsr HF Staff commited on
Commit
222f535
路
verified 路
1 Parent(s): 72c643f

Add model card

Browse files

This PR adds a model card for the paper [FrameForge: Harnessing Priors of Video Foundation Models for Unified Image Generation](https://huggingface.co/papers/2610.36545). It adds the relevant `pipeline_tag` so the model can be found under image-to-image, includes license metadata, and provides usage examples from the official GitHub repository.

Files changed (1) hide show
  1. README.md +72 -0
README.md ADDED
@@ -0,0 +1,72 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: other
3
+ pipeline_tag: image-to-image
4
+ ---
5
+
6
+ # FrameForge: Harnessing Priors of Video Foundation Models for Unified Image Generation
7
+
8
+ [Paper](https://huggingface.co/papers/2610.36545) 路 [Project Page](https://lyne1.github.io/FrameForge-page/) 路 [Code](https://github.com/Lyne1/FrameForge)
9
+
10
+ FrameForge adapts the temporal priors of [HunyuanVideo 1.5](https://github.com/Tencent-Hunyuan/HunyuanVideo-1.5) for three conditional image-generation tasks with one model: **subject-driven generation**, **Canny-to-image generation**, and **instruction-guided image editing**. The condition image is treated as an earlier frame and the output image as a target frame. This repository provides the inference code for the three-expert, one-reasoning-latent configuration.
11
+
12
+ ## Usage
13
+
14
+ For installation and checkpoint setup, please refer to the [GitHub repository](https://github.com/Lyne1/FrameForge). Run the commands from the repository root. Replace the example paths with your own reference or condition image, prepared at **512 脳 512 pixels**. All three tasks generate a single **512 脳 512** output image and use 50 denoising steps.
15
+
16
+ ### Subject-driven generation
17
+
18
+ ```bash
19
+ CUDA_VISIBLE_DEVICES=0 MODEL_PATH=./ckpts bash scripts/infer.sh \
20
+ --lora_path ./checkpoints/pytorch_lora_weights.safetensors \
21
+ --input_image ./inputs/subject.jpg \
22
+ --reference_size 512 \
23
+ --prompt "the dog playing on a beach" \
24
+ --output_path ./outputs/subject.png \
25
+ --num_inference_steps 50
26
+ ```
27
+
28
+ ### Canny-to-image generation
29
+
30
+ Pass a Canny edge map as the input image. The manuscript uses guidance scale `2.0` for this task:
31
+
32
+ ```bash
33
+ CUDA_VISIBLE_DEVICES=0 MODEL_PATH=./ckpts bash scripts/infer.sh \
34
+ --lora_path ./checkpoints/pytorch_lora_weights.safetensors \
35
+ --input_image ./inputs/edges.png \
36
+ --reference_size 512 \
37
+ --prompt "A red car parked beside a lake at sunset" \
38
+ --output_path ./outputs/canny.png \
39
+ --num_inference_steps 50 --guidance_scale 2.0
40
+ ```
41
+
42
+ ### Instruction-guided image editing
43
+
44
+ Pass the source image and an editing instruction. The default guidance scale is `6.0`:
45
+
46
+ ```bash
47
+ CUDA_VISIBLE_DEVICES=0 MODEL_PATH=./ckpts bash scripts/infer.sh \
48
+ --lora_path ./checkpoints/pytorch_lora_weights.safetensors \
49
+ --input_image ./inputs/edit.png \
50
+ --reference_size 512 \
51
+ --prompt "Change the sky to sunset while preserving the rest of the scene" \
52
+ --output_path ./outputs/edited.png \
53
+ --num_inference_steps 50
54
+ ```
55
+
56
+ ## Citation
57
+
58
+ ```bibtex
59
+ @misc{lin2026frameforge,
60
+ title = {FrameForge: Harnessing Priors of Video Foundation Models for Unified Image Generation},
61
+ author = {Yijing Lin and Zhendong Mao and Mengqi Huang and Yuxin Wang and Yongdong Zhang},
62
+ year = {2026},
63
+ eprint = {2610.36545},
64
+ archivePrefix = {arXiv},
65
+ primaryClass = {cs.CV},
66
+ url = {https://arxiv.org/abs/2610.36545}
67
+ }
68
+ ```
69
+
70
+ ## License
71
+
72
+ This project is derived from HunyuanVideo 1.5 and retains its [Tencent Hunyuan Community License](https://github.com/Lyne1/FrameForge/blob/main/LICENSE) and [third-party notices](https://github.com/Lyne1/FrameForge/blob/main/NOTICE). Please review those terms before redistributing code or weights.