Create README.md

README.md

@@ -0,0 +1,78 @@
+---
+license: mit
+language:
+- en
+base_model:
+- Qwen/Qwen2.5-VL-32B-Instruct
+---
+
+# GUI-Owl
+
+<div align="center">
+<img src=https://youke1.picui.cn/s1/2025/08/18/68a2f82fef3d4.png width="40%"/>
+</div>
+
+GUI-Owl is a model series developed as part of the Mobile-Agent-V3 project. It achieves state-of-the-art performance across a range of GUI automation benchmarks, including ScreenSpot-V2, ScreenSpot-Pro, OSWorld-G, MMBench-GUI, Android Control, Android World, and OSWorld. Furthermore, it can be instantiated as various specialized agents within the Mobile-Agent-V3 multi-agent framework to accomplish more complex tasks.
+
+* **Paper**: 
+* **GitHub Repository**: https://github.com/X-PLUG/MobileAgent
+* **Online Demo**: Comming soon
+
+## Performance
+
+### ScreenSpot-V2, ScreenSpot-Pro and OSWorld-G
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/screenspot_v2.jpg?raw=true" width="80%"/>
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/screenspot_pro.jpg?raw=true" width="80%"/>
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/osworld_g.jpg?raw=true" width="80%"/>
+
+### MMBench-GUI L1, L2 and Android Control
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/mmbench_gui_l1.jpg?raw=true" width="80%"/>
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/mmbench_gui_l2.jpg?raw=true" width="80%"/>
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/android_control.jpg?raw=true" width="40%"/>
+
+### Android World and OSWorld-Verified
+<img src="https://github.com/X-PLUG/MobileAgent/blob/main/Mobile-Agent-v3/assets/online.jpg?raw=true" width="40%"/>
+
+## Usage
+
+Please refer to our cookbook.
+
+## Deploy
+
+We recommand deploy GUI-Owl-32B through vllm
+
+This script has been validated on an A100 with 96 GB of VRAM. If you serve GUI-Owl-32B on an H20-3e, you can set MP_SIZE=1 for faster inference speed.
+```bash
+PIXEL_ARGS='{"min_pixels":3136,"max_pixels":10035200}'
+IMAGE_LIMIT_ARGS='image=2'
+MP_SIZE=2
+MM_KWARGS=(
+    --mm-processor-kwargs $PIXEL_ARGS
+    --limit-mm-per-prompt $IMAGE_LIMIT_ARGS
+)
+
+vllm serve $CKPT \
+    --max-model-len 32768 ${MM_KWARGS[@]} \
+    --tensor-parallel-size $MP_SIZE \
+    --allowed-local-media-path '/' \
+    --port 4243
+```
+
+If you want GUI-Owl to recieve more than two images, you could increase `IMAGE_LIMIT_ARGS` and reduce `max_pixels`.
+
+For example:
+```bash
+PIXEL_ARGS='{"min_pixels":3136,"max_pixels":3211264}'
+IMAGE_LIMIT_ARGS='image=5'
+MP_SIZE=2
+MM_KWARGS=(
+    --mm-processor-kwargs $PIXEL_ARGS
+    --limit-mm-per-prompt $IMAGE_LIMIT_ARGS
+)
+
+vllm serve $CKPT \
+    --max-model-len 32768 ${MM_KWARGS[@]} \
+    --tensor-parallel-size $MP_SIZE \
+    --allowed-local-media-path '/' \
+    --port 4243
+```