omnigent-ai/omnigent

Omnigent – AI代理人的元框架

是什麼 – Omnigent 是一個開源的編排層，可讓您在單一 CLI（omnigent / omni）與基於 Web 的 UI（亦封裝為原生 macOS 桌面應用）中執行、組合與管理多種不同的程式碼生成或聊天代理（Claude Code、Codex、Cursor、OpenCode、Hermes、Pi，以及您以 YAML 描述的任何自訂代理）。它支援在裝置與雲端沙箱之間執行、組合與管理這些代理，並內建協作與策略功能。

核心功能

• 多代理會話 – 在同一聊天中啟動多個代理，讓一個代理審查另一個的輸出，或根據各代理在不同子任務上的專長來分配任務。
• 模型無關 – 支援 API 金鑰、訂閱 CLI，或任何 OpenAI/Anthropic 相容的網關（OpenRouter、Ollama、LiteLLM、Azure 等），甚至支援 Databricks 工作區。
• 雲端沙箱執行 – 會話可在 Modal、Daytona、Blaxel、E2B、Kubernetes、NVIDIA OpenShell、Boxlite 等服務提供的暫時性沙箱中執行，無需高階本地機器。
• 策略與治理 – 可在伺服器、代理或聊天層級定義策略，暫停高風險操作、限制支出或限制工具使用。
• 協作 – 與團隊成員共享即時會話 URL；他們可以觀看代理行為、接管控制權或分叉對話。透過簡單的認證開關支援多使用者帳戶。
• 跨裝置連續性 – 在終端機開始聊天，繼續在瀏覽器中進行，再在手機上接續；所有訊息、檔案和子代理均保持同步。
• 可擴展的框架 – 系統內建主要代理的框架，並可透過 SDK 或在 YAML 中描述 ACP 相容命令來新增自訂框架。

典型工作流程

1. 安裝 – 一行指令即可安裝 Python 套件、所需工具（uv、git、Node、tmux 等）和可選擴充（模型或沙箱提供者）。
2. 啟動會話 – omnigent 啟動本機伺服器，在 http://localhost:6767 開啟 UI，並啟動預設代理（或特定代理如 omnigent claude）。
3. 選擇模型 – omnigent setup 可新增 API 金鑰、訂閱資訊或網關 URL，並為每個代理設定預設值。
4. 執行代理 – 使用內建範例（polly、debby、deep-research）或透過 omnigent run <path> 執行您自己的 YAML 定義代理。您亦可透過 /model 命令在聊天中切換模型。
5. 部署 – 一條 docker compose up 命令（或在 Render、Railway、Fly.io、Cloudflare 等平台一鍵部署）即可公開運行伺服器，支援手機存取與托管雲端沙箱。
6. 協作 – 啟用多使用者模式，邀請團隊成員，共同在同個會話中工作。

適用對象 – 希望使用統一介面來試驗多種基於 LLM 的程式碼生成或推理代理、強制安全策略，並在不為每個提供者重寫整合程式碼的情況下共享工作的開發者、資料科學家或團隊。

狀態 – 早期 Alpha 版（v0.x），但持續維護中，提供公開 Discord 用於社群支援。