x-square-robot/X-Planner-9B-0916

<div align="center">

X-Planner-9B-0916

Event-Structured Task Planning for Embodied Intelligence

    

</div>

X-Planner is a planning front end for long-horizon robot manipulation. It combines a high-level instruction, synchronized multi-view observations, and optional execution history to predict the next action-grounded event. The resulting structured plan is passed to a downstream world-action model, making the intermediate planning state explicit and inspectable.

The released X-Planner-9B-0916 model provides the Qwen3.5-based multimodal planner. It supports two complementary interfaces: a readable event mode for structured natural-language planning states, and a unified mode that produces compact latent planning states with Staircase Decoding.

<div align="center"> <img src="assets/X-Planner.jpg" alt="X-Planner architecture: event mode, unified mode, world-action model, and Staircase Decoder" width="100%"> </div>

X-Planner architecture. Multi-view observations and instructions are converted into structured events or latent planning states for a downstream world-action model.

Resources

• —Code and inference guide: X-Square-Robot/Xplanner
• —Benchmark and video preview: x-square-robot/xplanner-benchmark
• —Project page: X-Planner
• —Technical report: X-Planner: Event-Structured Task Planning for Embodied Intelligence

Release contents

The repository includes all model weights, the model/generation configuration, tokenizer, chat template, image/video processor configuration, and minimal checkpoint metadata. Sharding preserves all 760 tensors bit for bit. release_manifest.json records file hashes and the original, unsharded weights SHA-256 for provenance. Training logs, optimizer state, and machine-specific training paths are not required for inference and are not part of this release.

Download

python -m pip install -U huggingface_hub
hf download x-square-robot/X-Planner-9B-0916 \
  --local-dir checkpoints/X-Planner-9B-0916

For reproducible runs, add --revision <commit> using the desired revision from this repository's commit history.

Load with Transformers

Use Transformers with Qwen3.5 support (the checkpoint was saved with 5.2.0), PyTorch, and Accelerate. No custom remote model code is required.

import torch
from transformers import AutoModelForImageTextToText, AutoProcessor

checkpoint = "checkpoints/X-Planner-9B-0916"
processor = AutoProcessor.from_pretrained(checkpoint)
model = AutoModelForImageTextToText.from_pretrained(
    checkpoint,
    dtype=torch.bfloat16,
    device_map="auto",
    attn_implementation="sdpa",
).eval()
model.config.use_cache = True
model.config.text_config.use_cache = True

The weights occupy approximately 18.82 GB in BF16. Inference also needs memory for activations, visual tokens, and the generation cache; total memory use depends on the inputs and generation length.

Structured planning inference

The task-specific prompt, image preparation, history format, and output parser are defined by the X-Planner event-state runtime. After installing its dependencies and preparing an event snapshot, run from the code checkout:

python scripts/inference/run_event_planner.py \
  --checkpoint checkpoints/X-Planner-9B-0916 \
  --snapshot /path/to/event_snapshot \
  --output-dir work_dirs/inference

The event-state CLI requires an X-Planner-compatible data backend and a prepared event snapshot. See the code repository's installation and data-preparation instructions for the backend's public availability. The benchmark's raw video manifest is not a prepared event snapshot.

Benchmark and evaluation scope

The published benchmark contains 1,500 episodes, 3,490 videos, and episode-level planning metadata, with playable multi-view videos in Dataset Preview. Full temporal scoring annotations and a fixed end-to-end evaluation protocol are separate from this media release.

This model card does not report a new evaluation of X-Planner-9B-0916. Results from the technical report or other checkpoint revisions should retain their original model and evaluation provenance.

License

Model weights are distributed under Apache 2.0, consistent with the Qwen3.5-9B architecture's upstream model release. The X-Planner source code is MIT-licensed. Benchmark data and media retain their respective upstream terms, as described in the dataset card.

Citation

@article{xplanner2026event,
  title   = {X-Planner: Event-Structured Task Planning for Embodied Intelligence},
  author  = {{X Square Robot Team}},
  year    = {2026},
  note    = {Technical report}
}