
Agent-S
让 AI 像人一样看屏幕点鼠标,自动完成电脑任务
Agent-S 是一个开源的智能体框架,目标是让 AI 像人类一样操作计算机。它通过 Agent-Computer Interface(ACI)把屏幕截图、鼠标键盘操作和任务规划整合成闭环,让大模型能够观察 GUI 界面、理解当前状态并执行点击、输入、拖拽等动作,从而自动完成跨应用的复杂任务。项目解决的核心问题是:传统自动化脚本依赖固定坐标和选择器,界面一变就失效;而 Agent-S 借助视觉 grounding 与上下文学习,让智能体根据自然语言指令自主决策操作步骤,无需为每个软件单独编写脚本。核心能力包括屏幕感知与元素定位、多步任务规划、记忆与经验复用、以及可扩展的工具调用接口,支持在真实桌面环境中执行办公、浏览、数据录入等操作,适合研究 computer-use agent 与 GUI 自动化的开发者。
项目数据
使用教程
环境要求
- Python 环境(需可用 pip)
- macOS 上需先安装 Homebrew(用于 brew install tesseract)
- Pytesseract 依赖的 tesseract OCR 程序
- OpenAI API 密钥(推荐主模型 gpt-5-2025-08-07)
- UI-TARS-1.5-7B 作为 grounding 模型
安装与启动步骤
-
1安装 Agent S3 包
不克隆仓库时,直接用 pip 从 PyPI 安装 gui-agents 包即可完成安装。
pip install gui-agents -
2安装 tesseract
Pytesseract 需要额外的系统级 tesseract 程序,README 提示不要忘记安装。
brew install tesseract -
3克隆源码(可选)
如果想在修改代码的同时测试 Agent S3,先克隆 GitHub 仓库再安装。
git clone https://github.com/simular-ai/Agent-S.git cd Agent-S -
4源码可编辑安装
在仓库目录内使用 -e 方式安装,改动代码后无需重新安装。
pip install -e . -
5配置 API 密钥
README 中有 API Configuration 小节,按其指引填入所用模型的 API 密钥;该节未给出具体命令。
-
6按推荐组合配置模型
官方推荐主模型用 OpenAI gpt-5-2025-08-07,并搭配 UI-TARS-1.5-7B 做 grounding。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
主模型 | 是 | 负责任务规划与决策的模型,官方推荐配置。 | gpt-5-2025-08-07 |
grounding 模型 | 是 | 负责界面元素定位的模型,官方推荐与主模型搭配。 | UI-TARS-1.5-7B |
API 密钥 | 是 | 调用模型所需的密钥,配置方式见 README 的 API Configuration。 | sk-xxxxxxxx |
如何确认成功
执行 pip show gui-agents 能显示已安装的版本信息,即说明安装成功;README 未提供运行验证命令。
常见问题
Q:不想克隆仓库怎么安装?
A:直接执行 pip install gui-agents 从 PyPI 安装即可,无需下载源码。
Q:报 Pytesseract 相关错误怎么办?
A:Pytesseract 需要额外的 tesseract 程序,macOS 上执行 brew install tesseract 安装。
Q:应该用哪个模型?
A:README 推荐主模型使用 OpenAI gpt-5-2025-08-07,搭配 UI-TARS-1.5-7B 做 grounding。
Q:安装后怎么启动运行?
A:README 节选中未给出运行命令,请以仓库和官方文档中的最新说明为准。
注意事项
- README 节选只包含安装与 API 配置说明,未给出具体启动命令,请勿照搬网络上的其他命令。
- brew install tesseract 针对 macOS,其他系统需用对应包管理器安装 tesseract。
- pip install -e . 必须在克隆下来的仓库目录内执行。
- API Configuration 小节在节选中内容为空,配置项名称与写入位置需查看仓库原文。
核心亮点
- 提供完整的 Agent-Computer Interface,把截图感知、动作执行和任务规划串成可运行闭环
- 内置视觉 grounding 与上下文学习机制,界面变化时仍能定位目标元素,比固定坐标脚本更鲁棒
- 开源且基于 Python,便于研究者复现、替换模型或接入自定义工具,社区星标超 1.2 万
不足之处
- 依赖大模型视觉与推理能力,复杂界面下误操作率仍较高,稳定性受模型质量影响明显
- 真实桌面环境部署涉及权限、分辨率与多屏适配,工程落地成本不低
适用场景
- 自动完成跨应用的办公流程,如从邮件提取信息填入表格
- 代替人工执行重复的网页操作与数据录入任务
- 研究 GUI agent 的感知、规划与 grounding 能力
替代项目
Open Interpreter、AutoGPT、Browser Use
项目介绍
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···