Instructions to use SemyonXu616/VGAS-5-shot with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- LeRobot
How to use SemyonXu616/VGAS-5-shot with LeRobot:
# See https://github.com/huggingface/lerobot?tab=readme-ov-file#installation for more details git clone https://github.com/huggingface/lerobot.git cd lerobot pip install -e .[smolvla]
# Launch finetuning on your dataset python lerobot/scripts/train.py \ --policy.path=SemyonXu616/VGAS-5-shot \ --dataset.repo_id=lerobot/svla_so101_pickplace \ --batch_size=64 \ --steps=20000 \ --output_dir=outputs/train/my_smolvla \ --job_name=my_smolvla_training \ --policy.device=cuda \ --wandb.enable=true
# Run the policy using the record function python -m lerobot.record \ --robot.type=so101_follower \ --robot.port=/dev/ttyACM0 \ # <- Use your port --robot.id=my_blue_follower_arm \ # <- Use your robot id --robot.cameras="{ front: {type: opencv, index_or_path: 8, width: 640, height: 480, fps: 30}}" \ # <- Use your cameras --dataset.single_task="Grasp a lego block and put it in the bin." \ # <- Use the same task description you used in your dataset recording --dataset.repo_id=HF_USER/dataset_name \ # <- This will be the dataset name on HF Hub --dataset.episode_time_s=50 \ --dataset.num_episodes=10 \ --policy.path=SemyonXu616/VGAS-5-shot - Notebooks
- Google Colab
- Kaggle
Add model card and robotics metadata
#1
by nielsr HF Staff - opened
README.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
pipeline_tag: robotics
|
| 3 |
+
library_name: lerobot
|
| 4 |
+
tags:
|
| 5 |
+
- vla
|
| 6 |
+
- smolvla
|
| 7 |
+
- vgas
|
| 8 |
+
- vision-language-action
|
| 9 |
+
---
|
| 10 |
+
|
| 11 |
+
# VGAS: Value-Guided Action-Chunk Selection
|
| 12 |
+
|
| 13 |
+
This repository contains a Vision-Language-Action (VLA) policy based on the **VGAS** framework, as presented in the paper [VGAS: Value-Guided Action-Chunk Selection for Few-Shot Vision-Language-Action Adaptation](https://huggingface.co/papers/2602.07399).
|
| 14 |
+
|
| 15 |
+
VGAS (Value-Guided Action-chunk Selection) is a framework designed for few-shot VLA adaptation. It uses a generation-selection approach, employing a finetuned VLA as a high-recall proposal generator and a **Q-Chunk-Former** critic to identify action chunks that are both semantically faithful and geometrically precise during inference.
|
| 16 |
+
|
| 17 |
+
## Resources
|
| 18 |
+
- **Paper:** [VGAS: Value-Guided Action-Chunk Selection for Few-Shot Vision-Language-Action Adaptation](https://huggingface.co/papers/2602.07399)
|
| 19 |
+
- **Code:** [GitHub Repository](https://github.com/Jyugo-15/VGAS)
|
| 20 |
+
|
| 21 |
+
## Usage
|
| 22 |
+
|
| 23 |
+
This model is compatible with the [LeRobot](https://github.com/huggingface/lerobot) ecosystem. To evaluate the policy using the scripts provided in the official repository:
|
| 24 |
+
|
| 25 |
+
### Evaluation (Behavior Cloning - No Critic)
|
| 26 |
+
```bash
|
| 27 |
+
python scripts/eval_qc_bestofn.py \
|
| 28 |
+
--env-task libero_goal \
|
| 29 |
+
--policy-path SemyonXu616/my_smolvla \
|
| 30 |
+
--no-use-best-of-n \
|
| 31 |
+
--best-of-n 1
|
| 32 |
+
```
|
| 33 |
+
|
| 34 |
+
### Evaluation (Best-of-N - Critic Guided)
|
| 35 |
+
To perform inference-time selection as described in the paper, you will also need the critic checkpoint:
|
| 36 |
+
```bash
|
| 37 |
+
python scripts/eval_qc_bestofn.py \
|
| 38 |
+
--env-task libero_goal \
|
| 39 |
+
--policy-path SemyonXu616/my_smolvla \
|
| 40 |
+
--critic-state <CRITIC_CKPT> \
|
| 41 |
+
--use-best-of-n \
|
| 42 |
+
--best-of-n 8
|
| 43 |
+
```
|
| 44 |
+
|
| 45 |
+
## Citation
|
| 46 |
+
If you find this work useful, please cite:
|
| 47 |
+
```bibtex
|
| 48 |
+
@article{vgas2025,
|
| 49 |
+
title={VGAS: Value-Guided Action-Chunk Selection for Few-Shot Vision-Language-Action Adaptation},
|
| 50 |
+
author={Jiuhai Chen and Jianwei Yang and Haiping Wu and Dianqi Li and Jianfeng Gao and Tianyi Zhou and Bin Xiao},
|
| 51 |
+
journal={arXiv preprint arXiv:2602.07399},
|
| 52 |
+
year={2025}
|
| 53 |
+
}
|
| 54 |
+
```
|