omnigent

环境要求

• Python 3.12 或更高版本
• uv 包管理工具（必需）
• git（必需）
• Node.js 22 LTS 及以上并带 npm、pnpm（供编码智能体 CLI 与 Web UI 使用）
• tmux（原生 omnigent <harness> 终端包装器需要）；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

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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