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 與可匯出程式碼。