2.0 KiB
Hermes agent as the assistant
The "Hermes agent" assistant model sends what you say to a
Hermes Agent gateway through its
OpenAI-compatible API server and streams the answer back to the glasses. Hermes
runs its own tools and keeps the conversation: each Faceclaw assistant
conversation maps to one Hermes session (X-Hermes-Session-Id), and only the
latest message is sent. Faceclaw's own glasses tools are not offered to Hermes.
The session ID is saved with the conversation, so a conversation restored after
an app restart continues the same Hermes session.
A Hermes turn may run for up to 20 minutes (other models get 2), because Hermes runs whole multi-tool tasks in one request and closing the stream interrupts the run on the server. A run that fails or is interrupted on the server shows as an error on the glasses, with any partial answer kept.
Enable the API server in Hermes
In the Hermes config, enable the api_server platform and bind it where the
phone can reach it, then set a key in Hermes's .env and restart the gateway:
hermes config set platforms.api_server.enabled true
hermes config set platforms.api_server.extra.host <address the phone can reach>
hermes config set platforms.api_server.extra.port 8642
echo "API_SERVER_KEY=$(openssl rand -hex 24)" >> ~/.hermes/.env
Check it with curl -H "Authorization: Bearer <key>" http://<host>:8642/v1/models.
Settings (Settings > Assistant)
- Assistant model: Hermes agent. Disabled until the URL is set.
- Hermes URL: e.g.
http://host:8642/v1(a bare host gets/v1added). - Hermes key: the
API_SERVER_KEYvalue.
On iOS, App Transport Security blocks plain http:// to IP addresses unless
App_Resources/iOS/Info.plist has an NSExceptionDomains entry for that host
(NSExceptionAllowsInsecureHTTPLoads); otherwise serve the API over https, for
example with tailscale serve.
Actions that Hermes holds for approval (approvals.mode manual) cannot be
approved from the glasses; approve them from Hermes itself.