MCPcopy Index your code
hub / github.com/Little-Podi/AdaWorld

github.com/Little-Podi/AdaWorld @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
594 symbols 1,634 edges 56 files 43 documented · 7%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Learning Adaptable World Models with Latent Actions

Project Page Arxiv Hugging Face

PyTorch Python License

Shenyuan Gao, Siyuan Zhou, Yilun Du, Jun Zhang, Chuang Gan


TL;DR: AdaWorld is a highly adaptable world model pretrained with continuous latent actions from thousands of environments, enabling zero-shot action transfer, fast adaptation, and new skill acquisition with minimal finetuning.

We introduce latent actions as a unified condition for action-aware pretraining from videos. AdaWorld can readily transfer actions across contexts without training. By initializing the control interface with the corresponding latent actions, AdaWorld can also be adapted into specialized world models efficiently and achieve significantly better planning results.


  • Action transfer (source video → target scene)

  • Visual planning (action-agnostic vs. AdaWorld)


🕹️ Getting Started

❣️ Acknowledgement

Our idea is implemented based on Vista and Jafar. Thanks for their great open-source work!

🌟 Citation

If any parts of our paper and code help your research, please consider citing us and giving a star to our repository.

@inproceedings{gao2025adaworld,
 title={AdaWorld: Learning Adaptable World Models with Latent Actions},
 author={Gao, Shenyuan and Zhou, Siyuan and Du, Yilun and Zhang, Jun and Gan, Chuang},
 booktitle={International Conference on Machine Learning (ICML)},
 year={2025}
}

✉️ Contact

If you have any questions or comments, feel free to contact me through email (sygao@connect.ust.hk). Suggestions and collaborations are also highly welcome!

Core symbols most depended-on inside this repo

instantiate_from_config
called by 31
worldmodel/vwm/util.py
default
called by 12
worldmodel/vwm/util.py
device
called by 9
worldmodel/external/lam/modules/embeddings.py
linear
called by 9
worldmodel/vwm/modules/diffusionmodules/util.py
exists
called by 8
lam/lam/modules/embeddings.py
exists
called by 8
worldmodel/external/lam/modules/embeddings.py
append_dims
called by 8
worldmodel/vwm/util.py
conv_nd
called by 8
worldmodel/vwm/modules/diffusionmodules/util.py

Shape

Method 351
Class 120
Function 120
Route 3

Languages

Python100%

Modules by API surface

worldmodel/vwm/modules/encoders/modules.py37 symbols
worldmodel/vwm/modules/diffusionmodules/model.py33 symbols
lam/lam/modules/blocks.py30 symbols
worldmodel/vwm/data/dataset.py27 symbols
lam/lam/dataset.py27 symbols
worldmodel/vwm/models/autoencoder.py24 symbols
worldmodel/vwm/modules/attention.py23 symbols
worldmodel/zero_to_fp32.py21 symbols
worldmodel/external/lam/modules/blocks.py21 symbols
worldmodel/train_adapt.py19 symbols
worldmodel/train.py19 symbols
worldmodel/fvd_utils/pytorch_i3d.py18 symbols

For agents

$ claude mcp add AdaWorld \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact