feat(hermes_squid): add hermes-proxy service and voice-gateway to hermes_infra #4

Closed
hermes wants to merge 5 commits from feat/voice-gateway-proxy into infra/gitea-update
Owner

Summary

Two changes to the hermes_infra stack:

  1. hermes-proxy — new OpenAI-compatible HTTP egress service on :8645. Shares the same OAuth credentials as the gateway via hermes_gateway_data volume. Reachable only via the hermes_proxy overlay (internal: true).

  2. voice-gateway — new Python aiohttp WS bridge between browser and hermes-proxy. Placement node.hostname==rudolf-T. Image built externally by Gitea Actions in Org1/hermes-voice-gateway and pulled from gitea.rudolf.keenetic.link/hermes/hermes-voice-gateway. Piper voice model downloaded on first start via entrypoint.sh.

Files changed

  • hermes_squid/stack-compose.yml — added two services.

Image tag

Current: gitea.rudolf.keenetic.link/hermes/hermes-voice-gateway:v0.2.0. Bump by:

  1. Push tag v* in Org1/hermes-voice-gateway → triggers Actions release workflow.
  2. Update image tag in stack-compose.yml (here).

Verification

  • docker stack deploy hermes_infra succeeds, both services reach Running.
  • curl http://voice-gateway.keenetic.link:8765/healthz returns {"status":"ok"}.
  • Browser → voice-gateway WS → hermes-proxy → Hermes round-trip works.

Related

## Summary Two changes to the hermes_infra stack: 1. **`hermes-proxy`** — new OpenAI-compatible HTTP egress service on :8645. Shares the same OAuth credentials as the gateway via `hermes_gateway_data` volume. Reachable only via the `hermes_proxy` overlay (internal: true). 2. **`voice-gateway`** — new Python aiohttp WS bridge between browser and hermes-proxy. Placement `node.hostname==rudolf-T`. Image built externally by Gitea Actions in Org1/hermes-voice-gateway and pulled from `gitea.rudolf.keenetic.link/hermes/hermes-voice-gateway`. Piper voice model downloaded on first start via entrypoint.sh. ## Files changed - `hermes_squid/stack-compose.yml` — added two services. ## Image tag Current: `gitea.rudolf.keenetic.link/hermes/hermes-voice-gateway:v0.2.0`. Bump by: 1. Push tag `v*` in Org1/hermes-voice-gateway → triggers Actions release workflow. 2. Update image tag in `stack-compose.yml` (here). ## Verification - [ ] `docker stack deploy hermes_infra` succeeds, both services reach Running. - [ ] `curl http://voice-gateway.keenetic.link:8765/healthz` returns `{"status":"ok"}`. - [ ] Browser → voice-gateway WS → hermes-proxy → Hermes round-trip works. ## Related - Org1/hermes-voice-gateway#4 (voice-gateway service + browser client) - hermes/brencher#4 closed (was for separate stack; no longer needed) - admin/ansible#7 closed (Gitea ROOT_URL fix)
hermes added 1 commit 2026-09-12 23:15:25 +02:00
Routes /v1/chat/completions to the same OAuth backend the gateway uses,
via a shared hermes_gateway_data volume. Bound to 127.0.0.1 inside the
container; reachable only via the hermes_proxy overlay (internal: true).
Defaults to aiohttp on :8645 (hermes_cli/proxy/server.py DEFAULT_PORT).

Targets rudolf-T consumers (voice-gateway, Org1/hermes-voice-gateway#3)
that need an OpenAI-shaped transport to the agent without going through
the gateway's messaging adapters.
hermes changed title from feat(hermes_squid): add hermes-proxy service for OpenAI-compatible HTTP egress to feat(hermes_squid): add hermes-proxy service + voice-gateway-stack-compose 2026-09-13 16:29:46 +02:00
hermes added 1 commit 2026-09-13 16:53:35 +02:00
Two changes to the hermes_infra stack:

1. New 'hermes-proxy' service: OpenAI-compatible HTTP egress on :8645,
   sharing the same OAuth credentials as the gateway (shared volume
   hermes_gateway_data). Reachable only via the hermes_proxy overlay
   (internal: true). Image nousresearch/hermes-agent:v2026.8.3 with
   command 'proxy run --host 0.0.0.0 --port 8645'.

2. New 'voice-gateway' service: Python aiohttp WS bridge between browser
   and hermes-proxy. Placement node.hostname==rudolf-T (x86_64 worker,
   14.5 GiB RAM). Image is built externally by Gitea Actions in
   Org1/hermes-voice-gateway (workflow release.yml on tag push) and
   pulled from gitea.rudolf.keenetic.link/hermes/hermes-voice-gateway.

   Piper voice model (ru_RU-denis-medium.onnx + .json) is downloaded
   on first start via the container's entrypoint.sh from HuggingFace.
   No pre-baked volume needed.

Image tags in registry: v0.1.1, v0.2.0. Bump via git tag + push in
Org1/hermes-voice-gateway, then update compose.yaml image tag here.
hermes force-pushed feat/voice-gateway-proxy from a08677abc1 to 0054d9c21b 2026-09-13 16:53:35 +02:00 Compare
hermes changed title from feat(hermes_squid): add hermes-proxy service + voice-gateway-stack-compose to feat(hermes_squid): add hermes-proxy service and voice-gateway to hermes_infra 2026-09-13 16:53:53 +02:00
hermes added 1 commit 2026-09-13 17:23:14 +02:00
brencher parses ${VAR} via re.sub on the literal token name. ${HERMES_PROXY_TOKEN:-}
collapses to the token 'HERMES_PROXY_TOKEN:-' which is not in the env dict, raising
KeyError at deploy step. Plain ${HERMES_PROXY_TOKEN} resolves to empty string when
the env is unset, which is what the shell default was protecting against.
hermes added 1 commit 2026-09-13 17:34:10 +02:00
hermes-proxy listens on hermes_proxy overlay which is internal:true —
no external ingress. Auth between voice-gateway and hermes-proxy is not
required for MVP, and brencher was rejecting the ${HERMES_PROXY_TOKEN}
substitution as missing key.

Removing the line lets brencher apply the compose; the gateway already
connects unauthenticated when the env is absent.
hermes added 1 commit 2026-09-13 18:37:01 +02:00
brencher's ${version} substitution expands to auto-<merge-sha> at deploy
time, but the image was pushed under a semver tag (v0.3.0) by Gitea
Actions, so the deploy fails with 'No such image'.

Hardcoding the tag in compose.yml makes the deploy deterministic and
removes the brencher coupling. Bumping the voice-gateway release now
requires updating this string in addition to the tag in
Org1/hermes-voice-gateway.

Bump sequence:
  1. Push tag v0.4.0 in Org1/hermes-voice-gateway -> workflow builds image
  2. Update this string to v0.4.0
  3. brencher deploys
hermes closed this pull request 2026-09-13 18:44:02 +02:00
hermes deleted branch feat/voice-gateway-proxy 2026-09-13 18:44:02 +02:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: hermes/ansible#4