omnigent 是什么?

Omnigent 是开源的 agent meta-harness:在同一编排层接入 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 和自定义 YAML agent,并把终端、浏览器、手机协作、策略审批与沙箱组合起来。

⭐ 10,738 Stars 🍴 1,733 Forks Python Apache-2.0 作者: omnigent-ai
来源:github.com/omnigent-ai/omnigent 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库没有 Omnigent 自有充值、订阅额度或转售入口;它接入用户已有的模型凭据和第三方沙箱,因此保留。

来源:github.com/omnigent-ai/omnigent

核心功能

多 harness 编排

同一会话可选择或组合 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 及自定义 agent,并支持子代理互审和并行 worktree。

来源:github.com/omnigent-ai/omnigent
跨设备会话

本地 CLI 启动服务器和 Web UI,消息、终端、文件与子代理状态可在浏览器和手机继续查看。

来源:github.com/omnigent-ai/omnigent
策略与沙箱

策略可在风险动作前暂停审批、限制工具或成本;Linux 原生 wrapper 要求 bubblewrap,macOS 使用 seatbelt,Windows 只有降级的 Job Object 隔离。

来源:github.com/omnigent-ai/omnigent

技术架构

Python 服务端维护会话、agent 树、策略和凭据映射,CLI/终端 wrapper 启动具体 harness;Web UI 与客户端通过服务端同步消息、文件和终端。运行端可在本机 OS sandbox,也可通过 Modal、Daytona、E2B、Kubernetes 等第三方 provider 建临时 host。

来源:github.com/omnigent-ai/omnigent

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) uv git tmux(原生终端 wrapper)tmux(原生终端… Linux bubblewrapLinux bubblewr… 模型 provider CLI 或 API key模型 provider… 多 harness 编排 跨设备会话 策略与沙箱 omnigent 项目本体 核心功能 关键依赖

技术栈

语言Python 3.12+;Web UI 还需 Node.js 22+ 与 pnpm框架Starlette/Uvicorn 服务端、CLI 和多 harness adapter
uvgittmux(原生终端 wrapper)Linux bubblewrap模型 provider CLI 或 API key可选云沙箱 provider 凭据
本地 Web UI 默认 localhost:6767;部署可启用多用户认证、OIDC 和远程 host,云沙箱费用与权限由对应 provider 决定
来源:github.com/omnigent-ai/omnigent

快速上手

避免直接管道执行远程脚本,先下载并审查 install_oss.sh,或用 uv tool install omnigent 安装已发布包。运行 omnigent 后先选一个本地 harness,确认 6767 只绑定预期接口;再用 omnigent setup 添加单个 provider 凭据。团队共享、远程部署和 managed sandbox 放到第二阶段。
来源:github.com/omnigent-ai/omnigent

使用场景

适合需要统一管理多个编码 agent、跨设备接续会话或对工具调用增加审批策略的团队。只运行单一 agent、无需远程协作时,额外服务端、凭据映射和 sandbox provider 会增加维护面。

来源:github.com/omnigent-ai/omnigent

优势与局限

优势

  • 同一会话可组合多个主流 harness
  • 本地和远程 host 共用会话层
  • 审批、工具和成本策略集中配置
  • Linux/macOS 原生 wrapper 有明确 OS sandbox 路径

局限

  • 项目处于 Alpha,版本与配置仍快速变化
  • 一键脚本会安装依赖并改 PATH,必须先审查
  • 本地服务可显示终端和文件,开放到 LAN 或公网会扩大暴露面
  • Windows Job Object 不隔离文件系统和网络
  • 第三方模型与沙箱仍各自需要账号、凭据和可能的费用
来源:github.com/omnigent-ai/omnigent

最新版本

截至 2026-09-23,最新公开 release 是 v0.14.0,发布于 2026-09-15;main 已进入 0.16.0.dev0。

来源:github.com/omnigent-ai/omnigent/releases

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、pyproject.toml、部署文档、CHANGELOG 与 GitHub Releases  |  limitations: 未执行安装脚本,未安装包,未启动服务器、harness、Web UI 或 sandbox,也未录入任何模型或云端凭据  |  observed_output: 最新公开 release 为 v0.14.0(2026-09-15);main 的 pyproject 已是 0.16.0.dev0;Python 下限为 3.12,本地 UI 默认端口 6767

来源:github.com/omnigent-ai/omnigent/releases/tag/v0.14.0

同类项目对比

Microsoft AutoGen 提供 AgentChat/Core/Extensions 与 Studio,重点是用 Python/.NET 构建多代理应用;Omnigent 更强调把现成的 Claude Code、Codex、Cursor 等 harness 接到共享会话、终端与远程 host。要编写代理逻辑可先看 AutoGen;要统一操作多个现成编码 agent 时 Omnigent 更贴近。

来源:github.com/microsoft/autogen

总结评价

适合需要统一管理多个编码 agent、跨设备接续会话或对工具调用增加审批策略的团队。只运行单一 agent、无需远程协作时,额外服务端、凭据映射和 sandbox provider 会增加维护面。采用前需要核对:项目处于 Alpha,版本与配置仍快速变化。

来源:github.com/omnigent-ai/omnigent;https://github.com/omnigent-ai/omnige…

常见问题

Omnigent 的一键安装脚本可以直接管道执行吗?

官方给出 curl 管道安装,但脚本会安装工具并修改环境。更稳妥的做法是先下载和审查 install_oss.sh,或用 uv tool install omnigent 安装已发布包,并固定版本。

Omnigent 会自动读取现有模型凭据吗?

首次运行会发现环境里的 ANTHROPIC_API_KEY、OPENAI_API_KEY,或已登录的 claude/codex CLI,并让用户选择默认项。共享主机前应清理无关凭据,避免把个人账号带入团队会话。

Omnigent 在 Windows 上有完整沙箱吗?

没有。官方称 Windows 原生模式使用 Job Object 管理进程树和资源,但不提供 Linux bubblewrap 或 macOS seatbelt 那样的文件系统与网络隔离;需要这些边界时应使用 WSL、Linux 或 macOS。

把 Omnigent Web UI 给手机访问安全吗?

本地 UI 默认在 6767 端口;局域网访问、隧道或公网部署会暴露会话、终端和文件。远程使用前要启用认证,核对绑定地址、防火墙、OIDC 与单次邀请链接。

Omnigent 和 AutoGen 的用途一样吗?

不一样。AutoGen 更适合用框架 API 编写多代理应用;Omnigent 主要把现成编码 harness、共享会话、终端、策略和远程 host 放到一个操作层。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件