
源码系统概览
文章正文
Omnigent 是一套开源的 AI agent 编排框架源码。
它提供统一的元层来管理 Claude Code、Codex、Cursor 等多种 AI agent。
用户可以在不同 harness 之间切换而无需重写代码。
该项目在 GitHub 上获得 9300 star 和 1400 fork。
系统支持 Modal、Daytona、E2B 等多种云沙箱运行环境。
源码简介
Omnigent 是一个开源的 meta-harness 框架,支持多 agent 协作和实时同步。
用户可以从终端、浏览器或手机端访问同一会话,实现跨设备无缝切换。
框架支持策略管控、审批流程、预算控制和工具限制等企业级功能。
沙箱隔离机制确保 agent 在安全环境中运行,支持云沙箱和本地沙箱模式。
许可证为 Apache-2.0,欢迎社区贡献 star 和 fork。
核心技术栈包括 Python 3.12、Node.js 22、tmux 和 pnpm 包管理器。
项目版本 v1.2.0,最后更新 2026 年,更新日志见 CHANGELOG.md。
适用场景
适用于需要多 AI agent 协同工作的开发团队。
支持从终端到浏览器的跨设备无缝切换场景。
适合需要策略管控和审批流程的企业级 AI 部署。
可用于云沙箱中运行隔离的 agent 会话场景。
也适合用于企业内部多模型统一管理和成本控制场景。
技术栈与运行环境
核心语言为 Python 3.12 和 TypeScript。
前端使用 React 和 pnpm 构建 Web UI 界面。
依赖 tmux 实现原生终端 wrapper 功能。
支持 Docker、Railway、Render 等多种部署方式。
当前版本 v1.2.0,最后更新 2026 年。
后端使用 FastAPI 提供 REST API 接口,数据层采用 SQLite 存储会话状态。
功能亮点
- 多 agent 编排:同时管理 Claude Code、Codex、Cursor 等多种 agent
- 跨设备同步:终端、浏览器、手机端共享同一会话
- 策略管控:支持审批、预算控制和工具限制
- 云沙箱:支持 Modal、Daytona、E2B 等多种云运行环境
- 团队协作:支持会话共享和 co-drive 协同模式
系统还支持会话标签分类和批量会话管理功能,方便用户组织不同项目。
技术架构与部署指南
安装与部署提示
使用 curl 一键安装脚本完成部署。
也可通过 uv tool install omnigent 手动安装。
macOS 可使用 Homebrew 安装。
Windows 原生支持降级模式运行。
更新日志见 CHANGELOG.md,版本号 v1.2.0。
配置文件位于 ~/.omnigent/config.yaml,支持环境变量覆盖默认值。
截图与演示说明
封面展示了 Omnigent 桌面应用的多 agent 会话管理界面。
界面提供 agent 列表、会话历史、实时输出和策略配置功能。
Web UI 在 localhost:6767 端口运行,支持手机浏览器访问。
桌面应用支持 macOS 原生通知和 dock 角标功能,实时推送 agent 状态。
用户可在画布中查看 agent 之间的协作关系和任务流转情况。
管理面板提供预算消耗统计和工具使用频率分析。
竞品对比
| 特性 | Omnigent | CREWAIRI | AutoGen |
|---|---|---|---|
| 定位 | meta-harness编排 | agent框架 | 多agent对话 |
| agent管理 | 编排已有agent | 需写Python代码 | 需写Python代码 |
| 跨设备同步 | 终端浏览器手机 | 不支持 | 不支持 |
| 策略管控 | 审批和预算控制 | 无 | 无 |
| 许可证 | Apache-2.0 | MIT | MIT |
下表是本系统与主流竞品的核心特性和区别对比。
常见问题
问,Omnigent 和 CrewAI 有什么区别?
区别在于 Omnigent 是 meta-harness,编排已有 agent 而非创建新 agent,而 CREWAIRI 需要编写 Python 代码。
问,支持哪些 AI agent?
支持 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 等多种 agent。
问,是否需要 API key?
支持 API key、订阅账号和 Gateway 网关三种凭据方式。
问,如何在 CI/CD 中使用?
通过 omnigent start 启动服务器,注册主机后即可远程访问。
安全风险提示
框架涉及 shell 命令执行和文件编辑操作。
建议配置策略管控进行高风险操作审批。
Linux 环境建议启用 bwrap 沙箱隔离。
API key 存储在本地,注意环境变量安全。
Docker 部署时需配置 OMNIGENT_AUTH_ENABLED 认证。
下载说明
源码已从 GitHub 下载并打包为 zip 压缩包。
百度网盘和蓝奏云提供双链下载,提取码 8888。
解压后可本地部署或通过 Docker 运行。
包含完整源码、文档和部署配置文件。
GitHub项目开源地址,https://github.com/omnigent-ai/omnigent