---

We introduce $\mathcal{F}_1$, a novel paradigm by integrating visual foresight generation into the decision-making pipeline. Our model employs a Mixture-of-Transformer architecture with dedicated modules for perception, foresight generation, and control, thereby bridging understanding, generation, and actions through predictive inverse dynamics modeling.

🚀 Key Innovations

• 🧠 Predictive Inverse Dynamics: Visual foresight generation for planning-based control
• 🏗️ Mixture-of-Transformer: Three specialized experts (Understanding, Generation, Action)
• 📈 Three-Stage Training: Progressive alignment, pretraining, and adaptation

🤖 Real-World Robot Experiments

Multi-task Manipulation

Rapid Adaptation

Long-horizon Planning

Dynamic Environment

Performance Summary

🚀 Quick Start

Prerequisites

• Python ≥ 3.10
• torch ≥ 2.6.0
• CUDA ≥ 12.4

Installation

# Clone repository
git clone https://github.com/InternRobotics/F1-VLA.git
export VLA_HOME=$(pwd)
cd F1-VLA/f1_vla

# Create environment
conda create -n f1_vla python==3.10
conda activate f1_vla

# Install dependencies
pip install torch==2.6.0 torchvision==0.21.0 torchaudio==2.6.0 torchcodec==0.2.1 --index-url https://download.pytorch.org/whl/cu124

# install f1_vla
pip install -e .

pip install numpy==1.26.4

For optimal performance and compatibility, we highly recommend using FFmpeg alongside TorchCodec.

• FFmpeg is an industry-standard multimedia framework that provides robust, all-purpose video and audio processing.
• TorchCodec is a library specifically designed for deep learning workflows in PyTorch, offering highly optimized video I/O.

By using these two tools, the time of loading the video dataset is greatly accelerated.

Download Pretrained Datasets and Models

Basic Usage

f1_vla
├── config
│   ├── debug_test.yaml
│   └── f1_config.json
├── requirements.txt
├── setup.py
├── src
│   ├── configs
│   ├── models
│   ├── policies
│   ├── processors
│   └── utils
└── train_hf.py

Finetune

# 1. edit config file
vim f1_vla/config/debug_test.yaml

# 2. run the program
cd $(VLA_HOME)
python train_hf.py --config-file f1_vla/config/debug_test.yaml

📚 Citation

If you use this work in your research, please cite our paper:

@article{lv2025f1,
  title={F1: A vision-language-action model bridging understanding and generation to actions},
  author={Lv, Qi and Kong, Weijie and Li, Hao and Zeng, Jia and Qiu, Zherui and Qu, Delin and Song, Haoming and Chen, Qizhi and Deng, Xiang and Pang, Jiangmiao},
  journal={arXiv preprint arXiv:2509.06951},
  year={2025}
}

📄 License

This project is licensed under the MIT License.

🙏 Acknowledgments

• Lerobot
• Any4lerobot
• VAR