Add metadata, paper/code links, and quick start instructions

README.md

@@ -1,12 +1,39 @@
 ---
 license: apache-2.0
+library_name: transformers
+pipeline_tag: image-text-to-text
 ---
+
 # MAI-UI: Real-World Centric Foundation GUI Agents.
+
+[[📄 Paper](https://arxiv.org/abs/2512.22047)] [[🌐 Website](https://tongyi-mai.github.io/MAI-UI/)] [[💻 GitHub](https://github.com/Tongyi-MAI/MAI-UI)]
+
 ![overview](https://cdn-uploads.huggingface.co/production/uploads/63525c3a6cfb8f1498127a34/_ibfeHy_31ZRanQ3xxlnn.png)
 
 ## 📖 Background
 The development of GUI agents could revolutionize the next generation of human-computer interaction. Motivated by this vision, we present MAI-UI, a family of foundation GUI agents spanning the full spectrum of sizes, including 2B, 8B, 32B, and 235B-A22B variants. We identify four key challenges to realistic deployment: the lack of native agent–user interaction, the limits of UI-only operation, the absence of a practical deployment architecture, and brittleness in dynamic environments. MAI-UI addresses these issues with a unified methodology: a self-evolving data pipeline that expands the navigation data to include user interaction and MCP tool calls, a native device–cloud collaboration system that routes execution by task state, and an online RL framework with advanced optimizations to scale parallel environments and context length. 
 
+## 🚀 Quick Start
+
+### Deployment with vLLM
+You can deploy the model using vLLM (requires `vllm>=0.11.0` and `transformers>=4.57.0`):
+
+```bash
+# Install vLLM
+pip install vllm
+
+# Start vLLM API server
+python -m vllm.entrypoints.openai.api_server \
+    --model Tongyi-MAI/MAI-UI-8B \
+    --served-model-name MAI-UI-8B \
+    --host 0.0.0.0 \
+    --port 8000 \
+    --tensor-parallel-size 1 \
+    --trust-remote-code
+```
+
+The model will be served at `http://localhost:8000/v1`.
+
 ## 🏆 Results
 
 ### Grounding
@@ -31,3 +58,19 @@ MAI-UI establishes new state-of-the-art across GUI grounding and mobile navigati
 ### Device-Cloud Collaboration
 - Our device-cloud collaboration framework can dynamically select on-device or cloud execution based on task execution state and data sensitivity. It improves on-device performance by 33% and reduces cloud API calls by over 40%.
 ![dcc](https://cdn-uploads.huggingface.co/production/uploads/63525c3a6cfb8f1498127a34/Fm2PPxbRpASfdvVBxkjLw.jpeg)
+
+## 📝 Citation
+
+If you find this project useful for your research, please consider citing our work:
+
+```bibtex
+@misc{zhou2025maiuitechnicalreportrealworld,
+      title={MAI-UI Technical Report: Real-World Centric Foundation GUI Agents}, 
+      author={Hanzhang Zhou and Xu Zhang and Panrong Tong and Jianan Zhang and Liangyu Chen and Quyu Kong and Chenglin Cai and Chen Liu and Yue Wang and Jingren Zhou and Steven Hoi},
+      year={2025},
+      eprint={2512.22047},
+      archivePrefix={arXiv},
+      primaryClass={cs.CV},
+      url={https://arxiv.org/abs/2512.22047}, 
+}
+```