README.md

August 29, 2026 · View on GitHub

LIBERO-Para

A Diagnostic Benchmark and Metrics for Paraphrase Robustness in VLA Models

Chanyoung Kim1*   Minwoo Kim1*   Minseok Kang1   Hyunwoo Kim2   Dahuin Jung2†

1Soongsil University    2Chung-Ang University
* Equal contribution    † Corresponding author

Paper Project Page HuggingFace Dataset Daily Papers Featured on X

🎉 Our paper is accepted to EMNLP 2026 Main!

🔥 Our paper is ranked #3 on Hugging Face Daily Papers! (Apr 7, 2026)


Paraphrase Taxonomy

Robotic manipulation instructions are fundamentally structured around what to act on and how to act. LIBERO-Para decomposes paraphrases along these two essential axes: object-referring expressions and action-referring expressions. Each axis is independently varied, and composing both yields compositional paraphrases. See the paper for details.


Highlights

  • Unified benchmark: LIBERO-Para extends LIBERO with 4,000+ paraphrased instructions across 10 evaluation scenarios, all in a single repository.
  • Multi-model evaluation: 6 VLA models integrated with per-model conda environments, standalone eval scripts, and step-by-step guides. Clone, install, and run.
  • Original LIBERO compatible: All original LIBERO suites (Spatial, Object, Goal, LIBERO-10, LIBERO-90) are preserved and can be evaluated from the same codebase.
  • PRIDE metric: A new difficulty-aware metric that goes beyond binary success rate, giving more credit for succeeding on harder paraphrases.
  • Cross-benchmark validation: CALVIN-Para applies the same taxonomy and metric to CALVIN, confirming the findings transfer across simulators, robots, and task families.

Evaluation Guides

Each model is evaluated using a custom standalone script under eval_scripts/examples/, which directly interfaces with the model's inference server or loads the model directly. Follow each model's guide for environment setup and evaluation.

ModelParamsArchitectureReleaseGuideScriptStatus
OpenVLA-OFT (Goal)7.5BParallel Decoding2025.03Guideeval_openvla_oft.py
OpenVLA-OFT (Mixed)7.5BParallel Decoding2025.03Guideeval_openvla_oft.py
Pi 0.5 (Base)3.3BVLM + Action Expert2025.09Guideeval_pi05.py
Pi 0.5 (Expert-Only)3.3BVLM + Action Expert2025.09Guideeval_pi05.py
X-VLA0.9BSoft-prompted2026.01Guideeval_x_vla.py
VLA-Adapter0.6BBridge-based2025.09Guideeval_vla_adapter.py
Xiaomi-Robotics-04.7BVLM + Action Expert2026.02Guideeval_xiaomi_robotics_0.py
More coming soon...

Adding a new model? Each eval script follows the same pattern: pre-create 10 LIBERO envs, swap in paraphrased instructions, and query the model. Clone the model repo into eval_scripts/, write a lightweight eval script in eval_scripts/examples/, and add a guide in eval_guides/. See any existing script as a template. We plan to continuously add more VLA models.


PRIDE Metric

PRIDE (Paraphrase Robustness Index in Robotic Instructional DEviation) evaluates how robustly a VLA model handles paraphrased instructions.

It computes a Paraphrase Distance (PD) from keyword similarity (SK) and structural similarity (ST), then measures the ratio of PD-weighted successes to total possible PD, normalized to 0 through 100. Unlike plain success rate, PRIDE gives more credit for succeeding on harder, more deviated paraphrases.

Details: metrics/README.md  |  Interactive: PRIDE_metric_playground.ipynb


Metrics & Analysis

Setup

conda create -n libero-para python=3.10 -y
conda activate libero-para
pip install -r metrics/requirements.txt
python -m spacy download en_core_web_sm

Quick Start

Example results (Xiaomi-Robotics-0, seed7) are included in logs_para/example_xiaomi-robotics-0/.

Note: Action trajectories are stripped from the example logs to reduce file size.

python metrics/analyze_results.py \
    --model_path logs_para/example_xiaomi-robotics-0

See metrics/README.md for multi-model comparison, PRIDE sweep, and more.

Cross-Benchmark: CALVIN-Para

Is paraphrase brittleness a quirk of LIBERO, or a property of VLA models in general? CALVIN-Para ports the same 43-cell paraphrase taxonomy and the same PRIDE metric onto CALVIN, a different simulator, robot, and task family, with 1,935 paraphrased instructions over 15 CALVIN tasks, evaluated on FLOWER and RoboFlamingo. All three findings reproduce.

Every episode logs its full end-effector trajectory, so failures are classified beyond pass/fail: nearly succeeded, executed a different task, or wandered off entirely.

Details: calvin-para/README.md  |  Setup guides: calvin-para/eval_guides/  |  Dataset: HAI-Lab/CALVIN-Para  |  Paper: Appendix E

Paraphrase Generation

The LLM generator + verifier used to build both benchmarks' paraphrase sets lives in paraphrase_generation/: prompt templates, the 43-cell taxonomy definitions, and the generate, verify, and merge pipeline.


Project Structure

LIBERO-Para/
├── libero/                        # Benchmark core (LIBERO-based)
├── metrics/                       # PRIDE metric & analysis tools
│   ├── analyze_results.py
│   ├── PRIDE_metric_playground.ipynb
│   └── libero_para_metadata.csv
├── eval_guides/                   # Per-model setup guides
├── eval_scripts/
│   ├── examples/                  # Eval scripts (one per model)
│   ├── openvla-oft/               # Clone: github.com/moojink/openvla-oft
│   ├── x-vla/                     # Clone: github.com/huggingface/lerobot
│   ├── vla-adapter/               # Clone: github.com/OpenHelix-Team/VLA-Adapter
│   └── xiaomi-robotics-0/         # Clone: github.com/XiaomiRobotics/Xiaomi-Robotics-0
├── logs_para/                     # Evaluation results
│   └── example_xiaomi-robotics-0/ # Example data (seed7)
├── paraphrase_generation/         # LLM paraphrase generator + verifier
├── calvin-para/                   # Cross-benchmark: CALVIN paraphrase robustness
│   ├── paraphrase_eval/           # Episode builder, runners, analysis
│   ├── eval_guides/               # Per-model setup guides
│   ├── patches/                   # Per-episode eval patches for model repos
│   └── RESULTS/                   # Figures and tables
├── images/
├── benchmark_scripts/
└── scripts/

Acknowledgement

This project is built upon LIBERO by Bo Liu, Yifeng Zhu, Chongkai Gao, Yihao Feng, Qiang Liu, Yuke Zhu, and Peter Stone.

The cross-benchmark evaluation is built upon CALVIN by Oier Mees, Lukas Hermann, Erick Rosete-Beas, and Wolfram Burgard.