omnigent

一套框架统一指挥所有AI编码助手,免重写、强管控。

Omnigent 是一个开源的 AI 智能体编排框架,旨在解决多智能体工具碎片化问题。它允许开发者统一调度 Claude Code、Codex、Cursor 等主流编码智能体,无需重写代码即可切换底层工具。核心能力包括:策略引擎(可定义权限和沙箱规则)、实时协作(支持多设备同步操作)、以及元编排层(统一管理不同智能体的生命周期)。项目采用 Python 编写,强调安全治理和可扩展性,适合需要精细化控制 AI 工作流的团队。

开源 unknown 智能体
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 10160
维护状态 活跃
是否开源 是
定价模式 unknown

项目数据

分类智能体
开发团队omnigent-ai
所属国家
定价模式unknown
价格说明定价信息待确认
访问状态
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型agent-framework,agent-governance,agent-orchestration,agents,ai,ai-agent,ai-agents,claude-code,codex,coding-agents,developer-tools,llm,ml,multi-agent,python,sandbox
GitHub 星标★ 10160
30天Star增速
HF 下载量
上线时间2026-06-11 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数6

使用教程

难度:入门 约 15 分钟 部署方式:命令行工具 7 步

环境要求

  • Python 3.12 或更高版本
  • uv 包管理工具(必需)
  • git(必需)
  • Node.js 22 LTS 及以上并带 npm、pnpm(供编码智能体 CLI 与 Web UI 使用)
  • tmux(原生 omnigent 终端包装器需要);Linux 还需 bubblewrap(bwrap)

安装与启动步骤

  1. 1一键安装

    官方安装脚本会连同依赖一起装好 Omnigent,适合大多数 macOS/Linux 用户。Windows 不支持该 shell 脚本,请改用下一步的 uv 安装。

    curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh
  2. 2按需装扩展

    需要额外集成时给安装脚本传 --extra,多个扩展用逗号分隔,例如接 Databricks 模型或 modal、e2b 沙箱。

    curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --extra databricks
    curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --extra modal,e2b
  3. 3uv 手动安装

    不想用脚本时用 uv 装包,扩展语法相同。Windows 原生环境或自定义 Python 版本推荐这种方式。

    uv tool install omnigent
    uv tool install --python 3.12 omnigent
    uv tool install "omnigent[databricks,modal]"
  4. 4Homebrew 安装

    macOS 用户可用 Homebrew tap 安装;内网需走镜像时可通过环境变量指定 pip 与 cargo 索引地址。

    brew install omnigent-ai/tap/omnigent
  5. 5源码安装

    直接从 GitHub 仓库安装最新代码,需指定 Python 3.12。注意 README 未给出本地 clone 后的开发式安装命令。

    uv tool install -q --python 3.12 git+https://github.com/omnigent-ai/omnigent.git
  6. 6部署服务端

    在一台服务器上跑服务端后,可在任意设备(含手机)访问同一会话。docker compose 启动,Render/Railway 可一键部署,详细目标清单见 deploy/README.md。

    docker compose up
  7. 7登录并注册主机

    服务端启动后先登录一次获取令牌,再把本机注册为 host,新会话即可在本机执行,run/attach/host 复用该令牌。

    omnigent login https://your-host
    omnigent host https://your-host

关键配置

配置项必填说明示例
HOMEBREW_PIP_INDEX_URL否源码构建时把 pip 及其隔离构建依赖指向内网 PyPI 镜像https://pypi.example.com/simple
HOMEBREW_CARGO_INDEX_URL否源码构建时指定 Cargo 稀疏注册表索引,需以 / 结尾且不带 sparse+ 前缀https://cargo.example.com/index/

如何确认成功

安装后执行 omnigent 相关命令能正常响应;服务端启动后 omnigent login 与 omnigent host 成功执行,手机上打开服务地址即可看到会话。

常见问题

Q:Windows 能用一键脚本安装吗?

A:不能,install_oss.sh 仅支持 POSIX。Windows 请用 uv tool install --python 3.12 omnigent 直接安装,且运行在降级模式下。

Q:安装器提示缺少 uv、git 或 tmux 怎么办?

A:uv 和 git 为必需项,安装器会主动提示帮你装;tmux 被原生 omnigent 终端包装器依赖,可按提示用 brew 或 apt 安装。

Q:Linux 上原生终端启动失败?

A:Linux 强制使用 bubblewrap 隔离每个智能体终端,缺少 bwrap 会导致启动失败,执行 apt install bubblewrap 即可;macOS 用内置 seatbelt 无需额外安装。

Q:没有服务器想用手机访问怎么办?

A:同一局域网内可直接在手机浏览器打开电脑的局域网地址,例如 http://192.168.x.x:6767,无需部署。

注意事项

  • 一键安装脚本会一并安装所需工具链,若中途提示缺工具可让其代为安装。
  • 仅 py 安装不区分扩展时默认不含 databricks、modal 等可选集成,需要时须显式指定 --extra。
  • 服务端部署涉及数据库、沙箱和品牌白标等细节,README 指向 deploy/README.md,建议部署前通读。
  • 源码安装只提供 uv 从 git 仓库安装的方式,README 未给出 clone 后本地开发安装流程。

核心亮点

  • 支持 Claude Code、Codex、Cursor 等主流智能体无缝切换,避免厂商锁定
  • 内置策略引擎和沙箱,可精细控制 AI 行为,提升安全合规性
  • 实时协作功能让多设备同步操作,适合团队远程协同开发

不足之处

  • 文档/社区待观察
  • 依赖外部智能体工具,其稳定性可能影响整体流程

适用场景

  • 企业统一管理多个 AI 编码工具,实施安全策略
  • 团队远程协作,共享 AI 工作流和实时会话
  • 开发复杂项目时,按任务切换最优智能体提升效率

替代项目

LangChain、AutoGen、CrewAI

项目介绍

omnigent 是智能体领域的开源项目,由 omnigent-ai 开发,是 2026 年新上线的项目。

在全站 13,090 个收录项目中,它的 GitHub 星标数(10,160)位列前 5%,在智能体分类的 2,517 个项目里位列前 6%。

近 41 天,它的 GitHub 星标从 8,723 增加到 10,160,净增 1,437。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。从国内网络环境看,可直接访问。

它主要面向的使用场景是:企业统一管理多个AI编码工具,实施安全策略。同类可对比的替代方案包括 LangChain、AutoGen、CrewAI。

上一篇:eigent

下一篇:MiroThinker

同类项目推荐

xinchao-dynamic-mind 开源

给 AI 装上疲惫和欲望,让交互更真实

独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。

★ 199 2026-08-09
deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 233327 2026-08-15
AutoGPT 开源

开箱即用的 AI 员工,交代任务就自己干完

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···

★ 187492 2026-08-09
EvoAgentX 开源

让 AI 智能体自己迭代变强,越用越聪明

EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents

★ 3351 2026-09-12