omnigent · Docker

Omnigent is an AI agent meta-harness that drives many agents, packaged on the agentbloat foundations. This page runs it on Docker with copy-paste examples; every file in this directory is shown below exactly as it exists in the repository.

See the tool overview for image variants, tags, and registries.

Requirements

Docker or a compatible runtime

Quick start

bash

docker run -it --rm \
  -v "$PWD:/workspace" \
  ghcr.io/hambn/omnigent:latest

Files in this directory

`run.sh`

bash

#!/usr/bin/env bash
# Run Omnigent against the current directory.
set -euo pipefail

IMAGE="${OMNIGENT_IMAGE:-ghcr.io/hambn/omnigent:latest}"
docker run -it --rm \
  -v "$PWD:/workspace" \
  "$IMAGE" "$@"

`airgapped.run.sh`

bash

#!/usr/bin/env bash
# Offline host. Load Omnigent from a local tar and never pull.
set -euo pipefail

TAR="${1:-omnigent.tar}"
shift $(( $# > 0 ? 1 : 0 ))
[ -f "$TAR" ] || { echo "missing $TAR" >&2; exit 1; }
docker load -i "$TAR"
docker run -it --rm --pull=never \
  -v "$PWD:/workspace" \
  ghcr.io/hambn/omnigent:latest "$@"

More examples

Pin a specific image tag

Every moving tag from the image table works; override with an environment variable:

OMNIGENT_IMAGE=ghcr.io/hambn/omnigent:<tag> ./run.sh


### One-off non-interactive command

```bash
docker run --rm -v "$PWD:/workspace" ghcr.io/hambn/omnigent:latest --help


### Constrain resources

```bash
docker run -it --rm \
  --cpus=2 \
  --memory=4g \
  --memory-swap=4g \
  -v "$PWD:/workspace" \
  ghcr.io/hambn/omnigent:latest