# syntax=docker/dockerfile:1 # Hermes Agent — lightweight overlay # Adds Piper TTS, Himalaya email CLI, and extra system deps on top of the # official image. No source overlay — uses upstream as-is, so kanban and # all native v0.12.0 features are available without forking. # # Build: # docker compose build hermes # ---------- Base: official Hermes image (v0.12.0+ kanban, gateway, dashboard) ---------- FROM nousresearch/hermes-agent:latest # ---------- Extra system packages ---------- USER root RUN apt-get update && \ apt-get install -y --no-install-recommends \ libportaudio2 ca-certificates poppler-utils imagemagick \ texlive-latex-base texlive-latex-extra texlive-fonts-recommended \ texlive-xetex texlive-science \ qemu-user-static binfmt-support emacs-nox \ tmux \ && rm -rf /var/lib/apt/lists/* # ---------- UV (Python package manager) ---------- COPY --chmod=0755 --from=ghcr.io/astral-sh/uv:latest /uv /usr/local/bin/ # ---------- Piper TTS (local neural TTS) ---------- RUN . /opt/hermes/.venv/bin/activate && \ uv pip install --no-cache-dir piper-tts sounddevice numpy && \ mkdir -p /opt/hermes/.venv/share/piper/voices RUN /opt/hermes/.venv/bin/python3 /dev/stdin << 'PYEOF' import urllib.request base = '/opt/hermes/.venv/share/piper/voices' url = 'https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/ryan/high/en_US-ryan-high.onnx' urllib.request.urlretrieve(url, base + '/en_US-ryan-high.onnx') urllib.request.urlretrieve(url + '.json', base + '/en_US-ryan-high.onnx.json') PYEOF # ---------- Himalaya email CLI ---------- RUN /opt/hermes/.venv/bin/python3 /dev/stdin << 'PYEOF' import urllib.request, tarfile, os, shutil url = 'https://github.com/pimalaya/himalaya/releases/download/v1.2.0/himalaya.x86_64-linux.tgz' tgz = '/tmp/himalaya.tgz' urllib.request.urlretrieve(url, tgz) with tarfile.open(tgz) as t: t.extractall('/tmp') shutil.move('/tmp/himalaya', '/usr/local/bin/himalaya') os.chmod('/usr/local/bin/himalaya', 0o755) os.remove(tgz) print('himalaya v1.2.0 installed') PYEOF # ---------- Himalaya read-only wrapper ---------- COPY --chmod=0755 himalaya-ro.sh /usr/local/bin/himalaya-ro # ---------- Runtime ---------- USER hermes ENV HERMES_HOME=/opt/data ENV PATH="/opt/data/.local/bin:${PATH}" # Point browser tool to Playwright's Chromium (bundled in base image) ENV CHROME_EXECUTABLE=/opt/hermes/.playwright/chromium/chrome-linux/chrome # Ensure tools directory is writable for custom tools from persistent volume RUN chown -R hermes:hermes /opt/hermes/tools /opt/hermes/toolsets.py VOLUME [ "/opt/data" ]