Instructions to use tz2026/ReWorld with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use tz2026/ReWorld with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("tz2026/ReWorld", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
import torch
from diffusers import DiffusionPipeline
# switch to "mps" for apple devices
pipe = DiffusionPipeline.from_pretrained("tz2026/ReWorld", dtype=torch.bfloat16, device_map="cuda")
prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k"
image = pipe(prompt).images[0]ReWorld: Representation Learning for World Action Models
The first representation learning framework for autonomous-driving World Action Models
Tianze Xia1,2*, Lijun Zhou2*, Kaixin Xiong2, Jingfeng Yao1, Zhenxin Zhu2, Haiyang Sun2, Bing Wang2, Guang Chen2, Wenyu Liu1, Hangjun Ye2, Xinggang Wang1β
1 Huazhong University of Science and Technology 2 Xiaomi EV
* Equal contribution β Corresponding author
Highlights
- Better futures β FVD 81.3 β 61.9 (β23.9%) on nuScenes video generation, with self-guided sampling enabled for free by intermediate supervision.
- Safer plans β closed-loop PDMS 89.1 β 90.4 on NAVSIM Navtest, with best-in-class NC / DAC / TTC among world-model planners β no RL, no test-time scoring.
- Stronger representations β frozen linear probe on UCF-101 action recognition 68.3% β 80.2% (+11.9 pts over the DriveLaW baseline).
- Nearly free β no external encoders, no teacher models, only +0.3% per-step Video DiT training cost, and roughly 2Γ faster convergence from scratch.
Why ReWorld?
World Action Models (WAMs) couple future environment prediction with action generation, yet standard training supervises only the output ends of the generation and planning modules. The intermediate representations that carry world knowledge are shaped only indirectly, as byproducts of fitting these outputs. We call this the representation bottleneck of WAMs: the world-to-action pathway is not explicitly optimized to be future-predictive, cross-modally grounded, or sensitive to closed-loop behavior quality.
ReWorld removes this bottleneck by treating intermediate representations as direct targets of optimization, through three complementary stages:
- Stage 1 Β· Future-predictive world representation β impose future-flow supervision on intermediate Video DiT states. The resulting cross-layer prediction hierarchy enables self-guided sampling at inference and yields roughly 2Γ faster convergence from scratch.
- Stage 2 Β· World-grounded action representation β with the Video DiT frozen, align post-cross-attention Action DiT states with their attended video readouts, so that retrieved world information is retained in the representations used for planning.
- Stage 3 Β· Behavior-aware action shaping β jointly fine-tune both branches with hard-negative repulsion: predictions are pushed away from geometrically close yet low-scoring trajectories, separating the expert from nearby unsafe alternatives.
All supervision is constructed entirely from the WAM's own generation targets, attended features, and trajectory candidates β requiring no external encoders or teacher models and adding only 0.3% per-step Video DiT training cost.
Why sequential? The three stages play distinct optimization roles: Stage 1 first establishes future-predictive structure in the video representation; Stage 2 then grounds the action representation in a stable video feature space; Stage 3 finally allows planning-oriented gradients to jointly adapt the Action DiT and the planner-facing Video DiT states. Stage 2 requires stop-gradient readouts derived from frozen video features to establish a stable grounding target, whereas Stage 3 intentionally allows decision-oriented gradients to reshape the planner-facing video states.
Results at a Glance
Video generation on nuScenes (val)
| Method | FID β | FVD β |
|---|---|---|
| DriveDreamer | 52.6 | 452.0 |
| Vista | 6.9 | 89.4 |
| Epona | 7.5 | 82.8 |
| DriveLaW | 4.6 | 81.3 |
| ReWorld (Ours) | 4.4 | 61.9 |
Closed-loop planning on NAVSIM Navtest
| Method | NC β | DAC β | TTC β | Comf. β | EP β | PDMS β |
|---|---|---|---|---|---|---|
| DiffusionDrive (cam+lidar) | 98.2 | 96.2 | 94.7 | 100 | 82.2 | 88.1 |
| Epona | 97.9 | 95.1 | 93.8 | 99.9 | 80.4 | 86.2 |
| PWM | 98.6 | 95.9 | 95.4 | 100 | 81.8 | 88.1 |
| WorldDrive | 98.4 | 96.8 | 95.2 | 100 | 83.3 | 89.0 |
| DriveLaW | 99.0 | 97.1 | 96.7 | 100 | 81.3 | 89.1 |
| ReWorld (Ours) | 99.1 | 98.2 | 97.7 | 99.8 | 82.0 | 90.4 |
Do the representations themselves actually improve? β the experiment we care most about:
Driving-domain pretraining alone barely moves the probe (+1.5 over LTX-Video); the representation curriculum adds +11.9. And under a unified from-scratch protocol (120k steps, nuPlan + nuScenes, no text encoder), ReWorld beats the strongest self-supervised baseline by 12.9 FVD at 1.003Γ per-step cost β teacher-based and extra-forward methods pay ~1.4β1.7Γ for less.
Full numbers (UCF-101 probe & unified protocol)
| Frozen Video DiT | Top-1 Acc. (%) β |
|---|---|
| LTX-Video | 66.8 |
| DriveLaW | 68.3 |
| ReWorld (Stage 1) | 71.7 |
| ReWorld (full) | 80.2 |
| Method (120k steps, from scratch) | FVD β | Training cost |
|---|---|---|
| Vanilla Flow | 304.1 | 1.0Γ |
| SRA / Self-Flow | 296.9 / 283.3 | ~1.4Γ |
| REPA w/ DINOv2 | 295.9 | ~1.7Γ |
| ReWorld (Ours) | 270.4 | 1.003Γ |
1s history β 3s future. ReWorld yields sharper lane markings, more stable roadside structure, and clearer distant agents.
NAVSIM Navtest rollouts (red: ReWorld prediction, green: expert) β straight, left turn, right turn, intersection.
Checkpoints
| Folder | File | Role |
|---|---|---|
ReWorld-Video |
dualflow_dit_best_fvd.safetensors |
Stage 1 Video DiT (best FVD) |
ReWorld-Act |
diffusion_pytorch_model.safetensors |
Stages 2β3 Action DiT / planner |
from huggingface_hub import snapshot_download
snapshot_download(repo_id="tz2026/ReWorld")
Or with the CLI:
hf download tz2026/ReWorld
Please download the whole repo (not a single .safetensors file). Hugging Face only increments download stats when config.json is requested, which snapshot_download / hf download always fetch.
Getting Started
Installation
Python β₯ 3.10, CUDA GPU recommended.
# Stage 1 (Video DiT) β from repo root
pip install -U pip setuptools && pip install -e .
# Stages 2β3 (Action planner + NAVSIM)
cd DriveLaW-Act && pip install -e .
Then follow DriveLaW-Act/docs/install.md to download OpenScene / nuPlan maps and set environment variables (NAVSIM_DEVKIT_ROOT, NAVSIM_EXP_ROOT, OPENSCENE_DATA_ROOT, NUPLAN_MAPS_ROOT). Place LTX-Video 0.9.5 weights locally or point the YAMLs at the HF id.
Data preparation
- Stage 1 (video clips): point
video_rootinconfigs/dualflow/dit_train.online.example.yamlat your driving clips. Paper geometry: 33 frames (9 condition + 24 future), 1024Γ512, LTX temporal 8 / spatial 32 compression. For IG inference, name conditioning clipsscene_XXXX_window_000_conditioning.mp4. - Stages 2β3 (NAVSIM caches): cache features and metrics β
Optional warm-start: pretrained weights on π€ tz2026/ReWorld (base DriveLaW weights: tz2026/DriveLaW).cd DriveLaW-Act sh scripts/evaluation/run_caching_videodrive_hidden_state.sh sh scripts/evaluation/run_metric_caching.sh - Stage 3 hard negatives: an offline pool of
{scene_token}.pkl(pdm_score_matrix(N,7) +pred_trajectorys(N,L,3)) undernegative_samples_pathβ download or generate with BeyondDrive. Format:beyonddrive_negatives.py.
Training & inference
Stage 1 β future-predictive Video DiT (edit configs/dualflow/dit_train.online.example.yaml: video_root, vae_model_source, output_dir):
# from repo root
bash train_reworld_stage1.sh
Self-guided video generation (edit configs/dualflow/sample_reworld.yaml: conditioning_dir, dit_checkpoint, vae_model_source, output_root):
# from repo root
bash infer_reworld_stage1.sh
Stage 2 β cross-modal alignment (Video DiT frozen):
cd DriveLaW-Act
sh scripts/training/run_videodrive_train_stage2_align.sh
Stage 3 β RDE with hard negatives (joint fine-tune):
cd DriveLaW-Act
sh scripts/training/run_videodrive_train_stage3_rde.sh
Evaluate (NAVSIM PDMS):
cd DriveLaW-Act
sh scripts/evaluation/run_videodrive_agent_pdm_score_evaluation.sh
Optional base imitation before Stage 2:
scripts/training/run_videodrive_train.shwithvideo_model_train_base.yaml, or start from the π€ DriveLaW checkpoint.
Acknowledgments
ReWorld builds on DriveLaW, NAVSIM, LTX-Video, Diffusers,BeyondDrive,Internal Guidance. Thanks to all of them for open-sourcing.
Citation
@article{xia2026reworld,
title = {ReWorld: Learning Better Representations for World Action Models},
author = {Xia, Tianze and Zhou, Lijun and Xiong, Kaixin and Yao, Jingfeng and Zhu, Yu and Zhu, Zhenxin and Wang, Bing and Chen, Guang and Ye, Hangjun and Liu, Wenyu and others},
journal = {arXiv preprint arXiv:2606.27504},
year = {2026}
}
:mailbox: Contact
Tianze Xia β xiatianze@hust.edu.cn Β· Xinggang Wang β xgwang@hust.edu.cn
- Downloads last month
- -