whatisgithub

What is starwam?

shaohua-pan/starwam — explained in plain English

Analysis updated 2026-05-18

180PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A modular research codebase for building robot control models that combine AI video generation with action prediction, tested on LIBERO and RoboTwin benchmarks.

Mindmap

mindmap
  root((StarWAM))
    What it does
      Video plus action models
      Robot policy research
      Modular backbones
      Early research release
    Tech stack
      Python
      PyTorch
      Wan2.2 backbone
      Cosmos-Predict2 backbone
    Use cases
      LIBERO benchmark
      RoboTwin benchmark
      Pretrained checkpoints
    Model families
      mot_wam
      shared_dit_wam
      feature_conditioned_action_model

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 a robot policy that combines a pretrained video generation model with an action prediction module.

USE CASE 2

Run and evaluate robot learning experiments on the LIBERO or RoboTwin 2.0 benchmarks.

USE CASE 3

Download pretrained checkpoints to reproduce reported results without training from scratch.

What is it built with?

PythonPyTorchWan2.2Cosmos-Predict2

How does it compare?

shaohua-pan/starwammisaka-mikoto-tech/agent-skillsretro-diffusion/pixel-art-fixer
Stars180180183
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires GPU infrastructure, benchmark-specific setup, and downloading large pretrained checkpoints from ModelScope.

The readme does not state a specific license, so terms of use are unclear.

So what is it?

StarWAM is a research codebase for building what its authors call World-Action Models, a type of robot control system that combines an AI video generation model with a module that predicts physical actions. The idea is that a model which has learned to generate realistic video of the world can also be adapted to help a robot decide what to do next, since predicting what happens visually and predicting what action to take are related problems. This is early stage research code, and the authors say more model variants, benchmarks, and pretrained models will be added over time. The codebase is built to be modular, meaning researchers can mix and match different existing video generation backbones, such as Wan2.2 or Cosmos-Predict2, with different approaches to combining video and action prediction. It currently supports three different families of these combined models, each with a different internal design for how video information and action information interact inside the network. Configuration for experiments is handled through YAML recipe files that get loaded into typed Python objects, rather than requiring a separate configuration framework. The project includes example setups for two established robotics benchmarks, LIBERO and RoboTwin 2.0, with instructions for training and evaluating models on each. Pretrained model checkpoints are hosted separately on ModelScope and can be downloaded with a small command line tool, including specific weights for both of the supported model families on the LIBERO benchmark and a dual-arm setup for RoboTwin 2.0. The project acknowledges that it draws heavily on ideas and code from several other open research projects in robot learning and video generation, crediting them by name. The readme includes a roadmap of completed and planned work, including a technical report that has not yet been released, and a citation section that is still pending a formal reference. The readme does not state a specific software license for the code.

Copy-paste prompts

Prompt 1
Explain the difference between the mot_wam, shared_dit_wam, and feature_conditioned_action_model families in StarWAM.
Prompt 2
Help me set up StarWAM's LIBERO example and download the matching pretrained checkpoint from ModelScope.
Prompt 3
How do I write a YAML recipe file for training a new World-Action Model in StarWAM?
Prompt 4
Walk me through StarWAM's repository layout so I understand where the backbone adapters and training code live.

Frequently asked questions

What is starwam?

A modular research codebase for building robot control models that combine AI video generation with action prediction, tested on LIBERO and RoboTwin benchmarks.

What language is starwam written in?

Mainly Python. The stack also includes Python, PyTorch, Wan2.2.

What license does starwam use?

The readme does not state a specific license, so terms of use are unclear.

How hard is starwam to set up?

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

Who is starwam for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.