hambn/omnigent repository overview

⁠Omnigent

Omnigent⁠ is an open-source meta-harness: one session can drive Claude Code, Codex, Pi, OpenCode and other agents. This image adds it to agentbloat⁠, so the agent CLIs it launches are already installed. The entrypoint is omnigent, and the container starts in /workspace as sysadmin (UID 1000). No credentials are stored in the image.

• Source: tools/ai/omnigent/⁠
• Docs: tool-containers.hgh.dev/docs/ai/omnigent/⁠

⁠Contents

• Images⁠
• Included software⁠
• Use cases⁠
• Sources⁠

⁠Images

• ubuntu: Ubuntu 24.04 without a browser. latest points here.
  • Base: agentbloat:ubuntu⁠
  • Tags: ubuntu, latest, omnigent-<version>
  • Included software: Omnigent⁠ and the agentbloat CLIs⁠
• ubuntu-browser: Ubuntu 24.04 with headless Chromium, the default in the recipes.
  • Base: agentbloat:ubuntu-browser⁠
  • Tags: ubuntu-browser
  • Included software: Omnigent⁠ and the agentbloat CLIs⁠
• alpine: Alpine 3.24 without a browser.
  • Base: agentbloat:alpine⁠
  • Tags: alpine
  • Included software: Omnigent⁠ and the agentbloat CLIs⁠
• alpine-browser: Alpine 3.24 with Chromium.
  • Base: agentbloat:alpine-browser⁠
  • Tags: alpine-browser
  • Included software: Omnigent⁠ and the agentbloat CLIs⁠

Pull ghcr.io/hambn/omnigent:<tag> or docker.io/hambn/omnigent:<tag>. omnigent-<version> names the PyPI release in the current ubuntu build. All tags move when the image is rebuilt; pin a digest to keep one build.

⁠Included software

• Omnigent
  • Commands: omnigent, omni
  • Source: PyPI package omnigent, version pinned in the Dockerfile⁠

Omnigent is installed as a uv tool in /opt/uv-tools/omnigent, with its launchers in /usr/local/bin so any UID can run them. On Alpine, its google-re2 dependency is compiled in a build stage and only the re2 runtime library ships. The agent CLIs come from agentbloat⁠; tmux and bubblewrap, which Omnigent's terminal wrappers use, come from the devbox full tier⁠.

⁠Use cases

• Orchestrate agents over a local checkout with Docker⁠, including hosts that load the image from a saved tar.
• Repeatable local orchestration sessions with Docker Compose⁠, with an air-gapped Compose file.
• Rootless agent orchestration on a workstation with Podman⁠.

⁠Sources

• Omnigent repository⁠
• PyPI package omnigent⁠
• Omnigent install guide⁠