self-operating-computer

让多模态模型看屏幕、动鼠标,替你操作电脑

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 1410 🐛 待处理 110 👀 关注 129
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 10300
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自备OpenAI API密钥

项目预览

self-operating-computer 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队OthersideAI
定价模式🏷️完全免费
价格说明开源免费,需自备OpenAI API密钥
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型automation,openai,pyautogui
GitHub 星标★ 10300
上线时间2023-11-04 00:00:00
代码更新2026-10-19
仓库体积12.6 MB
本站数据更新2026-11-01
维护状态较活跃
收录时间2026-11-01
浏览次数0

项目介绍

self-operating-computer 是一个让多模态大模型直接操作计算机的开源框架。它把屏幕截图交给视觉模型理解,再通过 pyautogui 把模型输出的点击、输入、滚动等动作落到真实桌面,从而完成跨应用的自动化任务。项目解决的是传统 RPA 依赖固定坐标和脚本、难以适应界面变化的问题:用户只需用自然语言描述目标,模型就能观察当前画面并逐步执行操作。核心能力包括屏幕感知、动作规划、鼠标键盘控制、任务循环与失败重试,并支持接入 OpenAI 等兼容接口的多模态模型。代码以 Python 编写,结构轻量,便于二次开发,适合做桌面智能体原型验证和自动化流程探索。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-01 · 当前星标 ★ 10300

技术标签

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 6 步

环境要求

  • Python 环境与 pip 包管理器
  • 一个可用的 OpenAI API Key(也可换成其他兼容的多模态模型)
  • macOS 用户需在系统设置中授予终端「屏幕录制」和「辅助功能」权限
  • 可正常显示的桌面环境(程序会截屏并控制鼠标键盘)

安装与启动步骤

  1. 1确认 Python 环境

    项目为 Python 包,需先确认本机已装好 Python 与 pip,并能正常执行 pip 命令。

    python --version
    pip --version
  2. 2安装项目

    用 pip 直接安装 self-operating-computer,安装完成后会提供 operate 命令。

    pip install self-operating-computer
  3. 3启动程序

    在终端执行 operate 启动,程序会接管屏幕并等待你输入密钥与任务目标。

    operate
  4. 4输入 OpenAI Key

    启动后按提示填入 OpenAI API Key;README 说明没有密钥可在 OpenAI 平台申请。

  5. 5更换已保存的密钥

    密钥保存在项目目录的 .env 文件中,后续需要更换时用 vim 打开并替换旧值。

    vim .env
  6. 6macOS 授予权限

    在「系统偏好设置 → 安全性与隐私」中,为终端应用勾选「屏幕录制」与「辅助功能」。

关键配置

配置项必填说明示例
.env 中的 API Key 项是程序调用多模态模型时使用的密钥,首次运行按提示输入并写入 .envsk-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 群聊机器人

★ 220 2026-08-09
page-agent 开源

用大白话指挥网页干活,省去写脚本的麻烦。

JavaScript in-page GUI agent. Control web interfaces with natural language.

★ 29612 2026-08-09
ovobrowser 开源

源码级改 Chromium,让自动化浏览器被当成真 Chrome。

源码级 Chromium 指纹内核,检测站按普通 Chrome 评分。Source-level Chromium fingerprin···

★ 1048 2026-09-15
browser-use 开源

AI 替你在网上跑腿,填表下单全包圆

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth br···

★ 119628 2026-08-09
FLUJO 开源

拖拽编排多模型 Agent 工作流,让自动化任务自己跑起来

Multi-Agent + Automation Harness: Graph-based Workflows, MCP, Self-Improving Agents.···

★ 669 2026-09-17
invisible_playwright 开源

让 Playwright 隐身,轻松绕过反爬和验证码

Playwright that anti-bots cannot see, so no captchas: same API, anti-detect stealth ···

★ 2542 2026-08-10
onefilellm 开源

一键抓取代码、论文、视频字幕,生成干净文本喂给LLM

Specify a github or local repo, github pull request, arXiv or Sci-Hub paper, Youtub···

★ 2024 2026-08-09
ClaudeCodeBrowser 开源

让 Claude Code 直接开 Firefox 点页面、填表单、截图看结果

MCP Firefox browser automation extension for Claude Code - screenshots, clicking, ty···

★ 117 2026-09-18
camofox-mcp 开源

让 AI 代理隐身浏览网页,告别验证码和封禁

Anti-detection browser MCP server for AI agents — navigate, interact, and automate ···

★ 120 2026-08-09