HAMLET: A Hierarchical and Adaptive Multi-Agent Framework for Live Embodied Theatrics

Official code implementation for HAMLET

We proposed a multi-agent framework HAMLET that decouples offline planning and online performance in AI theatrics scenarios. HAMLET excels in creating expressive, coherent, real-time and physically interactive drama experiences in a fully autonomous manner.

English | 简体中文

📖 Overview

🎉 News

• [2026.03.19] HAMLET was accepted to the Fourteenth International Conference on Learning Representations (ICLR 2026), thanking the academic community for its recognition. See ICLR Poster.
• [2026.03.06] Our paper has been released on arXiv.

🚀 Quick Start

Environment Setup

1. Install Dependencies:

conda create -n HAMLET python=3.10
conda activate HAMLET
pip install -r requirements.txt

2. API Key Configuration:

Run cp .env.example .env , then open the .env file and enter your own API keys.

OPENAI_API_KEY=
OPENAI_BASE_URL=

🥇 Leaderboard

Please Check HAMLET Leaderboard.

🙏 Acknowledgement

This project benefits from IBSEN. We thank the above open-source projects for their outstanding work!

✨ Contribution

Upcoming Features & Contributions

We welcome community contributions! Join us in building these exciting features.

📜 Citation

@inproceedings{Jiang2025HAMLETAH,
  title={HAMLET: A Hierarchical and Adaptive Multi-Agent Framework for Live Embodied Theatrics},
  author={Shufan Jiang and Sizhou Chen and Chi Zhang and Xiao-Lei Zhang and Xuelong Li},
  year={2025},
  url={https://api.semanticscholar.org/CorpusID:280671946}
}