OpenAdapt

录一遍 GUI 操作，生成可靠本地自动化程序

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 280 🐛 待处理 202 👀 关注 13

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1869

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队OpenAdaptAI

官网地址https://openadapt.ai

GitHubhttps://github.com/OpenAdaptAI/OpenAdapt

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-harness,ai-agents,browser-automation,citrix,computer-use-agents,demonstration-compiler,desktop-automation,deterministic-replay,effect-verification,gui-automation,healthcare-automation,human-in-the-loop,local-first,mcp,rdp,rpa,self-healing-automation,ui-automation,workflow-automation,workflow-compiler

GitHub 星标★ 1869

上线时间2023-04-12 00:00:00

代码更新2026-11-09

仓库体积192.1 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数3

项目介绍

OpenAdapt 是一个将 GUI 操作演示编译为确定性本地程序的智能体工具。它通过记录用户的操作流程，将其转化为可重复执行的自动化脚本，解决传统 RPA 脚本脆弱、难以维护的问题。核心能力包括：零模型调用的健康运行、受控修复机制、以及遇到不确定情况时主动暂停而非猜测。它支持桌面应用、浏览器及 Citrix 等虚拟环境，并提供 OpenAdapt-flow 启动器，便于集成。该项目旨在降低自动化门槛，提高流程执行的可靠性和可解释性，适合需要稳定 GUI 自动化的场景。

Star 增长趋势

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

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1869

技术标签

agent-harness ai-agents browser-automation desktop-automation human-in-the-loop

使用教程

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

环境要求

Python 3.10 至 3.12
首次浏览器操作需要网络访问，用于让 Playwright 下载匹配的 Chromium
基础安装已自带 Playwright 与 openadapt-agent，无需额外装运行时
最小化 Linux 主机需能安装 Chromium 共享库（可能要求管理员权限）

安装与启动步骤

1安装 OpenAdapt

用 pip 安装并升级 openadapt，基础包已包含 Playwright 与 openadapt-agent。
```
python -m pip install --upgrade openadapt
```
2运行环境自检

doctor 会在浏览器下载前列出缺失的 Chromium 共享库，先看结果再继续。
```
openadapt doctor --backend web
```
3补装浏览器依赖

仅当 doctor 报缺库时执行；装完再跑一次 doctor 确认通过。
```
python -m playwright install-deps chromium
openadapt doctor --backend web
```
4跑本地教程

在合成 MockMed 上录制、编译、认证并执行，无需账号或 API key，最后给出 VERIFIED 收据。
```
openadapt flow tutorial
```
5验证拒绝误报

界面已显示成功但后端拒绝写入，独立读取记录存储后运行仍会 halt。
```
openadapt quickstart --break-it
```
6启动运行服务

常驻服务，调用方智能体调用 run_local_quickstart 拿收据，看不到任何画面帧。
```
openadapt-agent serve --allow-run
```

7查看编译产物

可视化编译出的 bundle 并做 lint，检查这份流程编译了什么、漏了什么。

openadapt flow visualize tutorials/tutorial-20260828T041000Z/bundle --out graph.html
openadapt flow lint tutorials/tutorial-20260828T041000Z/bundle

关键配置

配置项	必填	说明	示例
`--backend`	否	doctor 自检时指定的后端类型，浏览器场景填 web	`web`
`--allow-run`	否	允许 openadapt-agent 服务接受本地运行请求	`--allow-run`
`--break-it`	否	quickstart 的故障注入开关，用于验证独立读取会阻止误报成功	`--break-it`
`--out`	否	flow visualize 输出的可视化文件路径	`graph.html`

如何确认成功

终端打印 VERIFIED: <out>/run/REPORT.md，并显示 profile standard、model calls 0、effects 2/2 confirmed。

常见问题

Q：需要账号或 API key 吗？

A：不需要。本地教程无需账号或 API key，且运行控制回路中不调用生成式模型 API。

Q：报缺少 Chromium 共享库怎么办？

A：先执行 python -m playwright install-deps chromium 补装依赖，再重新运行 openadapt doctor --backend web；包管理器需要时会请求管理员权限。

Q：首次浏览器操作很慢或失败？

A：首次浏览器动作时 OpenAdapt 会让 Playwright 下载匹配的 Chromium 构建，这一步需要可用的网络访问。

Q：教程里的 VERIFIED 代表生产可用吗？

A：不代表。教程 VERIFIED 只是合成 MockMed 上的本地收据，不是生产 Seal；未签名的生产成功应视为失败。

Q：--break-it 为什么是失败结果？

A：这是刻意设计的：后端在应用已画出成功横幅后拒绝写入，屏幕检查全部通过，但独立读取记录存储不一致，因此运行 halt。

注意事项

本仓库只是安装器和 openadapt 命令，编译器与运行时在 openadapt-flow 中，此仓库不重新实现。
教程的录制、编译产物和运行收据默认写在 tutorials/tutorial-<UTC 时间戳> 目录下。
只有 VERIFIED 是生产成功；HALTED_BEFORE_EFFECT、RECONCILIATION_REQUIRED、COMPLETED_UNVERIFIED 等结果互不等价，也绝不能把 halt 当成成功。
修复属于版本化变更，需要评审、按资质契约测试、提升，出错则回滚，而不是允许即兴改动。