Improve model card: add metadata, paper link, and usage instructions
Browse filesHi! I'm Niels from the Hugging Face community science team. I noticed this repository could benefit from a more detailed model card.
This PR:
- Adds the `image-to-image` pipeline tag to improve discoverability.
- Adds metadata for the license (`cc-by-nc-4.0`) based on the non-commercial disclaimer in the GitHub README.
- Links the repository to the [associated paper](https://huggingface.co/papers/2606.20506) and project page.
- Includes a sample usage section with a code snippet for inference as found in the official GitHub repository.
README.md
CHANGED
|
@@ -5,13 +5,21 @@ tags:
|
|
| 5 |
- image-editing
|
| 6 |
- cref
|
| 7 |
- sref
|
|
|
|
|
|
|
| 8 |
---
|
| 9 |
|
| 10 |
-
# FreeStyle
|
| 11 |
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 13 |
|
| 14 |
-
|
| 15 |
|
| 16 |
| Folder | What it is | Inference note |
|
| 17 |
| --- | --- | --- |
|
|
@@ -21,4 +29,36 @@ This repository contains LoRA checkpoints for FreeStyle CRef/SRef image editing.
|
|
| 21 |
|
| 22 |
Each folder contains a `model.safetensors` LoRA weight file.
|
| 23 |
|
| 24 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 5 |
- image-editing
|
| 6 |
- cref
|
| 7 |
- sref
|
| 8 |
+
pipeline_tag: image-to-image
|
| 9 |
+
license: cc-by-nc-4.0
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# FreeStyle: Free Control of Style-Content Dual-Reference Generation from Community LoRA Mining
|
| 13 |
|
| 14 |
+
FreeStyle is a scalable dual-reference generation framework that allows for synthesizing images by combining the structure and semantics of a content reference with the style of a separate reference image. It leverages community LoRA weights as compositional anchors and introduces mechanisms like attention-level enrichment constraints and frequency-aware RoPE modulation to prevent content leakage from style references.
|
| 15 |
+
|
| 16 |
+
- **Paper:** [FreeStyle: Free Control of Style-Content Dual-Reference Generation from Community LoRA Mining](https://huggingface.co/papers/2606.20506)
|
| 17 |
+
- **Project Page:** [https://blue2giant.github.io/FreeStyle/](https://blue2giant.github.io/FreeStyle/)
|
| 18 |
+
- **GitHub Repository:** [https://github.com/Blue2Giant/FreeStyle](https://github.com/Blue2Giant/FreeStyle)
|
| 19 |
+
|
| 20 |
+
## FreeStyle Checkpoints
|
| 21 |
|
| 22 |
+
This repository contains LoRA checkpoints for FreeStyle CRef/SRef image editing.
|
| 23 |
|
| 24 |
| Folder | What it is | Inference note |
|
| 25 |
| --- | --- | --- |
|
|
|
|
| 29 |
|
| 30 |
Each folder contains a `model.safetensors` LoRA weight file.
|
| 31 |
|
| 32 |
+
## Sample Usage
|
| 33 |
+
|
| 34 |
+
To generate an image using the FreeStyle model, you can use the inference script provided in the [official GitHub repository](https://github.com/Blue2Giant/FreeStyle).
|
| 35 |
+
|
| 36 |
+
```bash
|
| 37 |
+
cd model_infer
|
| 38 |
+
# Follow environment setup instructions in the GitHub repository
|
| 39 |
+
conda activate Sref
|
| 40 |
+
|
| 41 |
+
python3 cref_sref_core_infer.py \
|
| 42 |
+
assets/00-cref.jpg \
|
| 43 |
+
assets/00-sref.jpg \
|
| 44 |
+
'Transfer the style of image 2 onto image 1, keeping image 1\'s layout.' \
|
| 45 |
+
--weight_preset sref_14000 \
|
| 46 |
+
--recaption_task_type style_transfer \
|
| 47 |
+
--out_dir outputs/demo \
|
| 48 |
+
--steps 28 --cfg 8 --seed 42 --overwrite
|
| 49 |
+
```
|
| 50 |
+
|
| 51 |
+
## Citation
|
| 52 |
+
|
| 53 |
+
```bibtex
|
| 54 |
+
@article{lan2026freestyle,
|
| 55 |
+
title = {FreeStyle: Free Control of Style-Content Dual-Reference Generation from Community LoRA Mining},
|
| 56 |
+
author = {Lan, Jinghong and Cheng, Wei and Chen, Yunuo and Ye, Ziqi and Xing, Peng and Fang, Yixiao and Wang, Rui and Yang, Yufeng and Zhang, Xuanyang and Zou, Difan and Zeng, Xianfang and Yu, Gang and Zhang, Chi},
|
| 57 |
+
journal = {arXiv preprint arXiv:2606.20506},
|
| 58 |
+
year = {2026}
|
| 59 |
+
}
|
| 60 |
+
```
|
| 61 |
+
|
| 62 |
+
## Disclaimer
|
| 63 |
+
|
| 64 |
+
This project is released **strictly for academic research and non-commercial use only**. Users are responsible for ensuring that their use of this project complies with all applicable laws and third-party terms of service.
|