vLAR commited on
Commit
adaa8dc
Β·
verified Β·
1 Parent(s): bd52e3e

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +81 -1
README.md CHANGED
@@ -1,3 +1,83 @@
1
  ---
2
- license: cc-by-4.0
 
 
 
 
 
 
 
 
 
 
3
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ license: cc-by-nc-sa-4.0
3
+ language:
4
+ - en
5
+ tags:
6
+ - relighting
7
+ - multi-view
8
+ - generative-transformer
9
+ - 3d-vision
10
+ - siggraph-asia-2026
11
+ - wan2.1
12
+ pipeline_tag: image-to-image
13
  ---
14
+
15
+ # RelightFormer: Feed-Forward Generative Transformer for Multi-View Object Relighting
16
+
17
+ <p align="center">
18
+ <strong>SIGGRAPH Asia 2026</strong> |
19
+ <a href="https://github.com/vLAR-group/RelightFormer">🌐 GitHub Repository</a> |
20
+ <a href="https://huggingface.co/datasets/vLAR/LavalObjaverseDataset">πŸ€— Dataset</a>
21
+ </p>
22
+
23
+ ## 🌟 Overview
24
+
25
+ **RelightFormer** revolutionizes image relighting by replacing traditional, computationally expensive inverse rendering with a feed-forward generative Transformer. By seamlessly injecting target lighting into spatial features and processing multiple views symmetrically, it delivers highly photorealistic results. Trained on the newly introduced, large-scale open-source **Laval-Objaverse Dataset (LOD)**, RelightFormer achieves state-of-the-art quality and remarkable generalization across diverse scenes.
26
+
27
+ ### ✨ Key Features
28
+ - 🏹 **Feed-Forward Architecture**: No iterative optimization required, enabling rapid generation.
29
+ - 🌟 **Multi-View Consistency**: Coherent and physically plausible relighting across all viewpoints.
30
+ - ⚑ **Performant Inference**: Highly optimized and expeditious execution on modern GPUs.
31
+ - 🎨 **Competitive Quality**: State-of-the-art, photorealistic relighting results.
32
+
33
+ ---
34
+
35
+ ## πŸš€ Quick Start
36
+
37
+ You can easily load and run the model using the `diffsynth` library in our [GitHub Repository](https://github.com/vLAR-group/RelightFormer).
38
+ We provide two revisions: `main` (RelightFormer) and `post` (RelightFormer-Post, fine-tuned for enhanced quality).
39
+
40
+ ```python
41
+ from diffsynth import RelightFormerPipeline
42
+
43
+ # Use revision='main' for RelightFormer, or 'post' for RelightFormer-Post
44
+ pipe = RelightFormerPipeline.from_pretrained(
45
+ "vLAR/RelightFormer",
46
+ revision="main"
47
+ )
48
+
49
+ # Example inference (adjust inputs according to your specific pipeline API)
50
+ # output = pipe(image=..., lighting=..., ...)
51
+ ```
52
+
53
+ > πŸ’‘ **For full inference scripts, multi-GPU evaluation, and training code, please visit the [Official GitHub Repository](https://github.com/vLAR-group/RelightFormer).**
54
+
55
+ ---
56
+
57
+ ## πŸ“¦ Dataset
58
+
59
+ This model is trained on the **Laval-Objaverse Dataset (LOD)**, comprising **90,545 high-quality 3D assets** and **39,008 diverse illumination conditions**.
60
+ - πŸ€— **Browse/Download the Dataset**: [vLAR/LavalObjaverseDataset](https://huggingface.co/datasets/vLAR/LavalObjaverseDataset)
61
+ - πŸ“– **Rendering Instructions**: See the [`RENDERING_INSTRUCTION.md`](https://github.com/vLAR-group/RelightFormer/blob/main/laval-objaverse-dataset/RENDERING_INSTRUCTION.md) in the GitHub repo.
62
+
63
+ ---
64
+
65
+ ## πŸ‹οΈ Training Details
66
+
67
+ RelightFormer is fine-tuned from the **Wan 2.1** base model. The training pipeline consists of two stages:
68
+ 1. **Main Training**: Trained on the full LOD dataset to learn multi-view relighting priors.
69
+ 2. **Post-Training**: A secondary fine-tuning stage to further enhance photorealism and consistency.
70
+
71
+ Detailed training configurations, hardware requirements (e.g., 4Γ— H200 GPUs), and scripts are available in the [GitHub Repository](https://github.com/vLAR-group/RelightFormer).
72
+
73
+ ---
74
+
75
+ ## πŸ“œ License
76
+
77
+ This model, its code, and associated datasets are licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-nc-sa/4.0/) (CC BY-NC-SA 4.0).
78
+
79
+ ---
80
+
81
+ ## πŸ™ Acknowledgements
82
+
83
+ This work was supported in part by the National Natural Science Foundation of China, the Research Grants Council of Hong Kong, the Otto Poon Charitable Foundation Smart Cities Research Institute, the Research Center for Unmanned Autonomous Systems, and the PolyU Kunpeng & Ascend Technology Innovation Incubation Center, The Hong Kong Polytechnic University.