项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 10300
技术标签
使用教程
环境要求
- Python 环境与 pip 包管理器
- 一个可用的 OpenAI API Key(也可换成其他兼容的多模态模型)
- macOS 用户需在系统设置中授予终端「屏幕录制」和「辅助功能」权限
- 可正常显示的桌面环境(程序会截屏并控制鼠标键盘)
安装与启动步骤
-
1确认 Python 环境
项目为 Python 包,需先确认本机已装好 Python 与 pip,并能正常执行 pip 命令。
python --version pip --version -
2安装项目
用 pip 直接安装 self-operating-computer,安装完成后会提供 operate 命令。
pip install self-operating-computer -
3启动程序
在终端执行 operate 启动,程序会接管屏幕并等待你输入密钥与任务目标。
operate -
4输入 OpenAI Key
启动后按提示填入 OpenAI API Key;README 说明没有密钥可在 OpenAI 平台申请。
-
5更换已保存的密钥
密钥保存在项目目录的 .env 文件中,后续需要更换时用 vim 打开并替换旧值。
vim .env -
6macOS 授予权限
在「系统偏好设置 → 安全性与隐私」中,为终端应用勾选「屏幕录制」与「辅助功能」。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env 中的 API Key 项 | 是 | 程序调用多模态模型时使用的密钥,首次运行按提示输入并写入 .env | sk-xxxxxxxxxxxxxxxx |
如何确认成功
执行 operate 后终端出现输入 OpenAI Key 的提示,且无报错,说明程序已正常启动。
常见问题
Q:执行 operate 提示命令不存在怎么办?
A:说明安装未成功或脚本目录不在 PATH 中,重新执行 pip install self-operating-computer 并检查 pip 的脚本目录是否已加入环境变量。
Q:之后想换 API Key 怎么改?
A:在终端运行 vim .env,把旧的密钥替换成新密钥保存即可,无需重新安装。
Q:macOS 上程序无法截屏或控制鼠标键盘?
A:到「系统偏好设置 → 安全性与隐私」中,为终端应用开启「屏幕录制」和「辅助功能」权限,然后重启终端。
Q:支持哪些多模态模型?
A:README 列出已集成 GPT-4o、GPT-4.1、o1、Gemini Pro Vision、Claude 3、Qwen-VL 和 LLaVa,后续还会扩展。
注意事项
- 程序会真实操作当前桌面,首次运行前建议关闭无关窗口并保存重要文件。
- 缺少可用的模型 API Key 时程序无法完成识别与操作。
- macOS 未授予屏幕录制和辅助功能权限时,截屏与鼠标键盘动作会失败。
核心亮点
- 用截图加视觉模型驱动操作,不依赖固定坐标,界面变化时适应性更好
- 基于 pyautogui 实现鼠标键盘控制,接入成本低,可直接在真实桌面运行
- 代码结构轻量清晰,便于替换模型和扩展动作空间,适合做智能体原型
不足之处
- 依赖多模态模型逐步推理,任务执行速度慢且 token 成本较高
- 复杂界面下点击定位和长流程任务稳定性有限,需要人工监督
适用场景
- 用自然语言让智能体完成跨应用的重复性桌面操作
- 验证多模态模型在真实图形界面中的操作与规划能力
- 为内部自动化工具快速搭建桌面智能体原型
替代项目
Open Interpreter、AutoGPT、Browser Use
上一篇:lever
下一篇:没有了!
同类项目推荐
wemac
开源
Mac 上即装即用的微信群聊机器人,自动回复不封号
一个 it just works 的 Mac 版微信 RPA 群聊机器人
page-agent
开源
用大白话指挥网页干活,省去写脚本的麻烦。
JavaScript in-page GUI agent. Control web interfaces with natural language.
ovobrowser
开源
源码级改 Chromium,让自动化浏览器被当成真 Chrome。
源码级 Chromium 指纹内核,检测站按普通 Chrome 评分。Source-level Chromium fingerprin···
browser-use
开源
AI 替你在网上跑腿,填表下单全包圆
Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth br···
FLUJO
开源
拖拽编排多模型 Agent 工作流,让自动化任务自己跑起来
Multi-Agent + Automation Harness: Graph-based Workflows, MCP, Self-Improving Agents.···
invisible_playwright
开源
让 Playwright 隐身,轻松绕过反爬和验证码
Playwright that anti-bots cannot see, so no captchas: same API, anti-detect stealth ···
onefilellm
开源
一键抓取代码、论文、视频字幕,生成干净文本喂给LLM
Specify a github or local repo, github pull request, arXiv or Sci-Hub paper, Youtub···
ClaudeCodeBrowser
开源
让 Claude Code 直接开 Firefox 点页面、填表单、截图看结果
MCP Firefox browser automation extension for Claude Code - screenshots, clicking, ty···
camofox-mcp
开源
让 AI 代理隐身浏览网页,告别验证码和封禁
Anti-detection browser MCP server for AI agents — navigate, interact, and automate ···
