Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CLEAR-LeWM v0.8 Moderate and Strict task-semantic evaluation

v0.8 Strict SR is shown as official LeWM / paired random, rounded from the mean over seeds 0, 1, and 42.

CLEAR-LeWM

v0.8.0 MIT License pytest and ruff CI v0.8 protocol Moderate and Strict

Minimal evaluator repair when comparability matters. Task-semantic precision when completion matters.
CLEAR-LeWM removes pre-solved cases, repairs demonstrated evaluator defects, freezes paired manifests, and exposes every success decision for audit.

Junhan Sun1    Guofeng Zhang1,†    Hao Zhao2,†
1State Key Laboratory of CAD&CG, Zhejiang University  |  2Tsinghua University  |  †Corresponding authors

Website · Releases · Results · Modes · Specification · Submit Results · Checkpoints

Results at a glance

CLEAR v0.8 four-task comparison: task-specific INTACT E1 Direct and Guarded A alongside LeWM, DINOv2, and GCBC pure-CEM references in Moderate and Strict modes

Single-task INTACT E1 (history). Red marks the best SR for each task and mode.

CLEAR v0.8 four-task comparison: unified shared-encoder INTACT E5 Direct and Guarded A alongside labeled single-task pure-CEM references in Moderate and Strict modes

Unified INTACT E5. CEM references are single-task, not epoch-matched. Protocol and seed statistics.

News

  • 2026-09-14 - Added public INTACT Direct and Guarded A results on the frozen CLEAR v0.8 Moderate/Strict manifests (RTX 4090, three training seeds and three evaluation seeds).
  • 2026-09-13 - Added the INTACT paper citation for researchers building on CLEAR-LeWM's auditable evaluation.
  • 2026-09-09 - Merged PR #7 from @ma-kjh, adding configurable Adam and DINO-WM optimizer profiles, device-safe stable-worldmodel==0.1.0 support, and deterministic planner regression tests while keeping CEM canonical.
  • 2026-08-28 - Released v0.8.0, closing the Reacher action-repeat termination leak and publishing an audited 84-run RTX 4090 reference matrix with corrected documentation and media.
  • 2026-07-24 - Accepted the first community result submission in PR #1 from @zerotul782231, covering DINOv2 No-Proprio and GCBC Joint LeWM checkpoints under the frozen v0.5 protocol.
  • 2026-07-23 - Released v0.5.1 with the complete three-seed, 48-run reference matrix after v0.5.0 unified the benchmark around separate Moderate and Strict modes.
  • 2026-07-22 - Released v0.3.0, introducing task-semantic completion rules, deterministic manifests, matched random controls, and task-specific audit guides.
  • 2026-07-21 - Released v0.2.1 with audited FAST loading and explicit runtime modes after v0.2.0 established the reproducible three-tier evaluation standard.
  • 2026-07-21 - Published v0.1.0, the initial four-task CLEAR-LeWM evaluation release with deterministic manifests, initial-success filtering, and paired random baselines.

CLEAR-LeWM v0.8 Moderate and Strict overview

Important

CLEAR-LeWM is an independent community evaluation project, not an official LeWM release. It reevaluates pinned official LeWM checkpoints and preserves their provenance. Official LeWM and paired random define the reference table; related public checkpoints are reported separately as independently rerun comparisons.

Note

v0.8 closes a Reacher evaluator leak: dm-control task termination is disabled before rollout and reapplied after reset or model recompilation, so CLEAR owns the full success decision. Historical v0.5 remains available as the immutable v0.5.1 release and under results/v0.5/.

Warning

Published comparisons use solver batch size 1. Batch 16 changes CEM random-number ordering and is a development throughput mode, not a matched reference setting.

Why CLEAR-LeWM

The historical stack mixes genuinely difficult control with evaluator effects: initially solved start-goal pairs, incorrect Reacher angle topology, early dm-control termination before CLEAR can score the rollout, and a TwoRoom rewrite whose endpoint-only collision check can admit an invalid wall crossing. Cube also has a high random floor because many sampled windows do not move the cube.

CLEAR-LeWM separates two scientific questions instead of forcing one rule to answer both.

Two auditable modes

Mode Scientific question Design rule
Moderate Does a method improve LeWM after fixing evaluator bugs and trivial cases? Change as little as possible; preserve released PushT and Cube predicates.
Strict Does the rollout precisely complete the task-relevant physical goal? Score the object or endpoint, tighten geometry, and require short persistence where appropriate.
Task v0.8 Moderate v0.8 Strict
PushT pusher + T position <20 px; T angle <20 deg; first hit T only <10 px / 10 deg; hold 3
Cube cube center <=4 cm; first hit cube center <=3 cm + 24-fold orientation <=15 deg; hold 3
Reacher periodic shoulder + bounded wrist <0.05 rad; first hit fingertip endpoint <=1 cm; hold 2
TwoRoom clean cross-room pair; swept disk; endpoint <16 px valid legal crossing + goal side + endpoint <8 px

Moderate is the closest corrected continuation of the released benchmark. Strict is the stronger semantic claim. They must be reported as separate columns. Exact inequalities and runtime gates are normative in EVALUATION_SPEC_V08.md.

Reference results

The primary table uses pinned official high-epoch LeWM checkpoints and paired random policies. All runs were independently executed on RTX 4090 GPUs with 100 episodes, 300 x 30 CEM, top-k 30, solver batch size 1, and strict 303/303 tensor loading.

Moderate: seeds 0, 1, and 42

Mean +/- sample standard deviation across complete paired runs:

Task Official LeWM Paired random Excess
PushT 86.67 +/- 0.58% 4.00 +/- 1.00% +82.67 pp
Cube 50.33 +/- 3.79% 15.67 +/- 6.03% +34.67 pp
Reacher 79.67 +/- 0.58% 7.33 +/- 2.08% +72.33 pp
TwoRoom 83.00 +/- 5.29% 6.67 +/- 1.15% +76.33 pp

Strict: seeds 0, 1, and 42

Mean +/- sample standard deviation across complete paired runs:

Task Official LeWM Paired random Mean excess
PushT 70.67 +/- 5.51% 5.00 +/- 1.73% +65.67 pp
Cube 21.67 +/- 4.73% 6.00 +/- 2.65% +15.67 pp
Reacher 87.00 +/- 1.00% 8.00 +/- 6.24% +79.00 pp
TwoRoom 51.33 +/- 3.21% 1.67 +/- 2.89% +49.67 pp

The JSON files in results/v0.8/runs/ are the source of truth. They include all episode outcomes, manifest hashes, criteria, solver settings, environment fingerprints, checkpoint hashes, and topology diagnostics.

Task guides

01. PushT

PushT v0.8 object-pose trace

Moderate preserves the complete pusher-plus-block goal state. Strict asks the task-semantic question: is the T itself placed correctly? A full-image latent cost can therefore differ from Strict completion, and methods should disclose their planning target. Read the PushT guide.

02. Cube

Cube v0.8 position and symmetry-aware pose trace

Moderate follows OGBench's 4 cm cube-position task. Strict adds a 3 cm position gate and 15 degree orientation modulo all 24 proper cube rotations. Neither mode scores terminal robot pose. Read the Cube guide.

03. Reacher

Reacher v0.8 joint-topology and endpoint trace

Moderate repairs the shoulder/wrist topology while preserving joint matching. Strict scores the physical fingertip endpoint for two consecutive steps. Both modes disable the environment's own task termination throughout rollout, including after reset and recompilation, so only the declared CLEAR predicate can terminate scoring. Read the Reacher guide.

04. TwoRoom

TwoRoom v0.8 swept-disk route trace

Both modes reject polluted source windows and execute corrected swept-disk physics. Strict additionally requires a legal room crossing, goal-side arrival, and an 8 px endpoint. Read the TwoRoom guide.

Quick start

git clone --recurse-submodules https://github.com/DavidSunok/CLEAR-LeWM.git
cd CLEAR-LeWM
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev,lewm]'
python scripts/prepare_official_checkpoints.py --cache-dir "$STABLEWM_HOME"

Evaluate the identical Strict pair set with random and official LeWM:

clear-lewm evaluate \
  --manifest manifests/v0.8/tworoom/strict-seed42-n100.json \
  --policy random --cache-dir "$STABLEWM_HOME" \
  --dataset-path /path/to/tworoom.h5 \
  --solver-batch-size 1 \
  --output results/tworoom-v08-strict-random.json

clear-lewm evaluate \
  --manifest manifests/v0.8/tworoom/strict-seed42-n100.json \
  --policy official/tworoom/weights.pt --policy-label official-lewm \
  --cache-dir "$STABLEWM_HOME" \
  --dataset-path /path/to/tworoom.h5 \
  --num-samples 300 --n-steps 30 --topk 30 \
  --solver-batch-size 1 --strict-checkpoint \
  --random-results results/tworoom-v08-strict-random.json \
  --output results/tworoom-v08-strict-lewm.json

Canonical v0.8 reference runs use pure CEM with --actor-warmstart off; no alternative inference contract is mixed into the reference table.

The upstream LeWM Adam planner can be selected explicitly with --planner adam. CLEAR applies a narrow compatibility adapter for stable-worldmodel==0.1.0: a full-horizon initialization is moved to the solver device before CUDA sample noise is added. Omitting --planner preserves the canonical CEM default. Alternative planners are experimental/non-reference profiles for robustness studies, not canonical v0.8 reference runs.

--planner dinowm-gd applies DINO-WM's optimizer profile to LeWM visual latents: random-normal initialization, 1,000 manual SGD updates at learning rate 1, Gaussian action noise 0.003, and terminal visual-latent MSE with mean reduction. It does not reproduce the DINO-WM model: the adapter has neither the DINO encoder contract nor DINO-WM's proprioceptive objective. Actor-prior initialization is unsupported; an explicit --actor-warmstart on is rejected. The default auto setting resolves to off for this planner. Use --n-steps for shorter diagnostic runs. Result JSON records the initialization, source revision, model scope, finite-value checks, and aggregate solver runtime. No performance advantage is claimed.

Audited FAST training I/O

FAST is an optional derived reader, not a new dataset. It decodes once into verified row-major memory maps while preserving complete action chunks and episode boundaries.

Training input Source samples/s FAST samples/s Paired speedup
PushT / Lance 672.3 3812.0 5.79x
Cube / HDF5 119.5 4426.5 37.72x
Reacher / HDF5 143.0 4362.1 30.77x
TwoRoom / HDF5 279.2 4291.4 15.15x

The four-task geometric-mean loader speedup is 17.87x. These figures exclude conversion and model compute. See PERFORMANCE.md.

Reproducibility contract

Every matched comparison must share the manifest, dataset fingerprint, environment, policy seed, control budget, solver budget, solver batch size, and protocol mode. MuJoCo, Pymunk, dm-control, Gymnasium, PyTorch, CUDA, cuDNN, task source, checkpoint source, and evaluator source are fingerprinted.

The pinned official source revisions and hashes are in checkpoints/official-v0.5.json. Binary weights and datasets remain outside ordinary Git.

Community results

Public methods may submit auditable Moderate and/or Strict result bundles. CI verifies structure, canonical manifest hashes, trace arithmetic, provenance, and topology. It does not imply independent reproduction or endorsement.

Independently rerun v0.8 checkpoints

This table compares published models with their stated inference methods on the same RTX 4090 CLEAR v0.8 Moderate/Strict manifests; it is not an actor-off, matched-compute model ablation. Official LeWM, DINOv2 No-Proprio LeWM, and GCBC Joint LeWM use pure CEM 300 x 30 (no actor prior). The three public INTACT checkpoint families use either Direct action prediction (no sampled search) or actor-guided Guarded A 128 x 3. Each evaluation seed 0/1/42 contributes 100 episodes. LeWM/DINOv2/GCBC use the published checkpoint for each task; INTACT additionally averages training seeds 0/42/3072, with all three evaluation seeds per training seed.

All entries are success rates (%). The macro is an equal-weight four-task mean, shown only for models with all four tasks. INTACT's +/- is the sample standard deviation across its three training-seed macro means; it is not the episode-level uncertainty or directly comparable to the three-evaluation-seed variation of the other models. DINOv2 and GCBC do not have released Reacher checkpoints.

Public checkpoint Inference Mode PushT Cube Reacher TwoRoom Four-task macro
Official LeWM CEM 300 x 30 Moderate 86.67 50.33 79.67 83.00 74.92
Strict 70.67 21.67 87.00 51.33 57.67
DINOv2 No-Proprio LeWM CEM 300 x 30 Moderate 7.00 44.67 - 43.67 -
Strict 8.67 13.00 - 25.67 -
GCBC Joint LeWM CEM 300 x 30 Moderate 5.33 17.67 - 16.00 -
Strict 7.33 3.67 - 6.67 -
INTACT, task-specific E1 (history) Direct Moderate 89.56 100.00 98.22 96.89 96.17 +/- 0.60
Strict 79.67 87.33 97.67 93.00 89.42 +/- 0.96
Guarded A 128 x 3 Moderate 93.89 99.22 95.89 96.78 96.44 +/- 0.50
Strict 85.22 86.78 96.33 94.44 90.69 +/- 1.00
INTACT, task-specific E1 (no previous action) Direct Moderate 89.56 98.78 93.67 98.11 95.03 +/- 0.69
Strict 76.33 84.33 96.11 96.67 88.36 +/- 0.46
Guarded A 128 x 3 Moderate 94.22 98.56 94.00 98.11 96.22 +/- 0.32
Strict 82.11 83.44 96.89 96.00 89.61 +/- 0.84
INTACT, unified E5 Direct Moderate 89.00 99.89 98.22 79.44 91.64 +/- 0.88
Strict 76.00 91.67 98.78 53.00 79.86 +/- 2.96
Guarded A 128 x 3 Moderate 88.22 98.44 97.78 78.00 90.61 +/- 1.55
Strict 70.33 91.11 98.33 73.11 83.22 +/- 1.13

Direct uses a five-action receding horizon and the checkpoint-matched actor. The history-enabled actor receives only actions before the sampled start, then its own executed actions; the no-previous-action actor ignores that history channel. No current or future expert action is supplied. These are CLEAR v0.8 scores, not Official Direct scores. Per-task variation and training-seed means for INTACT are in the INTACT evaluation record; the official/DINOv2/GCBC per-evaluation-seed variation, hashes, and episode traces are under results/v0.8/.

Historical v0.5 submissions

Canonical community entries use policy seed 42 and 100 episodes per task/mode. Values are model / paired random (excess). CI validates the bundle structure, canonical manifests, trace arithmetic, provenance, and topology; the verification label states whether execution was independently reproduced.

Method Task Moderate Strict Verification
DINOv2 No-Proprio LeWM PushT 8% / 3% (+5 pp) 7% / 7% (0 pp) self-reported; @zerotul782231
Cube 43% / 15% (+28 pp) 17% / 8% (+9 pp)
Reacher - -
TwoRoom 55% / 6% (+49 pp) 26% / 0% (+26 pp)
GCBC Joint LeWM PushT 9% / 3% (+6 pp) 9% / 7% (+2 pp) self-reported; @zerotul782231
Cube 16% / 15% (+1 pp) 3% / 8% (-5 pp)
Reacher - -
TwoRoom 15% / 6% (+9 pp) 9% / 0% (+9 pp)

A dash means that task/mode was not submitted. Supplementary evidence that does not match the canonical manifest/seed contract remains in each method card and is not mixed into this table.

Read the submission guide.

Repository map

Path Purpose
clear_lewm/ evaluator, manifests, task metrics, topology, submissions
manifests/v0.8/ canonical Moderate/Strict manifests
results/v0.8/ audited RTX 4090 reference and related-checkpoint results
results/v0.5/ immutable historical H200 archive
submissions/leaderboard.json generated community-result registry
docs/tasks/ task objectives, gates, and reproduction commands
scripts/build_v08_media.py synchronized GIF and 1080p overview generator
tests/ protocol, manifest, runtime, result, and submission regressions

Citation

If you find CLEAR-LeWM useful, please consider citing our INTACT paper:

@misc{sun2026intact,
  title         = {INTACT: Isomorphic Intent-to-Action Learning for Search-Free World Models},
  author        = {Sun, Junhan and Zhao, Hao and Zhang, Guofeng},
  year          = {2026},
  eprint        = {2607.26056},
  archivePrefix = {arXiv},
  url           = {https://arxiv.org/abs/2607.26056}
}

License and attribution

CLEAR-LeWM is MIT licensed. Upstream LeWM, stable-worldmodel, OGBench, DMC, Pymunk, MuJoCo, PLDM, and DINO-WM components remain under their own licenses and attribution requirements.

About

An auditable and reproducible evaluation suite for LeWM-compatible latent world models, with official-compatible and difficulty-controlled protocols.

Topics

Resources

Contributing

Stars

43 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages