X-WAM-DROID

X-WAM-DROID

X-WAM (Wan2.2-TI2V-5B world action model) fine-tuned on DROID with 8-D raw joint-position actions and three camera views. Same layout as the official sharinka0715/X-WAM-checkpoints release, so it drops into the upstream X-WAM code.

Model details

Action space

DROID raw joint positions [joint_0 … joint_6, gripper] written into X-WAM's 14-D action slots (and 16-D proprio slots) — see action_mapping.json:

• action slots in the 14-D vector: [0, 1, 2, 3, 4, 5, 7, 6] (gripper goes to slot 6)
• normalization: y = clip(2·(x − q01)/(q99 − q01) − 1, −1, 1), then the gripper channel is negated, so after normalization +1 = open, −1 = closed (X-WAM convention; raw DROID is 0 = open, 1 = closed)
• q01 / q99 are in both config.yaml and action_mapping.json

Decode predictions by undoing those steps in reverse order.

Training

• Data — DROID (OXE LeRobot cache), episodes with all three views, augmentation on (crop 0.95, brightness/contrast/saturation 0.2).
• Objective — X-WAM flow matching on video, action and proprio (action and proprio loss weights 1.0; no depth loss since there is no depth branch), uniform timestep distribution with shift 5, joint distribution with a 50% clean-action ratio, text dropout 0.1.
• Optimization — AdamW, LR 1e-5, weight decay 0.01, 200 warmup steps then cosine over 20,000 steps, grad clip 1.0, batch 112 (4 × GH200 × 28), FSDP with bf16-mixed precision.

Files

config.yaml                                          training config (+ action_num, normalization stats)
action_mapping.json                                  DROID 8-D <-> X-WAM 14-D mapping and normalization
checkpoints/last.ckpt/checkpoint/mp_rank_00_model_states.pt   {"module": state_dict, "global_step", "epoch"}

config.yaml is the run's own config with one addition: action_num: 4, which the training dataset sets at runtime and the runner needs to build the model.

Usage

hf download rooty2020/X-WAM-DROID --local-dir checkpoints/droid

Then point the upstream X-WAM scripts at it like any official checkpoint, e.g. evaluation/policy_server.py, which loads checkpoints/last.ckpt/checkpoint/mp_rank_00_model_states.pt with a strict load_state_dict(ckpt["module"]). Build the runner from this config.yaml (use_depth: false) — the official pretrained config has a depth branch and will not match.

Provenance

Converted from the Lightning FSDP sharded checkpoint last.ckpt (step 800) with xwam-droid/scripts/export_hf.py: the DiT tensors are cast fp32 → bf16 and keyed at runner level (model.*); the frozen text_encoder.* / vae.* tensors are copied from the official pretrained release, since they are never trained.

License

Apache 2.0, following X-WAM and Wan2.2. Training data comes from DROID; its terms apply to the data.