rome-os/rome

Rome – 人类与AI代理的「代理操作系统」

是什么 – Rome 是一个开源平台，允许您运行、持久化并组合 AI 代理与自定义「应用」。它将环境（工具、记忆、工作流、UI）视为代理可创建、修改和重用的一等资产。所有能力均以普通源代码（git 跟踪）形式存储，而非隐藏的模型状态，因此即使模型变更也能存活，并可通过应用商店共享。

核心理念

• 受保护的、可自托管环境 – 可在本地（Docker/Electron）或 Rome Cloud 中运行。状态存储在 Docker 卷或本地数据库中；遥测数据为可选。
• Rome Apps – 一个包（app.yaml + 代码），捆绑了专用 UI、持久化数据、动作、代理、技能和钩子。应用是 名词（持久化产品），而工作流是 动词（一次性任务）。
• 动作与能力 – 任何代理、例行程序或应用均可调用的类型化操作。它们受版本控制，可暂停以等待人工审批。
• 模型无关 – 该平台不自带 LLM；您可接入任意偏好的模型。
• 协作 – 人类（守护者）与代理并肩工作；代理甚至能根据自然语言请求为您构建新应用。

如何开始

1. Rome Cloud（预览版） – 访问 https://romeos.cc/login 注册以获取托管实例。
2. Docker 快速启动 – 运行提供的脚本：

   curl -fsSL https://raw.githubusercontent.com/rome-os/rome/main/scripts/quickstart-docker.sh | bash
   

   仪表盘将出现在 http://localhost:7663。
3. 从源码开发 – 需要 Node 24+、pnpm 11.6、Docker-Compose。

   corepack enable
   pnpm install
   pnpm dev:all   # 在本地启动完整堆栈
   

   详见 CLAUDE.md 了解完整开发流程。

典型用例（如 README 所述）

• 代码审查自动化 – “修复所有 P1/P2 审查评论，直到无阻塞项为止。”
• 邮件分类 – 自动排序、归档、标记并草拟回复。
• 价格追踪 – 监控商品价格，低于阈值时通知。
• 客户访谈 – 进行半结构化访谈，提出跟进问题，并总结洞察。

Rome Apps – 构建模块

组件	作用
动作	代理和应用调用的类型化函数。
代理	拥有独立指令和工具的应用所有者协作者。
技能	按需加载的自然语言流程。
钩子	生命周期扩展（消息、事件、回合）。
Web UI 与 API	应用前端和 HTTP 端点。
数据库与文件	持久化、应用私有的状态。

提供两个公开 SDK：

• @rome-os/app-runtime – 动作、代理、持久化的后端部分。
• @rome-os/app-web-sdk – 前端工具和用于构建与打包应用的 CLI。

仓库结构（单体仓库）

• packages/core/ – 核心运行时、会话处理、记忆、策略。
• packages/web/ – 仅守护者使用的仪表盘 UI。
• packages/desktop/ – 用于原生桌面客户端的 Electron 包装器。
• rome_apps/ – 第一方示例应用。
• packages/app-runtime-sdk/ 与 packages/app-web-sdk/ – 公开 SDK。
• docs/ – 概念、架构、愿景与操作文档。

Rome 的定位

平台	持久化内容	重复工作执行方式	主要 UI	托管方式
Rome	动作、技能、应用（git 跟踪）+ 记忆与应用数据	直接调用已保存动作（无需重新运行 LLM）	专用应用 + 聊天频道（Telegram、Discord、WhatsApp）	自托管或 Rome Cloud
Grok Bot (xAI)	每个机器人的记忆与文件	每次运行模型	聊天线程	仅托管
Hermes Agent (Nous)	文本笔记与技能文档	模型或 cron 脚本	聊天客户端 / CLI	自托管
Manus	文件、工具、持久云 VM 上的数据库	模型或计划脚本	聊天 + 生成的 Web 应用	托管（可导出）

Rome 的主张是：通过持久化 软件（动作、应用）而非仅文本，环境会实现复利增长——为一项任务构建的能力，将成为未来任务的可重用构建模块。

文档与社区

• 产品网站： https://romeos.cc/
• 文档： https://romeos.cc/docs/rome 与 https://romeos.cc/docs/building-apps
• 应用商店： https://romeos.cc/store
• 社区： Discord 邀请 (g7EFmEtmqc) 与 X 账号 @RomeAILab

总结 – Rome 是一个真实、积极维护的开源项目，为构建持久、可组合的 AI 代理及其驱动的应用提供了完整堆栈。它面向希望超越单次聊天交互的开发者和高级用户，支持长期工作流、自定义 UI 和可导出代码。