Run Hermes

import asyncio

from boxlite import SimpleBox

BASE_URL = "<YOUR_BASE_URL>"               # an Anthropic-compatible endpoint
API_KEY = "<YOUR_API_KEY>"                 # TODO: read from your own secret store
MODEL = "<MODEL_ID>"


async def main() -> None:
    try:
        async with SimpleBox(
            image="docker.io/nousresearch/hermes-agent:latest",
            memory_mib=4096,
            disk_size_gb=12,
        ) as box:
            result = await box.exec(
                "sh", "-c",
                f'hermes -z "Write a one-line Python snippet that reverses a string." '
                f'--provider anthropic -m {MODEL} --yolo',
                env={
                    "ANTHROPIC_BASE_URL": BASE_URL,
                    "ANTHROPIC_API_KEY": API_KEY,
                    "ANTHROPIC_AUTH_TOKEN": API_KEY,
                },
                timeout=420.0,
            )
            # exec does not raise on a non-zero exit — check it yourself
            if result.exit_code != 0:
                print(f"hermes failed (exit={result.exit_code}): {result.stderr}")
            else:
                print(result.stdout.strip())
    except RuntimeError as exc:
        print(f"runtime error: {exc}")


if __name__ == "__main__":
    asyncio.run(main())

$ hermes --version
Hermes Agent v0.20.4 (2026.8.18)
Install directory: /opt/hermes
Python: 3.13.5

$ which hermes hermes-agent hermes-acp
/opt/hermes/bin/hermes
/opt/hermes/.venv/bin/hermes-agent
/opt/hermes/.venv/bin/hermes-acp

import asyncio

from boxlite import SimpleBox

GATEWAY_PORT = 8080


async def wait_for_port(box, port: int, timeout: float = 300.0, interval: float = 3.0) -> bool:
    """Poll /proc/net/tcp inside the box until the port is listening.

    exec returns as soon as a command is launched, so nothing health-checks a
    backgrounded service for you. /proc/net/tcp lists ports in uppercase hex.
    """
    port_hex = f"{port:04X}"
    loop = asyncio.get_running_loop()
    deadline = loop.time() + timeout
    while loop.time() < deadline:
        result = await box.exec("cat", "/proc/net/tcp")
        if port_hex in result.stdout.upper():
            return True
        await asyncio.sleep(interval)
    return False


async def main() -> None:
    try:
        async with SimpleBox(
            image="docker.io/nousresearch/hermes-agent:latest",
            memory_mib=4096,
            disk_size_gb=12,
            ports=[(GATEWAY_PORT, GATEWAY_PORT)],
        ) as box:
            # Launch in the background — this exec returns immediately
            await box.exec("sh", "-c", "nohup hermes gateway run > /tmp/gateway.log 2>&1 &")

            if not await wait_for_port(box, GATEWAY_PORT):
                # The gateway's own log is the only place the reason appears
                log = await box.exec("cat", "/tmp/gateway.log")
                print(f"gateway did not come up:\n{log.stdout}{log.stderr}")
                return

            print(f"gateway ready on http://127.0.0.1:{GATEWAY_PORT}")
            # Keep the box alive for as long as you need the gateway
            await asyncio.sleep(3600)
    except RuntimeError as exc:
        print(f"runtime error: {exc}")


if __name__ == "__main__":
    asyncio.run(main())

from boxlite import SimpleBox, Secret, NetworkSpec

box = SimpleBox(
    image="docker.io/nousresearch/hermes-agent:latest",
    disk_size_gb=12,
    secrets=[Secret(name="provider", value="<YOUR_API_KEY>", hosts=["<YOUR_HOST>"])],
    network=NetworkSpec(mode="enabled", allow_net=["<YOUR_HOST>"]),
)