# AutoGLM-mobile-fastapi

**Repository Path**: smartwings/AutoGLM-mobile-fastapi

## Basic Information

- **Project Name**: AutoGLM-mobile-fastapi
- **Description**: AutoGLM-mobile-fastapi 是一个基于 open-autoGLM开发的项目，使用fastapi为其添加 HTTP 接口。
- **Primary Language**: Python
- **License**: MIT-0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2025-12-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 项目介绍

AutoGLM-mobile-fastapi 是一个基于 open-autoGLM 开发的项目，使用 fastapi 为其添加 HTTP 接口。它能够以多模态方式理解手机屏幕内容，并通过自动化操作帮助用户完成任务。系统通过 ADB(Android Debug Bridge) 来控制设备，以视觉语言模型进行屏幕感知，再结合智能规划能力生成并执行操作流程。

### 核心技术栈

- **FastAPI**: 高性能的 Python Web 框架，用于构建 API 端点和提供 Web 服务
- **open-autoGLM**: 基于 GLM 模型的多模态手机智能助理核心引擎
- **ADB**: Android Debug Bridge，用于与 Android 设备进行通信和控制
- **Pydantic**: 用于数据验证和设置管理
- **jQuery**: 前端 JavaScript 库，用于处理 AJAX 请求

### 主要功能

1. **ADB 设备管理**: 通过 API 实现设备的连接、配对和状态查询
2. **Web 界面**: 提供直观的图形界面，用于设备连接
3. **多模态理解**: 结合视觉和语言模型，理解手机屏幕内容
4. **自动化操作**: 自动执行打开应用、点击、输入、滑动等操作
5. **远程控制**: 支持通过 WiFi 或网络进行远程设备控制

## 快速开始

### 环境准备

1. **Python 3.10+**
2. **ADB (Android Debug Bridge)**
3. **Android 7.0+ 设备或模拟器**，已启用开发者模式和 USB 调试
4. **ADB Keyboard** (用于文本输入)

### 安装依赖

```bash
pip install -r requirements.txt
pip install -e .
```

### 启动服务

```bash
python api.py --port 8001 --debug
```

服务将在 `http://localhost:8001` 启动，你可以通过浏览器访问 Web 界面。

## API 接口

### ADB 相关接口

#### 连接设备

- **URL**: `/api/v1/adb/connect`
- **方法**: `POST`
- **请求体**:
  ```json
  {
    "ip": "192.168.1.100",
    "port": "5555",
    "wlan_pairing_code": "123456"
  }
  ```
- **响应**:
  ```json
  {
    "success": true,
    "message": "Successfully connected to 192.168.1.100:5555",
    "result": null
  }
  ```

#### 查看已连接设备

- **URL**: `/api/v1/adb/connected`
- **方法**: `GET`
- **响应**:
  ```json
  {
    "success": true,
    "message": "",
    "result": [
      {
        "device_id": "192.168.1.100:5555",
        "connection_type": "wifi"
      }
    ]
  }
  ```

## Web 界面

### 使用方法

1. 启动服务后，在浏览器中访问 `http://localhost:8001`
2. 在界面中输入设备的 IP 地址和端口号
3. 如有需要，输入 WLAN 配对码
4. 点击"连接"按钮，系统将尝试连接到设备
5. 连接成功后，可以在界面中发送指令操作手机

### 界面功能

- **设备连接**: 输入 IP、端口和配对码连接设备
- **连接状态**: 显示当前已连接的设备
- **指令输入**: 输入自然语言指令控制手机