OpenMuse 今日登顶 TypeScript 仓库榜首

一个拥有浏览器、终端和文件支持的个人智能体 说出你想要的结果，审阅执行计划，回头查看结果即可 支持 iOS、Android 和 Web 平台 MIT 许可证，克隆项目并一键部署到 Render 一个完全属于你、可自由定制的个人智能体。 https://github.com/CopilotKit/OpenMuse…

CopilotKit/OpenMuse

来源：https://github.com/CopilotKit/OpenMuse

OpenMuse

一个拥有浏览器、终端、文件，且工作不中断的个人智能体。兼容任意智能体框架。

说出你想要的结果。审阅计划、查看操作，然后回来查看结果。 基于 CopilotKit React Native 构建，支持 iOS、Android 和 Web。

快速开始 · 演示 · 功能 · 架构 · 文档 · 贡献指南

CI (https://github.com/CopilotKit/OpenMuse/actions/workflows/ci.yml) MIT 许可证 部署到 Render 克隆此模板，按你的需求任意定制。

基于 OpenMuse 构建？与 CopilotKit 团队交流 → (https://www.copilotkit.ai/talk-to-an-engineer?ref=openmuse_hero)

https://github.com/user-attachments/assets/8014d185-346c-4954-8ff0-26c582c5093a https://github.com/user-attachments/assets/0cc87de0-c3c1-4f24-b7df-e7d04bb946fd

Alpha 版，面向自托管和二次开发。 开放式推理、实时 Google 账号以及 CopilotKit Rich Threads 需要各自单独配置。请参阅已验证功能和路线图。

演示

在 iPhone 上，让 OpenMuse 寻找 Hacker News 上的有趣新闻并总结 CopilotKit。 在桌面端，让它查看学校旅行邮件、打开邮件内容，并调研蒙特雷湾水族馆的展品。 智能体会在界面中内联展示邮件和浏览器结果。接管控制按钮可在你需要时打开同一个浏览器会话。

38 秒的 iPhone 演示和 42 秒的桌面 Web 演示展示的是当前界面，以 16:9 比例呈现。 在智能体回复期间，输入框内的发送箭头会变为停止方块，回复结束后恢复。 停止时不会丢失你输入的草稿内容。

参阅录制说明了解模型配置和复现步骤。

移动端 MP4 (https://github.com/user-attachments/assets/8014d185-346c-4954-8ff0-26c582c5093a) · Web MP4 (https://github.com/user-attachments/assets/0cc87de0-c3c1-4f24-b7df-e7d04bb946fd) · 录制详情与复现

Jev 水族馆之旅演示展示了一封虚构的学校邮件、澄清选项、带来源的展品卡片、动手偏好细化以及最终确认的完整流程。 观看 83 秒的 Jev 实时录制，其中 TypeSafe Jev 负责做决策，脚本化智能体使旅行场景可重复执行。 另有一份脚本化决策示例录制可供查看。

这是什么

OpenMuse 是一个个人智能体应用，拥有智能体计算机、可视化工作过程和丰富的结果展示。 它运行自己的服务器、任务工作进程和浏览器工作进程。 你可以根据 MIT 许可证查看和修改源代码。

这台计算机由持久化的 Chromium 浏览器和可选的 Linux 工作区组成。 智能体可以浏览公开页面、在其独立容器中运行命令、处理文件，并在计算机与应用之间传输 PDF。 你可以打开它的浏览器或终端，继续它的工作。 图形桌面和自主结账仍是未来的工作方向。

功能

功能清单描述了已实现的能力和计划中的扩展。 健康/银行/社交连接器、设备推送、语音、生成式可执行工具以及自动预订/支付都在路线图上。

快速开始

前置要求： Node 24 LTS、pnpm 11.19.0，以及一个 CopilotKit Intelligence 项目密钥。 本地示例应用无需模型、Google 账号或 Docker。

git clone https://github.com/CopilotKit/OpenMuse.git openmuse
cd openmuse
pnpm install --frozen-lockfile
cp .env.example .env
npx copilotkit@latest login
npx copilotkit@latest project select
# 将 .env 中的 CPK_INTELLIGENCE_API_KEY 设置为生成的仅限服务端项目密钥。
# 保留 CLI 生成的 CPK_TELEMETRY_ID，包括在部署的服务器环境中。
pnpm dev

在另一个终端中：

pnpm dev:web

打开 localhost:8081 (http://localhost:8081)。 API 运行在 localhost:8787/api/health (http://localhost:8787/api/health)。

试试看

1. 在聊天中发送 “Complete the permission slip”。打开任务，填写虚构的表单值，查看保存的 PDF，并审阅准备好的回复。此操作仅写入本地邮箱。
2. 在 Goals → Track 中，创建一个内置的可用性监控，然后修改内置测试页面以触发告警。
3. 在 Menu → Delegate task → Finance 中，使用 Try example transactions 创建一个交互式支出追踪器。
4. 启动浏览器工作进程并配置模型，然后询问 “Check out Hacker News for cool stuff” 或 “Summarize copilotkit.ai”。内联跟进浏览器操作，并使用 Take control 打开它的会话。

如需无模型版本的此流程，请按照 AI Mock 演示设置操作。

对于 iOS 或 Android，使用 pnpm --dir apps/mobile ios 或 pnpm --dir apps/mobile android。需要 Xcode 或 Android 工具链。 PDF 阅读器需要 Expo 开发构建版本，请参阅原生设置。

在 Render 上部署

部署到 Render

render.yaml 部署三个服务：API、Web 应用和一个私有浏览器。 API 以 JSON 响应 /，因此 UI 是一个独立的静态站点。

首次运行

1. 点击 Deploy to Render。等待 openmuse-api、openmuse-web 和 openmuse-browser 全部上线。
2. 在 openmuse-api 上，打开 Environment 并复制 OPENMUSE_ACCESS_KEY。
3. 打开 openmuse-web 的 URL，使用该密钥登录。
4. 发送一条消息。

部署表单会要求你提供三个值。Render 生成另外两个。

健康检查地址：https://<your-api-host>/api/health。

服务

Standard 是能保持运行的最小计划。在 512 MB 下，进程会在绑定端口前耗尽内存，因为 PGlite 会加载一个嵌入式 Postgres 构建。 磁盘用于存放数据库、PDF 和签名密钥。不挂载磁盘重新部署会清空这些数据。聊天会话由 CopilotKit Intelligence 存储，因此即使磁盘从未挂载过，重新登录后仍可加载会话。

必须使用实时模式。 Render 绑定 0.0.0.0，而示例模式会拒绝非回环地址的任何主机。蓝图设置了 WORKSPACE_MODE=live。

浏览功能已内置，也可以移除。 openmuse-browser 是私有服务，没有公开 URL。API 通过 Render 生成的令牌以 http://openmuse-browser:8790 访问它。如果私有主机名不是 openmuse-browser，请将 BROWSER_WORKER_URL 设置为 http://<主机名>:8790。

如需不带浏览功能部署，请删除 openmuse-browser 服务以及 openmuse-api 上的 BROWSER_WORKER_URL 和 WORKER_TOKEN 配置。 聊天、草稿和任务仍可运行。页面读取、截图和接管控制将不可用。

Docker 计算机和 Google 邮件或日历需要按以下章节进行配置。此蓝图不会启动它们。

配置智能体和 Google

将 .env.example 中的注释配置复制到你的私有 .env：

1. 设置 AGENT_BACKEND=model、MODEL=provider/model-id 以及对应的提供商密钥。CopilotKit 支持已配置的 OpenAI、Anthropic 或 Google 提供商。虚构数据也可与真实模型搭配使用。提供商密钥仅保存在服务器上。
2. 使用 npx copilotkit@latest login 和 npx copilotkit@latest project select 创建或选择 CopilotKit Intelligence 项目。将生成的 CPK_INTELLIGENCE_API_KEY 保存在服务器上。
3. 对于个人邮件/日历，设置 WORKSPACE_MODE=live、生成的 CPK_INTELLIGENCE_API_KEY、一个至少 24 字符的随机 OPENMUSE_ACCESS_KEY，以及包含 32 个随机字节的 base64 编码的 TOKEN_ENCRYPTION_KEY。重启 API。
4. 配置启用了 Gmail 和 Calendar API 的 Google OAuth Web 客户端。设置 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET；将 ${PUBLIC_API_URL}/api/google/callback 注册为其重定向 URI。在你的 Google 项目中配置同意屏幕/测试用户访问权限。
5. 打开 Apps → Gmail（或 Google Calendar），连接读取权限，必要时授予写入权限。 每次发送或日历更改仍需要各自的存储审阅。修改/断开账号会使待处理的关联工作失效。Google 凭据以加密形式存储。文件 URL 和浏览器控制台使用短期签名。

此部署使用由共享访问密钥保护的单一所有者模式；它不是多租户身份认证系统。远程主机请使用 HTTPS 和受限网络访问。本地数据模式请保持回环地址绑定。

公开网页搜索

网页搜索默认启用。在 API 和独立任务工作进程上设置 WEB_SEARCH_ENABLED=false 可禁用此功能。 配置模型后，委派任务和内置模型聊天（AGENT_BACKEND=model）使用 Parallel 的免费无密钥 Search MCP 作为内置搜索提供商。 例如，可以询问“查找 CopilotKit React Native 的官方安装说明并引用来源“。 结果包含来源 URL 和摘要；委派任务会将它们保存为证据。 脚本化示例聊天和外部 AG-UI 对话保留其现有工具。 搜索会将模型生成的查询和上下文（可能包含来自你的对话或任务的信息）以及随机的每聊天/任务会话标识符发送给 Parallel。详见 Parallel 隐私政策。 免费访问有速率限制；失败时会如实报告，不会自动切换到付费方案。 停止聊天或中断任务会取消其搜索。

浏览器工作进程

在 .env 中设置 BROWSER_WORKER_URL=http://127.0.0.1:8790 和一个至少 32 字符的随机 WORKER_TOKEN。

pnpm --dir apps/worker exec playwright install chromium
pnpm dev:browser

或使用 docker compose --env-file .env -f infra/compose.yaml up --build -d。

API 和工作进程必须使用相同的令牌。 会话拥有持久化的 Chromium 配置；应用可以打开实时截图控制台并导入 PDF 下载。 智能体工具可以读取公开页面，并将交互式工作交给人处理。 工作进程设置与限制。

持久化与运维

Linux 终端和工作区

构建计算机镜像，在 API 上启用它，然后打开 Computer → Terminal → Start computer：

docker build -t openmuse-computer:local apps/computer
COMPUTER_ENABLED=true pnpm dev

API 需要访问 Docker CLI 和引擎。 命令在非 root 容器中运行，不挂载宿主目录，也不使用凭据。 命名的 /workspace 卷可在停止后保留文件。 终端网络已禁用；公网访问使用浏览器工作进程。 命令有 30 秒的时间限制，并保存输出/退出回执。

文件支持文件夹、文本编辑和与文档模块之间的 PDF 传输。 这是一个 Linux 容器，不是完整的操作系统虚拟机。 设置、Colima 选项和限制。

应用存储

默认情况下，嵌入式 PGlite、文档和签名密钥存放在 .openmuse/；浏览器配置存放在 .openmuse/browser-profiles/。 请将该目录设为私有并做好备份。

API 托管任务工作进程。宿主必须保持运行以支持后台工作。

如需独立的任务工作进程，请为两个进程配置相同的 DATABASE_URL、密钥和共享的 DATA_DIR，然后在 API 上设置 TASK_WORKER_ENABLED=false 并运行 pnpm dev:worker。 PGlite 不能被独立进程同时打开。

生产环境命令为 pnpm build:server、pnpm start 和 pnpm start:worker。 只运行一个 API 实例；任务工作进程通过 SQL 租约协调。 在不确定的外部写入之后不会发生隐式重试。在创建替代方案之前，请先审阅其提供商的结果。 暂停/取消会阻止后续任务步骤；已批准的在途提供商请求可能仍会完成。

CopilotKit Rich Threads

每次部署都需要在 API 服务器上配置 CPK_INTELLIGENCE_API_KEY，以实现 CopilotKit Intelligence 的对话持久化和回放。 使用 npx copilotkit@latest login 和 npx copilotkit@latest project select 创建或选择项目，设置生成的仅限服务端的密钥，然后重启 API。

原生菜单使用 useThreads；富文本工具结果会链接到已保存的任务、文档和浏览器会话。 Intelligence 是一个独立服务，不包含在本仓库的 MIT 许可证中。 本仓库不附带项目密钥。 配置和验证限制。

注册与运行时追踪

CopilotKit SDK 通过共享的 CopilotKit 上报通道向 PostHog 发送运行时遥测数据，并携带 accessibility_title: "OpenMuse" 标识。遥