hermes-host

Deployment bundle for running a Hermes Agent gateway on free, credit-card-free hosting.

Targets:

• Red Hat OpenShift Developer Sandbox (14 GB RAM, 40 GB storage, HTTPS route, 30 days, no card) → k8s/openshift.yaml + deploy-openshift.sh
• Render free web service (512 MB, 750 h/month, no card, spins down after 15 min idle) → render.yaml
• any Docker host — the image is self-contained

The container keeps nothing important on its own disk: on boot it restores ~/.hermes from a private Hugging Face dataset (or a mounted PVC) and pushes it back on a timer, so restarts, rebuilds and reschedules lose no state.

Files:

• Dockerfile — Hermes install, no browser/computer-use, low RAM
• start.sh — secrets → config → state restore → health port → sync loop → gateway
• sync_state.py — pull/push of ~/.hermes to the private dataset (SQLite-safe)
• config.template.yaml — minimal low-RAM config
• k8s/openshift.yaml — PVC + BuildConfig + Deployment + Service + Route
• deploy-openshift.sh — login, build, secrets, rollout, URL
• render.yaml — fallback host

Secrets are never stored in this repo; they are supplied as platform env vars or Kubernetes secrets.