Improve model card: add metadata and links to research

README.md

@@ -1,11 +1,21 @@
 ---
 license: apache-2.0
+pipeline_tag: image-text-to-text
+library_name: transformers
 ---
-# MAI-UI: Real-World Centric Foundation GUI Agents.
+
+# MAI-UI: Real-World Centric Foundation GUI Agents
+
+MAI-UI is a family of foundation GUI agents spanning the full spectrum of sizes, including 2B, 8B, 32B, and 235B-A22B variants. This model is part of the work described in the paper [MAI-UI Technical Report: Real-World Centric Foundation GUI Agents](https://arxiv.org/abs/2512.22047).
+
+- **Code:** [https://github.com/Tongyi-MAI/MAI-UI](https://github.com/Tongyi-MAI/MAI-UI)
+- **Project Page:** [https://tongyi-mai.github.io/MAI-UI/](https://tongyi-mai.github.io/MAI-UI/)
+- **Paper:** [https://arxiv.org/abs/2512.22047](https://arxiv.org/abs/2512.22047)
+
 ![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. 
+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. 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. 
 
 ## 🏆 Results
 
@@ -31,3 +41,23 @@ 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)
+
+## 🚀 Quick Start
+
+For detailed installation and usage instructions, please refer to the [official GitHub repository](https://github.com/Tongyi-MAI/MAI-UI). The models can be served via [vLLM](https://github.com/vllm-project/vllm).
+
+## 📝 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}, 
+}
+```