whatisgithub

What is act-plus-plus?

markfzp/act-plus-plus — explained in plain English

Analysis updated 2026-05-18

3,615PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A robot imitation learning toolkit for the Mobile ALOHA robot, offering three training methods and two simulated tasks to test without hardware.

Mindmap

mindmap
  root((act-plus-plus))
    What it does
      Imitation learning
      Action Chunking Transformers
      Diffusion Policy
    Tech stack
      Python
      PyTorch
      MuJoCo
    Use cases
      Train robot policy
      Simulate pick and place
      Simulate peg insertion
    Audience
      Robotics researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Train an ACT policy in simulation on the cube transfer task without physical hardware

USE CASE 2

Compare ACT, Diffusion Policy, and VINN on the same demonstration dataset

USE CASE 3

Generate scripted demonstration data in MuJoCo before training a policy

USE CASE 4

Train a real Mobile ALOHA robot to imitate recorded human demonstrations

What is it built with?

PythonPyTorchMuJoCodm_control

How does it compare?

markfzp/act-plus-plusthe-moonwitch/cozettebchao1/bullet
Stars3,6153,6153,616
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity5/51/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Needs Python 3.8, PyTorch, MuJoCo, and dm_control installed, plus a GPU for practical training times.

No license terms are stated in the explanation provided.

So what is it?

This repository contains code for training robots to imitate human movements using a technique called imitation learning. The primary target is Mobile ALOHA, a two-armed mobile robot system, but the code also includes two simulated table-top environments you can use to test things on a regular computer without any physical hardware. The repo implements three different learning approaches. ACT (Action Chunking with Transformers) is the main one, where the robot learns to predict a sequence of actions at each step rather than one action at a time, which helps it move more smoothly. Diffusion Policy is a second approach that frames the motion planning problem similarly to how image generators work, building up a motion plan by starting from noise and refining it. VINN is a third method. Each of these is a distinct way to turn a collection of recorded demonstrations into a policy the robot can follow on its own. The simulation environments use MuJoCo, a physics simulator, and include two tasks: picking up a cube and transferring it, and inserting a peg into a socket with both arms. You can generate training data by running scripted demonstrations in the simulator, train a model on those demonstrations, and then evaluate how well the trained policy performs on new runs. The success rate for the transfer cube task with ACT is described as around 90%, while the insertion task is around 50%. Installation requires Python 3.8 and a list of pip packages including PyTorch, MuJoCo, and dm_control. Training commands are run from the command line with flags to control batch size, number of training epochs, learning rate, and other parameters. A linked tuning guide notes that if the robot's movements come out jerky or it pauses unexpectedly, training for more epochs typically improves smoothness even after the training loss appears to have leveled off.

Copy-paste prompts

Prompt 1
Help me set up the MuJoCo simulation environments in this repo and run a scripted demo
Prompt 2
Explain the difference between ACT, Diffusion Policy, and VINN as implemented here
Prompt 3
Walk me through training an ACT policy on the peg insertion simulated task
Prompt 4
My trained policy looks jerky, what does this repo's tuning guide suggest I try

Frequently asked questions

What is act-plus-plus?

A robot imitation learning toolkit for the Mobile ALOHA robot, offering three training methods and two simulated tasks to test without hardware.

What language is act-plus-plus written in?

Mainly Python. The stack also includes Python, PyTorch, MuJoCo.

What license does act-plus-plus use?

No license terms are stated in the explanation provided.

How hard is act-plus-plus to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is act-plus-plus for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.