MolmoAct2 Documentation
repository·main·Indexed 20 days ago
https://github.com/allenai/molmoact2An open family of action reasoning models for robot control and real-world deployment, built on the Molmo2-ER vision-language backbone. Includes documentation for the molmoact2-policy-server (v0.1.1), Bimanual YAM evaluation setup, and a video benchmark for evaluating encoding/decoding performance for robotics policies using codecs like libx264, libx265, and libsvtav1.
What's inside MolmoAct2
- MolmoAct2 is a family of open action reasoning models designed for robot control and real-world deployment. It utilizes the Molmo2-ER embodied-reasoning vision-language backbone, incorporates robot state and action modeling, and uses a flow-matching continuous action expert for closed-loop manipulation. The project provides base checkpoints for training, fine-tuned policies for deployment, and various robotics datasets.
Overview of π₀ (pi0) Vision-Language-Action models
mainπ₀ (pi0) is a Vision-Language-Action (VLA) model designed for general robot control. This repository provides a Hugging Face port adapted from the OpenPI project by Physical Intelligence.
There are two primary model variants available:
π₀
- Time Conditioning: Concatenates time with actions using
action_time_mlp_*layers. - AdaRMS: Not used.
- Tokenizer Length: 48 tokens.
- Discrete State Input: False (utilizes a
state_projlayer instead). - Parameter Count: Higher, as it includes state embedding.
π₀.₅
- Time Conditioning: Uses
time_mlp_*for AdaRMS conditioning. - AdaRMS: Used in the action expert.
- Tokenizer Length: 200 tokens.
- Discrete State Input: True.
- Parameter Count: Lower, as it does not include state embedding.
- Time Conditioning: Concatenates time with actions using
Overview of π₀.₅ (pi05) Vision-Language-Action Model
mainπ₀.₅ (pi05) is a Vision-Language-Action (VLA) model designed for open-world generalization. This specific implementation is a Hugging Face port adapted from the OpenPI repository by Physical Intelligence.
Key technical differences between the original π₀ and this π₀.₅ version include:
- Time Conditioning: π₀.₅ uses
time_mlp_*for AdaRMS conditioning, whereas π₀ concatenates time with actions viaaction_time_mlp_*. - AdaRMS: π₀.₅ utilizes AdaRMS in the action expert; π₀ does not.
- Tokenizer Length: π₀.₅ uses a 200-token tokenizer, compared to 48 tokens in π₀.
- State Input: π₀.₅ supports discrete state input, while π₀ uses a
state_projlayer. - Parameter Efficiency: π₀.₅ has a lower parameter count because it does not include a state embedding.
- Time Conditioning: π₀.₅ uses
SARM: Stage-Aware Reward Modeling for Long Horizon Robot Manipulation
mainSARM (Stage-Aware Reward Modeling) is a method for long-horizon robot manipulation. Detailed information regarding the methodology, architecture, and experimental results can be found in the official paper.
Paper Link: https://arxiv.org/abs/2509.25358
Supported camera classes in LeRobot
mainLeRobot provides several camera classes depending on your hardware and connection type:
Class Supported Cameras OpenCVCameraPhone, built-in laptop, USB webcams ZMQCameraNetwork-connected cameras RealSenseCameraIntel RealSense (with depth) Reachy2CameraReachy 2 robot cameras Supported PyTorch accelerators in LeRobot
mainLeRobot supports several hardware acceleration backends for training and inference tasks:
- CPU: Standard CPU execution with no dedicated accelerator.
- CUDA: Acceleration using NVIDIA or AMD GPUs.
- MPS: Acceleration using Apple Silicon GPUs (Metal Performance Shaders).
- XPU: Acceleration using Intel integrated or discrete GPUs.
What is HIL-SERL and how does it work?
mainHIL-SERL (Human-in-the-Loop Sample-Efficient Reinforcement Learning) is a workflow designed to train robot policies on real hardware efficiently. It combines human demonstrations with online reinforcement learning and human interventions.
Key components include:
- Offline demonstrations & reward classifier: Uses a small set of human teleoperation episodes and a vision-based success detector to provide a shaped starting point.
- On-robot actor/learner loop: Employs a distributed Soft Actor Critic (SAC) learner that updates the policy while an actor explores on the physical robot. Humans can intervene via a gamepad or keyboard to correct unsafe or unproductive behaviors.
- Safety & efficiency tools: Utilizes joint/end-effector (EE) bounds, crop region of interest (ROI) preprocessing, and WandB monitoring to ensure hardware safety and data quality.
What is an EnvTransition?
mainEnvTransitionis the fundamental, typed dictionary data structure that flows through all processors. It represents a complete robot-environment interaction and contains the following keys:OBSERVATION: All sensor data (images, states, proprioception)ACTION: The action to execute or that was executedREWARD: Reinforcement learning signalDONE/TRUNCATED: Episode boundary indicatorsINFO: Arbitrary metadataCOMPLEMENTARY_DATA: Task descriptions, indices, padding flags, inter-step data
What is WALL-OSS (WallX)?
mainWALL-OSS is an open-source foundation model for embodied intelligence. It uses a tightly-coupled Mixture-of-Experts (MoE) architecture that integrates discrete and continuous action modeling.
Key technical components include:
- Uni-CoT (Unified Cross-Level Chain-of-Thought): A framework unifying high-level reasoning, sub-task decomposition, and fine-grained action synthesis.
- Two-stage training:
- Inspiration stage: Uses discrete action priors for spatial and semantic alignment.
- Integration stage: Uses flow matching for high-frequency continuous control.
- MoE action heads: Dynamically activates experts based on the task phase.
What is WALL-OSS?
mainWALL-OSS is a Vision-Language-Action (VLA) model designed for cross-embodiment robotic control. This specific repository provides the Hugging Face port of the model. It is built upon the Qwen2.5-VL Vision-Language Model and utilizes either Flow Matching (diffusion) or FAST (discrete tokens) for action prediction. The architecture employs a Mixture of Experts (MoE) approach with action-specific routing and supports multi-modal inputs including vision (images/videos), language, and proprioception.What is ACT (Action Chunking with Transformers)?
mainACT is a lightweight and efficient imitation learning policy designed for fine-grained manipulation tasks. It is highly recommended for beginners due to its fast training time, low computational requirements (~80M parameters), and high data efficiency (often succeeding with only 50 demonstrations).
Architecture
ACT utilizes a transformer-based architecture consisting of:
- Vision Backbone: A ResNet-18 that processes images from multiple camera viewpoints.
- Transformer Encoder: Synthesizes camera features, joint positions, and a learned latent variable.
- Transformer Decoder: Generates coherent action sequences using cross-attention.
Inputs and Outputs
- Inputs: Multiple RGB images (e.g., wrist, front, or top cameras), current robot joint positions, and a latent style variable
z(which is set to zero during inference). - Outputs: A chunk of
kfuture action sequences.
What is SARM (Stage-Aware Reward Modeling)?
mainSARM is a video-based reward modeling framework designed for long-horizon robot manipulation tasks. Unlike standard behavior cloning which treats all frames equally, SARM learns a generalizable notion of task progress (a signal from 0 to 1).
This progress signal can be used for:
- Weighted imitation learning (RA-BC): High-progress frames receive more weight during policy training.
- Reinforcement learning: Providing dense rewards for policy improvement.
SARM uses a stage-aware architecture that jointly predicts high-level task stages and fine-grained progress within those stages. It normalizes progress across variable-length demonstrations using dataset-level temporal proportions ($\alpha\bar{k}$), ensuring consistent task states map to consistent progress values.