Skip to content

xlang-ai/FineVLA

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FineVLA

FineVLA: Fine-Grained Instruction Alignment
for Steerable Vision-Language-Action Policies

Xintong Hu*x   Xuhong Huang*x   Jinyu Zhangx   Yutong Yaox   Yuchong Sunq   Qiuyue Wangq
Mingsheng Liq   Sicheng Xieq   Yitao Liux   Junhao Chenx   Yixuan Chenx   Yingming Zhengx   Shuai Baiq   Tao Yu†x

xXLANG Lab, The University of Hong Kong      qQwen Team, Alibaba Inc.
XLANG Lab         Qwen
*Equal contribution   Corresponding author

Project Paper Models Benchmark License

Updates

  • 2026-06-03: RoboFine-VLM annotator released on HuggingFace.
  • 2026-05-26: FineVLA-Tool, RoboFine-Bench, and FineVLA-Policy code released.
  • Coming soon: Pretrained and fine-tuned policy checkpoints.

FineVLA is a unified, fully open-source framework for fine-grained instruction alignment in Vision-Language-Action (VLA) learning. We argue that to steer robot behavior, language must be aligned with the action choices that determine execution — not just what to do, but how to do it.

FineVLA Overview

Figure 1: Overview of FineVLA. FineVLA builds a closed loop for action-instruction alignment, connecting fine-grained data construction, robotic video understanding, scalable annotation, and steerable VLA policy learning. Left: FineVLA-Tool unifies heterogeneous robot trajectories from 10 open-source datasets, removes redundant demonstrations through clustering and sampling, and annotates representative trajectories with action-aligned descriptions across ten fine-grained dimensions. The resulting FineVLA-Data supports both RoboFine-Bench, which evaluates fine-grained robotic video understanding through Grounding VQA, Reasoning VQA, and Caption Evaluation, and RoboFine-VLM, a robotics-specialized VLM trained as a scalable annotator for new trajectories. Right: FineVLA-Policy is trained with mixtures of raw goal-level instructions and fine-grained process-level instructions under two action-decoding architectures, and is evaluated in both RoboTwin simulation and real-world dual-arm manipulation. The steerable-control examples illustrate how fine-grained language specifies execution-sensitive factors such as contact region, target object, active actor, trajectory and orientation, and failure recovery.

Highlights

  • Fine-grained supervision improves both goal-level success and steerable control. Mixed FG:Raw = 1:1 reaches 86.8% in RoboTwin simulation and 62.7/100 in real-world dual-arm manipulation, compared with 49.9 for Raw-only.
  • Inverted-U mixing trend. Fine-grained and raw goal-level instructions are complementary — the optimal ratio (FG:Raw = 1:2 to 1:1) consistently outperforms either alone, across architectures, data scales, and sim-to-real transfer.
  • Steerable control gains. In real-world evaluation, the largest improvements appear on execution-sensitive factors: Pose (+23), Color (+18), and Approach Direction (+18) — precisely the factors where goal-level instructions provide no guidance.
  • Complete open-source release. Data pipeline, 47K fine-grained annotations, benchmark, VLM annotator, model checkpoints, and training code.

Release Progress

Component Description Status
FineVLA-Tool Data construction pipeline: format unification, clustering, and fine-grained annotation Released
RoboFine-Bench Fine-grained robotic video understanding benchmark (500 videos, 11,631 facts, 1,030 VQA questions) Released
RoboFine-VLM Robotics-specialized VLM annotator (fine-tuned Qwen3.5-397B-A17B) Released

Getting Started

Clone the Repository

git clone https://github.com/xlang-ai/FineVLA.git
cd FineVLA

FineVLA-Tool

See FineVLA-Tool/README.md for the data construction pipeline.

RoboFine-Bench

Benchmark data is hosted on HuggingFace: FineVLA/RoboFine-Bench

See RoboFine-Bench/README.md for evaluation code and instructions.

FineVLA-Policy

See FineVLA-Policy/README.md for training and evaluation. Quick start:

cd FineVLA-Policy

# Install
conda create -n finevla python=3.10 -y && conda activate finevla
pip install -r requirements.txt
pip install flash-attn --no-build-isolation
pip install -e .

# Smoke test
python starVLA/model/framework/QwenGR00T.py

# Train (example: ALOHA with FG:Raw=1:1)
bash examples/Aloha/run_qwen35_GR00T_aloha_multi_FG1_1_dlc.sh

Framework Overview

FineVLA addresses three key gaps in building steerable VLA systems:

1. FineVLA-Tool + FineVLA-Data

Problem: Heterogeneous robot data with coarse, goal-level-only annotations.

FineVLA-Tool unifies 972,247 trajectories across 85K tasks from 10 open-source datasets, reduces redundancy via DTW-based clustering, and annotates representative samples with process-level descriptions across ten fine-grained dimensions:

Dimension What it captures
Action Sequence Step-by-step execution order
Active Actor Which arm / end-effector to use
Target Object Object disambiguation
Initial Configuration Starting state of objects and robot
Final Configuration End state after manipulation
Contact & Approach Where and how contact is made
Trajectory & Orientation Motion path and tool orientation
Body Motion Full-body or joint-level movement
Object Interaction How objects relate during manipulation
Failure & Recovery Error handling and recovery behavior

The result is FineVLA-Data: 47,159 human-verified trajectories with fine-grained instructions, a 10.4x increase in average instruction length (9.3 to 96.8 words).

Source Trajectories Steps Avg Words (Coarse) Avg Words (FG) Density
BridgeData-V2 4,958 21,554 10.1 61.7 6.1x
BC-Z 1,513 5,313 5.2 51.2 9.8x
RT-1 5,232 22,023 6.8 61.4 9.1x
Galaxea 2,834 18,484 4.7 219.9 47.1x
RoboMIND-V1 4,605 20,341 8.6 72.8 8.5x
RoboMIND-V2 7,119 39,166 6.6 98.8 14.9x
RoboCOIN 8,513 43,926 16.1 122.6 7.6x
RH20T 1,387 5,560 7.9 92.1 11.7x
RDT 1,275 8,437 16.9 114.0 6.7x
DROID 9,723 35,802 8.0 90.9 11.3x
Total 47,159 220,606 9.3 96.8 10.4x

2. RoboFine-Bench

Problem: No benchmark for fine-grained robotic video understanding.

RoboFine-Bench evaluates whether VLMs capture execution-level manipulation details through two tracks:

  • VQA Track — 1,030 questions across three axes: Entity & Scene Grounding, Action & Motion Understanding, Interaction & State Reasoning
  • Caption Track — Step-level action description with Consistency, Coverage, and Anti-Hallucination metrics under Easy (with instruction) and Hard (vision-only) settings

500 held-out videos from 10 datasets, 32 embodiments, 11,631 atomic facts — strictly disjoint from all training data.

For detailed benchmark description, evaluation code, and results, see RoboFine-Bench on HuggingFace.

3. RoboFine-VLM

Problem: General-purpose VLMs miss execution-level details critical for action-instruction alignment.

RoboFine-VLM is obtained by fine-tuning Qwen3.5-397B-A17B on FineVLA-Data. With the updated RoboFine-Bench atomic-fact GT, it achieves 68.2% VQA accuracy and 82.2% caption Overall (hard setting), outperforming GPT-5.4, Gemini-3.1-Pro, Doubao-Seed-2.0-Pro, and Qwen baselines. It serves as a scalable annotator for extending fine-grained supervision to new trajectories.

4. FineVLA-Policy

Problem: Unknown whether fine-grained supervision improves policy learning, and what mixing ratio works best.

FineVLA-Policy trains VLA policies under two architectures (StarVLA-OFT and StarVLA-GR00T) with systematic FG:Raw instruction mixing. Key findings:

RoboTwin Simulation:

FG:Raw RDT-OFT (Easy/Hard) RDT-GR00T (Easy/Hard) AlohaMix-OFT (Easy/Hard)
Raw-only 61.5 / 60.0 55.1 / 53.4 71.8 / 71.4
FG:Raw = 1:4 68.2 / 66.5 58.2 / 55.7 75.3 / 74.3
FG:Raw = 1:2 74.1 / 72.1 61.7 / 60.9 82.8 / 78.6
FG:Raw = 1:1 73.9 / 72.4 69.4 / 68.2 86.8 / 82.5
FG:Raw = 2:1 70.4 / 68.3 65.9 / 63.1 80.9 / 79.3
FG:Raw = 4:1 68.6 / 67.5 64.9 / 63.2 79.5 / 78.5
FG-only 62.9 / 62.0 62.1 / 61.5 78.3 / 76.1

Real-World Dual-Arm (100-point scale):

Supervision Clean Table Stack Block Color Pose Approach Rotate Arm L→R (OOD) Avg (ID) Avg (All)
Raw-only 72 35 22 24 60 76 60 0 49.9 43.6
FG:Raw = 1:4 76 36 28 32 65 79 61 0 53.9 47.1
FG:Raw = 1:2 79 39 36 48 76 87 63 5 61.1 54.1
FG:Raw = 1:1 84 40 40 47 78 86 64 10 62.7 56.1
FG:Raw = 2:1 80 38 34 42 72 83 62 5 58.7 52.0
FG:Raw = 4:1 74 37 31 43 72 83 62 5 57.4 50.9
FG-only 70 35 25 41 70 80 60 0 54.4 47.6

Citation

@article{hu2026finevla,
  title={FineVLA: Fine-Grained Instruction Alignment for Steerable Vision-Language-Action Policies},
  author={Hu, Xintong and Huang, Xuhong and Zhang, Jinyu and Yao, Yutong and Sun, Yuchong and Wang, Qiuyue and Li, Mingsheng and Xie, Sicheng and Liu, Yitao and Chen, Junhao and others},
  journal={arXiv preprint arXiv:2605.27284},
  year={2026}
}

Acknowledgements

FineVLA-Policy is built on StarVLA. We also gratefully acknowledge LeRobot, GR00T, DeepSpeed, and Qwen-VL.

License

This project is released under the Apache License 2.0.

  • Code, tools, and pipeline: Apache License 2.0
  • Benchmark data: Available on HuggingFace

Disclaimer

The authors are not responsible for any misuse of this project. The framework and associated tools are intended for research purposes in controlled environments. Use of the FineVLA name does not imply endorsement by the authors.

About

Scalable annotation pipeline for action-aglined fine-grained instruciton for Visual-language-Action model

Topics

Resources

License

Stars

70 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors