orkbot-run/ork

项目介绍

Ork 是一个源码可见的 AI 助手，核心是持久存在的机器人：它们共享对话，并运行在相互隔离的计算机里。一个仓库同时包含 Web 应用、API、worker、Tauri 桌面客户端和 Expo 移动客户端，后端使用 PostgreSQL。它面向希望自己托管整套助手服务、而不是依赖厂商托管方案的用户。

通过本地构建的沙箱镜像，机器人可以使用基于 Docker 的"计算机"，在隔离环境中执行工作，而不是直接操作宿主机。

本地运行

准备 Node.js（22.x 中 22.22.2 以上，或 24/26+）、Docker 和 Corepack；仓库通过 Corepack 固定 pnpm 9.15.0。在仓库根目录执行：

corepack pnpm install --frozen-lockfile
corepack pnpm setup:local
corepack pnpm db:up
corepack pnpm dev

setup 步骤会生成 .env，其中包含随机数据库密码以及独立的加密、认证、supervisor 和 screen-proxy 密钥。启动 API 前需要注册 Accounts 公有客户端，并把 OIDC_CLIENT_ID 写入 .env；本地回调地址是 http://127.0.0.1/callback，开发端口在运行时分配。登录细节见 Accounts sign-in。

迁移完成后打开终端打印的开发地址，通常是 http://127.0.0.1:5173，通过 Ork Accounts 登录。仅打开应用不需要模型密钥。要让机器人拥有自己的 Docker 计算机，先构建一次沙箱镜像：

corepack pnpm sandbox:build

PostgreSQL 运行在 ork Compose 项目下，只绑定回环地址 127.0.0.1:5433。若该端口被占用，需同时修改 .env 中的 POSTGRES_HOST_PORT 和两个数据库 URL。停止数据库用 corepack pnpm db:stop，数据会保留。

仓库还列出了检查命令：

corepack pnpm db:generate
corepack pnpm lint
corepack pnpm check
corepack pnpm test
corepack pnpm --filter @orkbot/web build

生产备份测试依赖 flock、GNU find 等 Linux 工具和 Bash 5。更完整的安装与功能说明见 README.reference.md。

使用约束

• 工作副本要求 origin 指向 orkbot-run/ork，upstream 指向原始 Rakazo 仓库；在 origin/main 分支出现之前，开发脚本以 upstream/main 作为迁移基线。
• .env 含加密和认证密钥，需妥善保密；重复执行 setup 会保留已有文件。
• 签名发布、应用商店提交、镜像发布、OTA 和部署都需要各自的凭据，见 GitHub Actions 配置。
• 许可证是分开的：继承自 Rakazo 的 Apache 2.0 部分保持 Apache 2.0，Ork 新增部分采用 PolyForm Noncommercial 1.0.0。自托管仅在 PolyForm 允许的用途下免费；营利性企业的内部使用需要商业许可，除非 PolyForm 或法律另有允许。合并后的产品属于源码可见，不是 OSI 开源。具体条款见许可证映射、FAQ 以及尚待法务审查的商业协议草案。

HotRepo 点评

Ork 于 2026-11-06 进入 HotRepo 新项目榜：在 04:45–09:45 UTC 约五小时的统计窗口内增加 31 Star，达到 134 Star，但全部语言日榜暂无排名记录。对一个创建仅数天的项目来说这算早期关注，Star 曲线太短，无法判断热度能否持续。对读者更关键的是许可结构：一个标为 source-available 的自托管助手，新增部分并非 OSI 开源，部分商业使用需要商业许可。评估时应以这一点为准，而不是星数。