Update README.md

README.md

@@ -1,3 +1,87 @@
----
-license: mit
----
+---
+license: mit
+language:
+- en
+pipeline_tag: image-to-video
+library_name: diffusers
+---
+# Matrix-Game 2.0: An Open-Source, Real-Time, and Streaming Interactive World Model
+<div style="display: flex; justify-content: center; gap: 10px;">
+  <a href="xxx">
+    <img src="https://img.shields.io/badge/GitHub-100000?style=flat&logo=github&logoColor=white" alt="GitHub">
+  </a>
+  <a href="xxx">
+    <img src="https://img.shields.io/badge/arXiv-Report-b31b1b?style=flat&logo=arxiv&logoColor=white" alt="arXiv">
+  </a>
+    <a href="https://matrix-game-v2.github.io/">
+    <img src="https://img.shields.io/badge/Project%20Page-grey?style=flat&logo=huggingface&color=FFA500" alt="Project Page">
+  </a>
+
+  
+</div>
+
+## 📝 Overview
+**Matrix-Game-2.0（1.8B）** is an interactive world model generates long videos on-the-fly via few-step auto-regressive diffusion 
+
+## ✨ Key Features
+
+- 🚀 **Feature 1**: **Real-Time Distillation**  Efficient ​​few-step diffusion​​ for streaming video synthesis at ​​25 FPS​​, producing ​​minute-level, high-fidelity videos​​ across complex environments with ultra-fast speed.
+- 🖱️ **Feature 2**: **Precise Action Injection** A ​​mouse/keyboard-to-frame​​ module that embeds user inputs as direct interactions, enabling frame-level control and dynamic response in generated videos. 
+- 🎬 **Feature 3**: **Massive Interactive Data Pipeline** A scalable production system for ​​Unreal Engine & GTA5​​ that generates ​​~1350 hours​​ of high-quality interactive video data, covering diverse scenes with frame-level realism.
+
+## 🔥 Latest Updates
+
+* [2025-08] 🎉 Initial release of Matrix-Game-2.0 Model
+
+## 🚀 Performance Comparison
+### GameWorld Score Benchmark Comparison
+
+| Model     | Image Quality ↑ | Aesthetic Quality ↑ | Temporal Cons. ↑ | Motion Smooth. ↑ | Keyboard Acc. ↑ | Mouse Acc. ↑ | Object Cons. | Scenario Cons.|
+|-----------|------------------|-------------|-------------------|-------------------|------------------|---------------|-------------|-------------|
+| Oasis     | 0.27             | 0.27        | 0.82              | **0.99**          | 0.73             | 0.56          | 0.18        |  0.84 | 
+| **Ours**  | **0.61**         | **0.50**    | **0.94**          | 0.98          | **0.91**         | **0.95**      | **0.64**    | **0.80**    |
+
+**Metric Descriptions**:
+
+- **Image Quality** / **Aesthetic**: Visual fidelity and perceptual appeal of generated frames  
+- **Temporal Consistency** / **Motion Smoothness**: Temporal coherence and smoothness between frames  
+- **Keyboard Accuracy** / **Mouse Accuracy**: Accuracy in following user control signals  
+- **Object Consistency**: Geometric stability and consistency of objects over time
+- **Scenario Consistency**: Scenario consistency over time
+
+  Please check our [GameWorld](https://github.com/SkyworkAI/Matrix-Game/tree/main/GameWorldScore) benchmark for detailed implementation.
+
+
+## 🚀 Quick Start
+
+```
+# clone the repository:
+git clone xxx
+cd Matrix-Game-2.0
+
+# install dependencies:
+pip install -r requirements.txt
+
+
+# inference
+bash xxx.sh
+```
+
+## ⭐ Acknowledgements
+
+We would like to express our gratitude to:
+
+- [Diffusers](https://github.com/huggingface/diffusers) for their excellent diffusion model framework
+- [SkyReels-V2](https://github.com/SkyworkAI/SkyReels-V2) for their strong base model
+- [MineDojo](https://minedojo.org/knowledge_base) for their Minecraft video dataset
+- [MineRL](https://github.com/minerllabs/minerl) for their excellent gym framework
+- [Video-Pre-Training](https://github.com/openai/Video-Pre-Training) for their accurate Inverse Dynamics Model
+- [GameFactory](https://github.com/KwaiVGI/GameFactory) for their idea of action control module 
+
+We are grateful to the broader research community for their open exploration and contributions to the field of interactive world generation.
+
+## 📎 Citation
+If you find this project useful, please cite our paper:
+```bibtex
+xxx
+```