Oya Browser

面向受监管行业的浏览器（社区版）。

人类与 AI Agent 在同一个浏览器中协作，并可控制浏览器的运行位置和治理方式。

下载 Oya Browser · 开始使用云端服务 · 自托管 Oya · 企业用户请联系 [email protected]

_{Oya 桌面应用中的一次运行，已加速播放。门户和患者数据均为虚构内容。观看运行 1 · 运行 2 · 运行 3。}

此代码库包含 Oya Browser 社区版。人类与 AI Agent 在同一个浏览器中协作：Agent 可以使用已登录的现有浏览器、启动托管云端浏览器，或通过熟悉的工具和 API 进行连接。人们可以查看操作过程，在需要时介入，并掌控浏览器访问权限和可重复执行的任务。

企业版（包括符合 HIPAA 要求的版本）由单独的私有代码库维护。如需了解该版本，请联系 [email protected]。

选择开始方式

将 Oya 与 AI 助手搭配使用

安装桌面应用，登录，然后从应用中连接你的助手。Oya 支持 Claude Code、Codex、Cursor 和 VS Code。人们可以查看 Agent 的浏览器活动，并在任务需要人工关注时接管控制。

下载桌面应用 · Agent 设置指南

从 Node.js 控制浏览器

安装 SDK 并在 oyabrowser.com 创建 API 密钥。需要 Node.js 20 或更高版本。

npm install @oya-ai/browser

设置 OYA_API_KEY，然后运行：

import { Oya } from '@oya-ai/browser';

const oya = new Oya();
const browser = await oya.browser.start();

try {
  await browser.goto('https://news.ycombinator.com');
  console.log(await browser.ask('Summarize the top three stories.'));
} finally {
  await browser.stop();
}

如果未配置浏览器提供方，start() 可以使用已连接到你账户的 Oya 桌面浏览器。要启动云端或自托管浏览器，请使用 npx @oya-ai/cli init 配置提供方。SDK 和 CLI 还可搭配 Browserbase、Steel、Anchor、Browser Use 或你提供的浏览器使用。更换提供方时，你的应用可以继续使用相同的 SDK 调用。

SDK 指南 · 可运行示例 · CLI 指南

通过 MCP 连接

对于支持远程 MCP 的助手，请连接到 https://oyabrowser.com/mcp/pool，并使用你的 Oya API 密钥进行身份验证。Claude Code 的配置方式：

claude mcp add --transport http oya https://oyabrowser.com/mcp/pool \
  --header "Authorization: Bearer $OYA_API_KEY"

自行部署时，请将同一端点与自托管服务 URL 搭配使用。

Agent 指令和 MCP 参考

面向 AI Agent

请参阅 Agent 参考，了解设置说明、可用工具、SDK 示例和 MCP 配置。桌面应用可与 Claude Code、Codex、Cursor 和 VS Code 配对使用。对于远程 MCP 客户端，请使用你的 Oya API 密钥连接到 https://oyabrowser.com/mcp/pool。

在你自己的环境中运行 Oya

使用安装程序设置可自托管实例：

curl -fsSL https://raw.githubusercontent.com/OyadotAI/oya-browser/main/install.sh | sh

用于生产环境时，可选择 Docker、Amazon ECS、Kubernetes 或 GKE。部署指南涵盖配置、存储、升级和运维。

自托管指南 · 部署模板

使用 Oya 可以做什么

• 在已登录的浏览器中工作。 连接桌面应用，并复用从 Chrome、Arc、Brave、Edge 或 Firefox 导入的登录信息。设置登录信息。
• 让人始终掌控全局。 观察 Agent 工作，在 AI Mode 和 Human Mode 之间切换，并让 Agent 活动保留在独立标签页中。
• 将成功运行的任务变成操作手册。 使用新的输入重放可重复执行的任务，检查生成的 Playwright 模块，并导出或导入工作流。 操作手册详情 · 重放基准测试。
• 选择浏览器的运行位置。 使用 Oya Cloud、自有部署、受支持的浏览器提供商，或你提供的浏览器。为何通过 Oya 路由？。
• 通过治理控制进行运维。 可自托管的社区版部署包含主机出站规则和防篡改审计跟踪。请参阅控制措施证据和信任中心。

面向贡献者

Oya 由浏览器、控制平面、控制台、SDK 和 CLI 组成。请先查看架构图，然后阅读你计划修改部分的指南。

• 架构概览
• 开发环境设置和命令
• 未解决的问题
• 在 Discord 加入社区

开发

不同项目区域的要求和命令有所不同。请参阅在此代码库中工作，了解规范和完整命令列表。要安装整个工作区的依赖项：

npm run setup

常用检查：

npm run lint
npm run format:check
npm test

完整测试命令会构建 SDK，并运行服务端、CLI、软件包和脚本测试套件。对于 UI 或浏览器应用的更改，还请运行对应部分的 package.json 和架构指南中列出的检查。

软件包和项目区域

路径	内容
packages/sdk	@oya-ai/browser，TypeScript SDK（MIT）
packages/cli	@oya-ai/cli，设置和命令行工具（MIT）
browser	Oya 桌面浏览器和云浏览器镜像
server	API、浏览器连接、MCP 和控制平面
ui	Web 控制台和公共网站
examples	SDK 和浏览器集成示例
docs	运维指南和产品详情

许可证

SDK 和 CLI 采用 MIT 许可证。项目其余部分依据 Sustainable Use License 提供。有关允许的用途、自托管条款和商业许可详情，请参阅 LICENSE.md。