KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

Scone

★ 32 Open GitHub ↗

(CVPR 2026 Highlight) Official repository for Scone (Subject-driven COmposition and DistinctioN Enhancement) model, supporting subject composition and distinction in complex contexts.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="assets/logo.png" alt="Scone" width="400"/>

<h3 align="center">
 [✨CVPR 2026 Highlight] Scone: Bridging Composition and Distinction in Subject-Driven Image Generation via Unified Understanding-Generation Modeling
</h3>

>
> 
> Yuran Wang1,2* Bohan Zeng1,2*	Chengzhuo Tong1,2	Wenxuan Liu1	Yang Shi1,2 Xiaochen Ma1	Hao Liang1	Yuanxing Zhang2	Wentao Zhang1†
> 
> 
> 1Peking University		2Kling Team, Kuaishou Technology
> 
> * Equal contribution, † Corresponding author
>

# 📢 News

- 2026.4.9: 🎉🎉 Our paper has been selected as a ✨**Highlight** at **CVPR 2026**.
- 2025.12.16: The [paper](https://arxiv.org/abs/2512.12675), [training code](https://github.com/Ryann-Ran/Scone?tab=readme-ov-file#-train), [inference and evaluation code](https://github.com/Ryann-Ran/Scone?tab=readme-ov-file#-inference-and-evaluation), [model weight](https://huggingface.co/Ryann829/Scone), [training data](https://huggingface.co/datasets/Ryann829/Scone-S2I-57K), [SconeEval benchmark](https://huggingface.co/datasets/Ryann829/SconeEval) are now released.

# 📖 Introduction

Subject-driven image generation has recently gained significant attention, with the focus evolving from single-subject to multi-subject generation, incorporating more input images. Existing methods can process two or more input images and combine subjects based on instructions, showcasing potential for more complex composition tasks.

However, existing works primarily focus on expanding subject combinations while neglecting the ability to distinguish target subjects in complex contexts. As shown in Figure 1.(a), although current models can combine multiple subjects, they may fail to identify and generate the correct target subject when a reference image contains multiple candidates, leading to problems such as subject omissions (none of the candidate subjects appear) or errors (misidentification of the target subject).
Real-world images often involve interference and intricate details, which further limit practical performance.
Thus, we emphasize examining the input subjects themselves, focusing on the model’s ability to ***distinguish the target subject within complex contexts and leverage this information for generation***.

<figure style="text-align: center; border: none; margin: auto;">
 <img src="assets/problem.png" width="512" alt="The distinction problem and challenges."/>
 <figcaption>Figure 1. The distinction problem and challenges.</figcaption>
</figure>

* We propose the **Scone** (**S**ubject-driven **co**mposition and distinctio**n** **e**nhancement) model, which supports multi-subject composition and excels in subject distinction in complex contexts. Experiments show our Scone ranks first among open-source models on OmniContext benchmark.
*  We introduce the **understanding bridge strategy**, which transforms the understanding expert into a semantic bridge, enabling early multimodal alignment and attention-based semantic filtering to guide the generation expert, enhancing subject distinction and semantic fidelity without adding extra parameters.
* We develop **SconeEval**, a challenging benchmark with three difficulty levels, to evaluate performance on subject-driven image generation tasks from both composition and distinction perspectives.

# 🔧 Environment setup

```bash
git clone https://github.com/Ryann-Ran/Scone.git
cd Scone
conda create -n scone python=3.10 -y
conda activate scone
pip install -r requirements.txt
pip install flash_attn==2.5.8 --no-build-isolation
```

# 🔥 Train

## Data and base model preparation

1. Download our **22K refined single-candidate data** and **35K multi-candidate data** from [Scone-S2I-57K](https://huggingface.co/datasets/Ryann829/Scone-S2I-57K). The 70K base single-candidate data are sampled from open-source datasets like [X2I](https://huggingface.co/datasets/yzwang/X2I-subject-driven), [MUSAR-Gen](https://huggingface.co/datasets/guozinan/MUSAR-Gen), [UNO-1M](https://huggingface.co/datasets/bytedance-research/UNO-1M), and [Echo-4o-Image](https://huggingface.co/datasets/Yejy53/Echo-4o-Image). Please refer to the dataset links for more details.

```bash
   cd Scone
   # pip install -U huggingface_hub
   hf download Ryann829/Scone-S2I-57K --repo-type=dataset --local-dir ./datasets/Scone-S2I-57K
   ```

2. Organize the data hierarchy as follows:

```
Scone-S2I-57K
	├── parquet_data
    │   ├── scone_single_candidate_base/
    │   ├── scone_single_candidate_refined/
    │   └── scone_multi_candidate/
    └── parquet_info
    	├── scone_single_candidate_base.json
        ├── scone_single_candidate_refined.json
        └── scone_multi_candidate.json
```

3. Replace each `your_data_path` placeholder with your **actual absolute path** in:

* Parquet information files: `./datasets/Scone-S2I-57K/parquet_info/*.json`

* Dataset information file: `./data/dataset_info.py`

4. Download the checkpoint of our base model [BAGEL](https://github.com/ByteDance-Seed/Bagel) from [HuggingFace](https://huggingface.co/ByteDance-Seed/BAGEL-7B-MoT):

```bash
cd Scone
# pip install -U huggingface_hub
hf download ByteDance-Seed/BAGEL-7B-MoT  --local-dir ./ckpts/BAGEL-7B-MoT
```

> - **Note**: To avoid out-of-memory (OOM) issues, we disable the EMA update strategy originally used in BAGEL. All our training processes are conducted on 8 Nvidia A800 GPUs.
> - The usage of semantic mask in the understanding bridge strategy is controlled by the training argument `--use_semantic_mask`.

## Stage I: Composition training

For Step 1, please use base single-candidate data for 1 epoch (~30 hours):

```bash
bash scripts/train_stage1_step1.sh  # 🔥 Und., Gen.
```

For Step 2, please use refined single-candidate data for 1 epoch (~15 hours) and replace `model_path` in the script with your Step 1 checkpoint :

```bash
bash scripts/train_stage1_step2.sh  # 🔥 Und., Gen.
```

## Stage II: Distinction training with understanding bridge strategy
For Step 1, please use refined sinlgle-candidate data and multi-candidate data for 1k steps (~5 hours) and replace `model_path`  in the script with your Stage 1 Step 2 checkpoint:

```bash
bash scripts/train_stage2_step1.sh  # 🔥 Und. ❄️ Gen.
```

For Step 2, please use refined sinlgle-candidate data and multi-candidate data for 1k steps (~5 hours) and replace `model_path`  in the script with your Stage 2 Step 1 checkpoint:

```bash
bash scripts/train_stage2_step2.sh  # 🔥 Und., Gen.
```

# 🔍 Inference and Evaluation

## Scone model preparation

Download the Scone model checkpoint from [HuggingFace](https://huggingface.co/Ryann829/Scone):

```bash
# pip install -U huggingface_hub
hf download Ryann829/Scone  --local-dir ./ckpts/Scone
```

## Single case inference

Run the inference script:

```bash
bash scripts/inference_single_case.sh
```

**Example Output:** (Images sampled at 1024x1024 resolution with seed 1234, except for GPT-4o and Gemini-2.5-Flash-Image APIs)

<table>
 <tr>
 <th style="width: 150px; text-align: center;">Ref. 1</th>
 <th style="width: 150px; text-align: center;">Ref. 2</th>
 <th style="width: 200px; text-align: center;">Instruction</th>
 <th style="width: 150px; text-align: center;">Scone (Ours)</th>
 <th style="width: 150px; text-align: center;">GPT-4o</th>
 <th style="width: 150px; text-align: center;">Gemini-2.5-Flash-Image</th>
 <th style="width: 150px; text-align: center;">UNO</th>
 <th style="width: 150px; text-align: center;">Qwen-Image-Edit-2509</th>
 <th style="width: 150px; text-align: center;">BAGEL</th>
 <th style="width: 150px; text-align: center;">OmniGen2</th>
 <th style="width: 150px; text-align: center;">Echo-4o</th>
 </tr>
 <tr>
 <td style="width: 150px; text-align: center;"><img src="./example_images/image_object.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_images/image_character.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 200px; text-align: center;">The man from image 2 holds the object which has a blue-and-red top in image 1 in a coffee shop.</td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/Scone.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/GPT-4o.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/Gemini-2.5-Flash-Image.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/UNO.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/Qwen-Image-Edit-2509.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/BAGEL.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/OmniGen2.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 <td style="width: 150px; text-align: center;"><img src="./example_results/Echo-4o.png" style="width: 150px; height: auto; display: block; margin: 0 auto;" /></td>
 </tr>
</table>

## OmniContext benchmark

### Inference

We support inference and evaluation on both the OmniContext and our SconeEval benchmarks, building upon the [OmniContext](https://github.com/VectorSpaceLab/OmniGen2) repository.

We provide the jsonl version of [OmniContext data](https://huggingface.co/datasets/OmniGen2/OmniContext) in <a href="https://huggingface.co/datasets/Ryann829/OmniContext-jsonl"><img src="https://img.shields.io/static/v1?label=%F0%9F%A4%97%20Hugging%20Face&message=OmniContext-jsonl&color=yellow"></a>.

Download the data:

```bash
# pip install -U huggingface_hub
hf download Ryann829/OmniContext-jsonl --repo-type=dataset --local-dir ../OmniContext-jsonl
```

Run the inference script:

```bash
bash scripts/inference_omnicontext.sh
```

### Evaluation

Use GPT-4.1 to evaluate the quality of the generated images and calculate the final score. Please ensure your API key is configured before running the script.

```bash
bash eval/s2i/omnicontext/eval.sh
```

## ✨ SconeEval benchmark

To evaluate a model’s ability to distinguish and generate the referred subject in complex visual contexts, we introduce a new benchmark, **SconeEval**. It contains 409 test cases across character, object, and scene combinations and subject distinction, with 19 case types in Figure 2(a) and 6 subtasks in Figure 2(b), providing a comprehensive evaluation of a model’s ability to distinguish and utilize subject features.

Unlike traditional benchmarks that emphasize visual fidelity or text alignment, SconeEval focuses on cross-modal reasoning from complex contexts involving reference images and instructions, which requires deciding *whom* to generate when multiple candidates appear within or across images.

SconeEval includes three progressively challenging tasks, as shown in Figure 2(c): composition, distinction, and distinction & composition. In the composition task, each reference image contains a subject, and one or more images correspond to single or multiple generated subjects. In the distinction task, each reference image contains multiple subjects, and the model generates one target subject. The distinction & composition task integrates both settings, where each reference image contains multiple subjects and multiple images are used for multi-subject generation. Tasks involving distinction include cross-category and intra-category cases, indicating whether candidate subjects in a reference image belong to the same category.

<figure style="text-align: center; border: none; margin: auto;">
	<img src="assets/sconeeval.png" width="1024" alt="Overview of our SconeEval benchmark."/>
 <figcaption>Figure 2. Overview of our SconeEval benchmark.</figcaption>
</figure>

### 📊 LeaderBoard

<table border="1" style="border-collapse: collapse; width: 100%;">
 <thead>
 <tr>
 <th rowspan="3">Method</th>
 <th colspan="2">Composition ↑</th>
 <th colspan="4">Distinction ↑</th>
 <th colspan="4">Distinction & Composition ↑</th>
 <th colspan="3">Average ↑</th>
 </tr>
 <tr>
 <th>Single</th>
 <th>Multi</th>
 <th colspan="2">Cross</th>
 <th colspan="2">Intra</th>
 <th colspan="2">Cross</th>
 <th colspan="2">Intra</th>
 <th rowspan="2">COM</th>
 <th rowspan="2">DIS</th>
 <th rowspan="2">Overall</th>
 </tr>
 <tr>
 <th>COM</th>
 <th>COM</th>
 <th>COM</th>
 <th>DIS</th>
 <th>COM</th>
 <th>DIS</th>
 <th>COM</th>
 <th>DIS</th>
 <th>COM</th>
 <th>DIS</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td colspan="14" style="background-color: #ffefe6; text-align: center; font-weight: bold; font-style: italic;">Closed-Source Model</td>
 </tr>
 <tr>
 <td>Gemini-2.5-Flash-Image</td>
 <td>8.87</td>
 <td>7.94</td>
 <td>9.12</td>
 <td>9.15</td>
 <td>9.00</td>
 <td>8.50</td>
 <td>8.27</td>
 <td>8.87</td>
 <td>8.17</td>
 <td>8.85</td>
 <td>8.56</td>
 <td>8.84</td>
 <td>8.70</td>
 </tr>
 <tr>
 <td>GPT-4o*</td>
 <td>8.92</td>
 <td>8.51</td>
 <td>9.18</td>
 <td>8.55</td>
 <td>9.45</td>
 <td>9.01</td>
 <td>8.83</td>
 <td>8.49</td>
 <td>8.99</td>
 <td>9.56</td>
 <td>8.98</td>
 <td>8.90</td>
 <td>8.94</td>
 </tr>
 <tr>
 <td colspan="14" style="background-color: #e0eef9; text-align: center; font-weight: bold; font-style: italic;">Generation Model</td>
 </tr>
 <tr>
 <td>FLUX.1 Kontext [dev]</td>
 <td>7.92</td>
 <td>-</td>
 <td>7.93</td>
 <td>8.45</td>
 <td>6.20</td>
 <td>6.11</td>
 <td>-</td>
 <td>-</td>
 <td>-</td>
 <td>-</td>
 <td>-</td>
 <td>-</td>
 <td>-</td>
 </tr>
 <tr>
 <td>USO</td>
 <td>8.03</td>
 <td>5.19</td>
 <td>7.96</td>
 <td>8.50</td>
 <td>7.14</td>
 <td>6.51</td>
 <td>5.10</td>
 <td>6.25</td>
 <td>5.07</td>
 <td>5.57</td>
 <td>6.41</td>
 <td>6.71</td>
 <td>6.56</td>
 </tr>
 <tr>
 <td>UNO</td>
 <td>7.53</td>
 <td>5.38</td>
 <td>7.27</td>
 <td>7.90</td>
 <td>6.76</td>
 <td>6.53</td>
 <td>5.27</td>
 <td>7.02</td>
 <td>5.61</td>
 <td>6.27</td>
 <td>6.31</td>
 <td>6.93</td>
 <td>6.62</td>
 </tr>
 <tr>
 <td>UniWorld-V2 (Edit-R1-Qwen-Image-Edit-2509)</td>
 <td>8.41</td>
 <td>7.16</td>
 <td>8.63</td>
 <td>8.24</td>
 <td>7.44</td>
 <td>6.77</td>
 <td>7.52</td>
 <td>8.03</td>
 <td>7.70</td>
 <td>7.24</td>
 <td>7.81</td>
 <td>7.57</td>
 <td>7.69</td>
 </tr>
 <tr>
 <td>Qwen-Image-Edit-2509</td>
 <td>8.54</td>
 <td>6.85</td>
 <td>8.85</td>
 <td>8.57</td>
 <td>7.32</td>
 <td>6.86</td>
 <td>7.53</td>
 <td>8.13</td>
 <td>7.49</td>
 <td>7.02</td>
 <td>7.76</td>
 <td>7.65</td>
 <td>7.70</td>
 </tr>
 <tr>
 <td colspan="14" style="background-color: #E6E6FA; text-align: center; font-weight: bold; font-style: italic;">Unified Model</td>
 </tr>
 <tr>
 <td>BAGEL</td>
 <td>7.14</td>
 <td>5.55</td>
 <td>7.49</td>
 <td>7.95</td>
 <td>6.93</td>
 <td>6.21</td>
 <td>6.44</td>
 <td>7.38</td>
 <td>6.87</td>
 <td>7.27</td>
 <td>6.74</td>
 <td>7.20</td>
 <td>6.97</td>
 </tr>
 <tr>
 <td>OmniGen2</td>
 <td>8.00</td>
 <td>6.59</td>
 <td>8.31</td>
 <td>8.99</td>
 <td>6.99</td>
 <td>6.80</td>
 <td>7.28</td>
 <td>8.30</td>
 <td>7.14</td>
 <td>7.13</td>
 <td>7.39</td>
 <td>7.81</td>
 <td>7.60</td>
 </tr>
 <tr>
 <td>Echo-4o</td>
 <td>8.58</td>
 <td>7.73</td>
 <td>8.36</td>
 <td>8.33</td>
 <td>7.74</td>
 <td>7.18</td>
 <td>7.87</td>
 <td>8.72</td>
 <td>8.01</td>
 <td>8.33</td>
 <td>8.05</td>
 <td>8.14</td>
 <td>8.09</td>
 </tr>
 <tr>
 <td>Scone (Ours)</td>
 <td>8.52</td>
 <td>7.40</td>
 <td>8.98</td>
 <td>9.73</td>
 <td>7.97</td>
 <td>7.74</td>
 <td>8.20</td>
 <td>9.25</td>
 <td>8.21</td>
 <td>8.44</td>
 <td>8.21</td>
 <td>8.79</td>
 <td>8.50</td>
 </tr>
 </tbody>
</table>

> - *: GPT-4o responded to 365~370 test cases out of the total 409 cases due to OpenAI safety restrictions.
> - To mitigate randomness, we perform 3 rounds of sampling at 1024x1024 resolution, scoring 3 times per round, yielding 9 group results. The final score is the average of these results.

### Inference

Download the data:

```bash
# pip install -U huggingface_hub
hf download Ryann829/SconeEval --repo-type=dataset --local-dir ../SconeEval
```

Run the script:

```bash
bash scripts/inference_sconeeval.sh
```

### Evaluation

Use GPT-4.1 to evaluate the quality of the generated images and calculate the final score. Please ensure your API key is configured before running the script.

```bash
bash eval/s2i/sconeeval/eval.sh
```

# 🚀 Updates

- [x] Release paper
- [x] Release training code
- [x] Release inference and evaluation code
- [x] Release model weight
- [x] Release training data
- [x] Release SconeEval benchmark

# 🚰 Citation
If you find Scone helpful, please consider giving the repo a star ⭐.

If you find this project useful for your research, please consider citing our paper:
```bibtex
@article{wang2025scone,
  title={Scone: Bridging Composition and Distinction in Subject-Driven Image Generation via Unified Understanding-Generation Modeling},
  author={Wang, Yuran and Zeng, Bohan and Tong, Chengzhuo and Liu, Wenxuan and Shi, Yang and Ma, Xiaochen and Liang, Hao and Zhang, Yuanxing and Zhang, Wentao},
  journal={arXiv preprint arXiv:2512.12675},
  year={2025}
}
```

# 💪 Acknowledgements

This project builds upon the following repositories:

* [BAGEL](https://github.com/ByteDance-Seed/Bagel)
* [OmniContext](https://github.com/VectorSpaceLab/OmniGen2)

Special thanks to these original projects and open-source datasets for their valuable contributions.

Scone

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README