Open-Interface

环境要求

• Windows 10 / Ubuntu 20.04（官方已测试）/ macOS（含 Apple Silicon 与 Intel）
• 方式二脚本运行需安装 Python 3.12 或更新版本
• 一个可用的 OpenAI API Key（用于 GPT-4o，账号需充值，解锁 GPT-4o 最低 5 美元）
• macOS 需授予辅助功能（控制键鼠）和屏幕录制权限

安装与启动步骤

1. 1下载安装包

   打开最新 Release 页面，按系统下载 macOS 二进制、Linux zip 或 Windows zip。

2. 2安装并启动程序

   macOS 解压后拖入 Applications 再启动；Windows 解压后把 exe 放到目标位置双击运行。

3. 3授予系统权限

   macOS 首次启动会申请辅助功能与屏幕录制权限，若未弹出需到系统设置-隐私与安全性手动添加。

4. 4克隆仓库（脚本方式）

   不想用安装包时可用源码运行，先克隆仓库并进入目录。

   git clone https://github.com/AmberSahdev/Open-Interface.git
   cd Open-Interface

   复制

5. 5创建虚拟环境

   可选步骤，避免污染全局环境；pyenv 对 tkinter 支持异常，需自行排查。

   python -m venv .venv
   source .venv/bin/activate

   复制

6. 6安装依赖

   在项目根目录安装 requirements.txt 中的全部 Python 依赖。

   pip install -r requirements.txt

   复制

7. 7启动应用

   用 Python 直接运行主程序，脚本方式启动界面。

   python app/app.py

   复制

8. 8配置 API Key

   右上角 Settings 填入 OpenAI Key；用 Gemini 或自定义 LLM 则在 Advanced Settings 选择模型并填写地址。保存后必须重启应用。

关键配置

如何确认成功

应用正常打开界面，Settings 中填好 Key 并重启后，输入自然语言指令可看到屏幕截图与自动键鼠操作。

常见问题

注意事项

• 本项目通过模拟键鼠操作电脑，运行时请勿手动抢占鼠标键盘。
• API Key 会保存在应用设置中，请勿在共享电脑上随意填写。
• 必须授予屏幕录制权限，否则无法截图评估进度，代理会失效。
• 自定义 LLM 需兼容 OpenAI API 风格，否则需额外做接口转换。