--- license: apache-2.0 language: - en pipeline_tag: any-to-any tags: - image-generation - interleaved-generation - multimodal-reasoning - visual-reasoning - vbvr-pro base_model: ThinkMorph/ThinkMorph-7B base_model_relation: finetune --- # VBVR-Pro: A Scalable and Verifiable Suite for Native Visual Reasoning Project Page Code Code arXiv Dataset Bench Data Leaderboard ## Overview Native visual reasoning, i.e., reasoning through visual generation, has recently emerged as a promising direction for studying visual intelligence beyond language. Yet progress remains bottlenecked by the lack of scalable training tasks, reliable feedback, and controlled comparisons across generative substrates. In this work, we introduce **VBVR-Pro**, a closed-loop testbed that makes native visual reasoning through generation trainable, verifiable, optimizable, and experimentally controllable. **1) Task scaling.** VBVR-Pro turns visual reasoning into a controlled task space of *300* procedurally generated tasks. Models trained on VBVR-Pro show strong transfer beyond the proposed suite across *six* held-out visual reasoning benchmarks such as RISE-Video, MME-CoF-Pro, and BabyVision. Further analysis validates that these gains reflect visual reasoning rather than instruction-pattern fitting. **2) Verifiable rewards.** VBVR-Pro provides verifiable reward scorers for task-grounded evaluation. Through a systematic study of leading MLLMs as judges, we identify recurring failure modes of the prevalent *VLM-as-a-judge* paradigm. In contrast, the proposed scorers are grounded on verifiable task-specific rules, achieve fine-grained alignment with human judgments. Importantly, they serve as reliable reward signals for large-scale multi-task reinforcement learning and demonstrate stronger post-RL performance across visual reasoning tasks. **3) Mechanism study.** VBVR-Pro enables controlled modality studies across more than *30* image, video, and interleaved generators. Our analysis shows that video generation remains strongest for tasks requiring persistent spatiotemporal state tracking, while interleaved generation provides a compute-efficient alternative by externalizing intermediate visual states. Critically, ablations and probing confirm the presence of vision-native trajectories, that are a more crucial substrate than explicit linguistic chains of thought for visual reasoning. We release all data, models, scorers, and code to facilitate future research. The models are presented in the paper [VBVR-Pro: A Scalable and Verifiable Suite for Native Visual Reasoning](https://huggingface.co/papers/2602.20159). ## Models Zoo
Model Base Architecture Other Remarks
Image Generation Models
VBVR-Pro-BAGELBAGEL-7B-MoTComplete model
VBVR-Pro-FLUX2-devFLUX.2-devComplete model, Diffusers format
VBVR-Pro-FLUX2-dev-diffsynthFLUX.2-devLoRA model, DiffSynth format
VBVR-Pro-Qwen-Image-EditQwen-Image-Edit-2511Complete model, Diffusers format
VBVR-Pro-Qwen-Image-Edit-diffsynthQwen-Image-Edit-2511LoRA model, DiffSynth format
Interleaved Image Generation Models
VBVR-Pro-ThinkMorphThinkMorph-7BComplete model
VBVR-Pro-SenseNova-U1SenseNova-U1-8B-MoTComplete model
Video Generation Models
VBVR-Pro-LTX2.3LTX-Video-2.3Complete model, Diffusers format
VBVR-Pro-LTX2.3-diffsynthLTX-Video-2.3LoRA model, DiffSynth format
VBVR-Pro-Wan2.1-I2V-14BWan2.1-I2V-14B-720PComplete model, Diffusers format
VBVR-Pro-Wan2.1-I2V-14B-diffsynthWan2.1-I2V-14B-720PLoRA model, DiffSynth format
VBVR-Pro-Wan2.2-I2V-A14BWan2.2-I2V-A14BComplete model, Diffusers format
VBVR-Pro-Wan2.2-I2V-A14B-diffsynthWan2.2-I2V-A14BLoRA model, DiffSynth format
VBVR-Pro-Wan2.2-TI2V-5BWan2.2-TI2V-5BComplete model, Diffusers format
VBVR-Pro-Wan2.2-TI2V-5B-diffsynthWan2.2-TI2V-5BLoRA model, DiffSynth format
## Release Information This repository contains a VBVR-Pro fine-tune of [ThinkMorph-7B](https://huggingface.co/ThinkMorph/ThinkMorph-7B). It takes an initial image and a text instruction, reasons with interleaved text and images, and can generate one or more sequential images before returning its final answer. The released weights are the EMA checkpoint from training step 25,000. The training checkpoint was stored in FP32; this Hugging Face export is converted to BF16, matching the precision of the original ThinkMorph-7B release. ### Repository contents | File | Purpose | | --- | --- | | `ema.safetensors` | Complete BF16 fine-tuned ThinkMorph model state | | `ae.safetensors` | Image autoencoder used for encoding and generation | | `llm_config.json` | Qwen2-MoT language-model configuration | | `vit_config.json` | SigLIP vision-encoder configuration | | `tokenizer.json`, `tokenizer_config.json`, `vocab.json`, `merges.txt` | Tokenizer assets | | `generation_config.json` | Default text-generation settings | | `config.json` | Checkpoint family identifier | This is a full checkpoint, not a LoRA or other adapter. No separate base-model download is needed after this repository has been downloaded. In this release, we present all models presented in paper [**VBVR-Pro-Trained-Models**](https://huggingface.co/collections/Video-Reason/VBVR-Pro), [**VBVR-Pro-Dataset-Video**](https://huggingface.co/datasets/Video-Reason/VBVR-Pro-SFT-Video), [**VBVR-Pro-Dataset-Image**](https://huggingface.co/datasets/Video-Reason/VBVR-Pro-SFT-Image), [**VBVR-Pro-Bench**](https://huggingface.co/datasets/Video-Reason/VBVR-Pro-Bench), [**VBVR-Pro-Code**](https://github.com/Video-Reason/VBVR-Pro) and [**VBVR-Bench-Leaderboard**](https://video-reason.com/pro/bench/#leaderboard). ## VBVR-Pro Benchmark Results
Models Overall In-Domain by Category Out-of-Domain by Category
Avg.Abst.Know.Perc.Spat.Trans. Avg.Abst.Know.Perc.Spat.Trans.
Image Generation Models
Proprietary Models
Qwen-Image-2.00.3130.2480.2690.1960.2250.1700.1320.3780.3410.2350.3910.3840.080
Seedream-5.0-Pro0.5570.4850.5180.3120.5090.4010.2170.6290.5070.4550.6610.5590.202
Open-source Models
BAGEL-7B-MoT0.0890.0660.0390.0850.0670.0460.0270.1110.2010.0310.0730.0280.121
FLUX.2-dev0.1570.1080.0880.1090.0720.1000.0660.2060.1970.1650.1840.2410.077
Qwen-Image-Edit0.1340.1080.0920.0820.1000.1090.0560.1590.1760.0630.1410.1820.082
Strong Baselines
VBVR-Pro-BAGEL0.1720.1680.1990.1050.1100.2130.0550.1760.2540.1040.1480.0150.145
VBVR-Pro-FLUX.20.4070.4840.4830.3230.3670.4490.3360.3300.3610.2720.2550.4540.128
VBVR-Pro-Qwen-Image0.3220.3320.2980.2170.1930.4310.2220.3110.3410.2390.2330.4130.181
Interleaved Image Generation Models
Proprietary Models
GPT-Image-20.5070.4280.4560.3180.4280.2060.3000.5870.3980.4130.6330.4800.303
Nano Banana Pro0.5640.4800.5180.4220.5120.2850.1740.6480.5530.4990.6570.5850.220
Open-source Models
ThinkMorph-7B0.1540.1130.1000.0820.1010.1480.0310.1950.1760.1660.1630.2530.103
VBVR-SenseNova-U10.4080.4690.3560.3130.3730.3860.4770.3470.2910.3170.2750.4800.238
SenseNova-U1-8B-MoT0.5650.5330.5010.3950.5440.3550.3490.5970.4480.4950.5330.7170.401
Strong Baselines
VBVR-Pro-ThinkMorph0.3730.4020.4030.3440.2380.4540.1840.3440.3670.2240.2380.5350.257
VBVR-Pro-SenseNova-U10.6380.8110.6480.6950.6210.7700.5410.4640.4800.3280.3440.5580.408
Video Generation Models
Proprietary Models
Veo 3.10.3090.3120.2750.2990.2520.2670.1570.3050.3050.2330.2520.3120.219
Kling V30.3920.3560.2130.3260.3200.3550.2290.4270.2940.5640.3750.2420.412
SeedDance 2.00.4990.4510.3380.3610.3530.4680.3080.5470.3690.5110.4780.5380.532
Open-source Models
HunyuanVideo-I2V0.0540.0540.0230.0640.0150.0840.0320.0530.0880.0140.0280.0620.055
CogVideoX1.5-5B-I2V0.0850.1000.0610.1180.0690.0920.0600.0700.1250.0380.0510.0400.024
Wan2.1-I2V-14B0.1000.1050.0520.1250.0910.1020.0520.0950.1120.0730.0710.1230.044
Wan2.2-TI2V-5B0.0940.0660.0290.0730.0500.0830.0310.1220.1560.0520.1060.0630.099
Wan2.2-I2V-14B-720P0.1820.1570.0820.1310.1100.1610.1560.2070.2240.1390.1400.1950.273
LTX2.3-I2AV0.1120.1060.0620.1090.0700.1330.0550.1190.1610.1350.0860.0910.050
VBVR-Wan2.20.5170.5480.2370.4990.3340.5660.5910.4860.3100.3430.3450.7320.684
Strong Baselines
VBVR-Pro-LTX2.30.4250.5270.4090.5100.3460.4600.3900.3240.3810.1080.2010.4770.386
VBVR-Pro-Wan2.1-I2V-14B0.5620.7300.6170.5800.4520.6760.6230.3950.4100.3050.2300.6170.439
VBVR-Pro-Wan2.2-TI2V-5B0.4700.6410.5280.5560.3730.5650.5570.3000.3330.1270.1610.5050.409
VBVR-Pro-Wan2.2-I2V-14B0.6700.8080.6320.6850.5560.7510.6360.5320.4790.4180.3500.6790.690
## Quick Start ### Method 1: Standalone ThinkMorph inference #### Requirements - Linux and a CUDA-capable GPU - Python 3.10 - The [ThinkMorph](https://github.com/ThinkMorph/ThinkMorph) inference code and its dependencies For straightforward inference, an 80 GB-class GPU is recommended. The ThinkMorph loader can also distribute the model across multiple visible GPUs. ```bash git clone https://github.com/ThinkMorph/ThinkMorph.git cd ThinkMorph conda create -n thinkmorph python=3.10 -y conda activate thinkmorph pip install -r requirements.txt ``` #### Download ```python from huggingface_hub import snapshot_download snapshot_download( repo_id="Video-Reason/VBVR-Pro-ThinkMorph", local_dir="models/VBVR-Pro-ThinkMorph", allow_patterns=["*.json", "*.safetensors", "*.txt", "*.md"], ) ``` #### Inference Run the following from the ThinkMorph repository. The same downloaded directory is passed as both `model_path` and `config_path` because this release is self-contained. ```python import random import numpy as np import torch from PIL import Image from inferencer import InterleaveInferencer from scripts.cza.inference import load_model model_path = "models/VBVR-Pro-ThinkMorph" random.seed(42) np.random.seed(42) torch.manual_seed(42) torch.cuda.manual_seed_all(42) model, vae, tokenizer, token_ids, vae_transform, vit_transform = load_model( model_path, model_path, ) inferencer = InterleaveInferencer( model, vae, tokenizer, vae_transform, vit_transform, token_ids ) system_prompt = ( "Let's think step by step to answer the question. For text-based thinking, " "enclose the process within . For visual thinking, enclose " "the content within . Finally conclude with the " "final answer wrapped in " ) input_image = Image.open("first_frame.png").convert("RGB") output = inferencer( image=input_image, text="Move the object to the requested destination while preserving the scene.", understanding_output=False, think=True, system_prompt=system_prompt, max_think_token_n=4096, do_sample=True, text_temperature=0.3, cfg_text_scale=4.0, cfg_img_scale=2.0, cfg_interval=[0.0, 1.0], timestep_shift=3.0, num_timesteps=50, cfg_renorm_min=0.0, cfg_renorm_type="text_channel", max_rounds=10, ) for index, item in enumerate(output): if isinstance(item, Image.Image): item.save(f"generated_{index}.png") else: print(item, end="") ``` The settings above reproduce the first-attempt settings used by the existing VBVR-Pro evaluator: | Setting | Value | | --- | --- | | Seed | 42 | | Maximum thinking tokens | 4096 | | Text temperature | 0.3 | | Text CFG scale | 4.0 | | Image CFG scale | 2.0 | | Denoising steps | 50 | | Timestep shift | 3.0 | | Maximum interleaved rounds | 10 | ### Method 2: Unified VBVR-Pro inference Clone [Video-Reason/VBVR-Pro](https://github.com/Video-Reason/VBVR-Pro) and create its unified inference environment: ```bash git clone https://github.com/Video-Reason/VBVR-Pro.git cd VBVR-Pro/ uv sync --extra cu124 # or one of [cu118|cu121|cu124|cu126|cu128|cu129] source .venv/bin/activate ``` Then run the unified inference script: ```bash python example.py \ --model_path Video-Reason/VBVR-Pro-ThinkMorph \ --image_paths first_frame.png \ --prompt "Solve the task step by step." \ --think --max_rounds 10 --num_images 2 \ --output outputs ``` ## Notes - The model uses the custom ThinkMorph/BAGEL architecture and is not directly loadable with `transformers.AutoModel` or a Diffusers pipeline. - Inputs should follow the same image-plus-instruction format used by ThinkMorph. Generated images appear as `PIL.Image.Image` objects interleaved with text strings. - More generated images, larger resolutions, and longer reasoning traces increase runtime and memory use. - This checkpoint may inherit limitations and biases from its base model and fine-tuning data. Validate outputs for your application and use generated content responsibly. ## Citation ```bibtex @misc{gu2025thinkmorphemergentpropertiesmultimodal, title={ThinkMorph: Emergent Properties in Multimodal Interleaved Chain-of-Thought Reasoning}, author={Jiawei Gu and Yunzhuo Hao and Huichen Will Wang and Linjie Li and Michael Qizhe Shieh and Yejin Choi and Ranjay Krishna and Yu Cheng}, year={2025}, eprint={2510.27492}, archivePrefix={arXiv}, primaryClass={cs.CV}, url={https://arxiv.org/abs/2510.27492}, } ``` ## License This release follows the Apache 2.0 license declared by ThinkMorph-7B. See the base model repository for additional context.