Agent-S

环境要求

• Python 环境（需可用 pip）
• macOS 上需先安装 Homebrew（用于 brew install tesseract）
• Pytesseract 依赖的 tesseract OCR 程序
• OpenAI API 密钥（推荐主模型 gpt-5-2025-08-07）
• UI-TARS-1.5-7B 作为 grounding 模型

安装与启动步骤

1. 1安装 Agent S3 包

   不克隆仓库时，直接用 pip 从 PyPI 安装 gui-agents 包即可完成安装。

   pip install gui-agents

   复制

2. 2安装 tesseract

   Pytesseract 需要额外的系统级 tesseract 程序，README 提示不要忘记安装。

   brew install tesseract

   复制

3. 3克隆源码（可选）

   如果想在修改代码的同时测试 Agent S3，先克隆 GitHub 仓库再安装。

   git clone https://github.com/simular-ai/Agent-S.git
   cd Agent-S

   复制

4. 4源码可编辑安装

   在仓库目录内使用 -e 方式安装，改动代码后无需重新安装。

   pip install -e .

   复制

5. 5配置 API 密钥

   README 中有 API Configuration 小节，按其指引填入所用模型的 API 密钥；该节未给出具体命令。

6. 6按推荐组合配置模型

   官方推荐主模型用 OpenAI gpt-5-2025-08-07，并搭配 UI-TARS-1.5-7B 做 grounding。

关键配置

如何确认成功

执行 pip show gui-agents 能显示已安装的版本信息，即说明安装成功；README 未提供运行验证命令。

常见问题

注意事项

• README 节选只包含安装与 API 配置说明，未给出具体启动命令，请勿照搬网络上的其他命令。
• brew install tesseract 针对 macOS，其他系统需用对应包管理器安装 tesseract。
• pip install -e . 必须在克隆下来的仓库目录内执行。
• API Configuration 小节在节选中内容为空，配置项名称与写入位置需查看仓库原文。