Hermes Bots · Delancey Labs LLC

Hermes Bots support.

Hermes Bots is a native iPhone, iPad and Mac app for Hermes Agent, the open-source AI agent you run on your own server. Hermes Bots is an independent app by Delancey Labs. It is not affiliated with or endorsed by Nous Research, the developer of Hermes Agent.

Requirements

• iPhone or iPad with iOS or iPadOS 18 or later, or a Mac with macOS 15 or later.
• Your own Hermes Agent server, reachable from your device over HTTPS.
• The username and password you use to sign in to that server.

Get started

Open Hermes Bots and, in Connect Hermes, enter your server address (for example, https://hermes.example.com), your username, and your password. Your bots appear in the list; tap one to start chatting. To add another server later, go to Settings.

Hermes Bots can’t connect

Check that the address starts with https:// and opens in Safari on the same device. If your server is on a private network such as a VPN or Tailscale, make sure the device is connected to it. Confirm the username and password by signing in to your Hermes dashboard. Remote servers must use HTTPS.

Notifications

Chat works without notifications. To get notified while the app is closed, run the Hermes Bots push companion alongside your Hermes server, then pair it in Settings → Pair push companion and allow notifications when asked. If notifications stop, check that they are allowed for Hermes Bots in your device’s Settings and that the companion is running. Contact us if you need help setting it up.

Suggested replies

Suggested replies appear after a bot replies, when you haven’t started typing. They need a device with Apple Intelligence turned on, and they are hidden while a bot is working or waiting for an approval. Turn them on or off in Settings → Suggested replies.

Voice

Tap the waveform button in a chat to start a voice conversation. Voice uses the transcription and speech services configured on your Hermes server, so if a bot can’t hear you or doesn’t answer aloud, check that bot’s voice settings on the server. Allow microphone access when asked. You can choose Device voice in Settings to have replies spoken by your device. On iPhone, turn off Show as a phone call if you don’t want voice conversations on the system call screen.

Approvals

Hermes Bots shows the approvals your Hermes server pauses for. Which actions need approval is set by each bot’s approval policy on the server.

Get help

Email hello@delanceylabs.com. Include your device model, OS version, app version, and what happened, step by step. Never send your password, server login, or other secrets. Read the Hermes Bots privacy policy.