Metadata-Version: 2.4
Name: ve-mobile-use
Version: 0.0.1
Summary: 云手机智能操作SDK，基于AI大模型实现云手机的自动化操作和智能交互
Author-email: Oanakiaja <oanakiaja@gmail.com>, sakia0z <sakia0z@163.com>
Maintainer-email: Oanakiaja <oanakiaja@gmail.com>, sakia0z <sakia0z@163.com>
License: Apache-2.0
Keywords: mobile,automation,ai,llm,cloud-phone,testing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.9.4
Requires-Dist: tomli>=2.2.1
Requires-Dist: pydantic>=2.11.4
Requires-Dist: langgraph>=0.4.5
Requires-Dist: langchain-mcp-adapters>=0.1.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: pillow>=11.2.1
Requires-Dist: openai>=1.90.0
Requires-Dist: langchain>=0.3.25
Requires-Dist: langchain-openai>=0.3.24
Requires-Dist: volcengine>=1.0.190
Requires-Dist: langchain-deepseek>=0.1.3
Requires-Dist: volcengine-python-sdk[ark]>=4.0.4
Requires-Dist: click>=8.1.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: aiohttp>=3.8.0
Provides-Extra: dev
Requires-Dist: pytest>=8.4.1; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.8.6; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Dynamic: license-file

# Mobile Use SDK

云手机智能操作SDK，基于AI大模型实现云手机的自动化操作和智能交互。

[Mobile Use SDK 使用指南](https://www.volcengine.com/docs/6394/1783697)

## 🚀 产品概述

[Mobile Use 解决方案介绍文档](https://www.volcengine.com/docs/6394/1583515)

**Mobile Use** 是基于 **火山引擎云手机** 与 **豆包视觉大模型** 能力，通过自然语言指令完成面向移动端场景自动化任务的 AI Agent 解决方案。


目前，Mobile Use 已正式上线火山引擎 [函数服务 veFaaS 应用广场](https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/market)，可点击跳转在线体验 Mobile Use Agent Demo；同时，如果您想要开发一款属于您自己的 Mobile Use Agent 应用，可以通过 [一键部署](https://console.volcengine.com/vefaas/region:vefaas+cn-beijing/application/create)，快速完成服务部署搭建，开启您将 Mobile Use Agent 集成在您业务流中的开发之旅。

## 🚀 项目介绍

Mobile Use SDK 是一个强大的云手机自动化操作框架，通过AIMobileUse实现对云手机的自动化控制。该SDK集成了大语言模型、图状态机和MCP工具协议，为移动应用测试、自动化操作和智能交互提供完整解决方案。

### 核心特性

- **🤖 Mobile Use**: 基于 LangGraph 的 ReAct Agent，支持复杂多步骤任务自动执行
- **📱 云手机操作**: 完整的云手机控制能力（启动应用、截图、点击、滑动、输入等）
- **🔄 流式交互**: 实时流式响应，支持用户中断和交互反馈
- **📊 结构化输出**: 支持自定义Pydantic模型的结构化数据输出
- **🔧 MCP工具集成**: 支持Model Context Protocol工具生态扩展
- **⚡ 连接池管理**: 自动管理MCP和云手机连接，提高性能和稳定性


### 使用方法

详见[Mobile Use SDK 使用指南](https://www.volcengine.com/docs/6394/1783697)
