Support

Hermes is a public iOS client for connecting to a compatible Hermes Agent gateway over HTTPS. It is available to individuals and organizations and is not limited to employees, invited users, or approved clients.

Public Access and Self-Hosting

No Hermes service account, company affiliation, or invitation is required. Anyone can install the publicly available Hermes Agent project on a computer or server they control, enable its API server, and connect with that gateway's URL and API key.

Getting Started

1. Install Hermes Agent from the public project above, or use another compatible gateway you control, with the API server enabled.
2. Make the gateway reachable over HTTPS.
3. Open Hermes and enter the gateway root base URL and API key. For example, use https://host.example:18443, not https://host.example:18443/v1.
4. Hermes validates the key against /v1/capabilities before saving the profile.

Personal Instance Messaging

Hermes chooses the send endpoint from /v1/capabilities.

• If the gateway advertises both run_submission and run_events_sse, iOS sends prompts to POST /v1/runs and streams GET /v1/runs/{run_id}/events.
• If runs are not fully advertised but chat_completions is available, iOS uses POST /v1/chat/completions.
• If neither send API is advertised, the prompt remains visible in the Outbox as failed instead of hanging silently.

Common Issues

• "Use a secure https:// URL": Hermes does not allow plaintext http:// gateway URLs.
• "API key rejected": verify the gateway's API_SERVER_KEY.
• Message appears but no assistant response: check Backends has the expected active personal profile, then check gateway logs for POST /v1/runs or POST /v1/chat/completions based on the capability flags above.
• File browser unavailable: configure HERMES_FS_ROOT on the gateway, or leave file browsing disabled.
• Push notifications unavailable: the gateway must be configured with APNs relay credentials and the app must have notification permission.

Safety

Hermes may surface tool approval requests from the gateway. Review the command and reason before approving. Approve only actions you understand and trust.

Contact

Support email: support@imitationalpha.com.