Hermes Conduit

A native iPhone, iPad and Apple Watch app for Hermes Agent. Free, no ads, no tracking.

See it in action

More on hermesconduit.app: live voice, Apple Watch, CarPlay and privacy.

Want new features sooner? The TestFlight beta gets newer builds before they reach the App Store.

What it does

Conduit is a touch-first app for your own Hermes agent on iPhone, iPad and Apple Watch, with CarPlay, widgets and Live Activities. It signs in to the Hermes dashboard you run, so your sessions, profiles, bots, tools and scheduled jobs are the same ones you use on desktop. Start a conversation on desktop and pick it up on your phone: the session list is the same because it is the same database.

The app works with any Hermes dashboard on its own. The free Hermes Conduit Notifier plugin on your host adds notifications, live voice, Apple Watch calls, rich cards and the phone features below.

Features

Chat

• Streaming replies with Markdown, highlighted code, math, Mermaid diagrams and task lists
• Thinking, tool calls and each turn's steps, shown live or folded away; delegated-agent progress
• Map, place, travel, media, contact and info cards that Hermes draws in the chat
• Attach photos, camera shots and any file; quote a message, react to it, copy it
• Steer, queue or stop a running turn; context meter; slash commands and workspace files
• Branch, pin, archive and delete sessions; project chats; Artifacts browser for every file and page Hermes made
• Saved chats open instantly, and you can type while Conduit reconnects

Voice

• Live voice calls with Gemini Live, GPT-Live (ChatGPT subscription or API key), Grok Live, or Local Live on your own speech server, with echo cancellation and talking over Hermes
• Start, check and cancel Hermes jobs by voice; results come back into the call
• Calls stay with their chat, keep going with the screen locked, shrink to a bar while you read, and are saved as chats you can resume
• Hermes calls you: a CallKit call when a job is done, Hermes needs you, or a check you scheduled is due, on the phone or the Watch
• Classic voice and dictation with on-device, Apple, Hermes or your own speech-to-text, spoken Stop and End, wake phrases, and Read Aloud for any reply
• Apple Watch app that calls on its own, CarPlay, Siri and the Action Button

Tasks, bots and groups

• Tasks board for Hermes' Kanban tasks
• Bots and their Bot Chats, with each bot's model, skills, tools and MCP servers (added from Hermes' catalog with their keys or sign-in), pictures Hermes can generate, @mentions that bring another bot in, bots messaging each other as Desktop shows it, and Duplicate, Hide, New Chat and Groups from the Bots list; gateway-hosted group chats with @mentions, files and approvals
• Scheduled jobs: review runs, run now, edit, mute their notifications, delete

Your phone, if you allow it

Each is off until you turn it on, and goes only to your own Hermes host, encrypted end to end. The keys are agreed over your dashboard connection, so use HTTPS or a private tunnel such as Tailscale to keep anyone on the network from stepping into that exchange:

• Location and place rules, travel times, directions and navigation
• Calendar and reminders, with each change asked first unless you allow adds
• Apple Health data
• Focus and phone status, alarms and timers, and contacts you pick
• Ask Hermes about what's on your screen, or send anything from Shortcuts or the share sheet

Notifications and control

• Approve tools and answer questions straight from a notification, end-to-end encrypted between your host and your phone
• Live Activities on the Lock Screen and in the Dynamic Island while a reply runs
• Home Screen widgets to start a chat or talk in one tap
• Provider, model and reasoning effort switching mid-conversation
• Multiple dashboards and profiles, each with its own credentials and settings
• Capabilities: skills, tools, connectors and plugins, plus Hermes settings and gateway logs
• Native OAuth sign-in through your dashboard, QR code and setup links, Cloudflare Access service tokens
• Face ID or Touch ID lock, credentials in the Keychain
• Available in English, French, German, Indonesian, Italian, Japanese, Korean, Polish, Portuguese (Brazil), Russian, Simplified Chinese, Spanish, Traditional Chinese and Turkish

Requirements

• iPhone or iPad on iOS 17 or later; Apple Watch app on watchOS 10 or later (some features need newer versions)
• A running Hermes Agent instance with the native dashboard enabled (default port 9119)

Connecting

If Hermes is already running, that's all you need. Conduit talks to the web dashboard that comes with Hermes (hermes dashboard, port 9119 by default). There is no Conduit server or container to install. The companion plugin is optional but unlocks notifications, live voice and the phone features, and it installs with one command.

You need three things from your Hermes host: the dashboard running with a username and password, a way for your phone to reach it, and the address to type into Conduit. Your Hermes agent can set all of that up for you.

The easy way: ask Hermes

1. Install Tailscale on your iPhone or iPad and sign in. It's free, and it lets your phone reach Hermes securely from anywhere without opening anything to the internet.
2. Copy the prompt below and send it to your Hermes agent wherever you normally talk to it: Telegram, Discord, the terminal, or the Chat page of the Hermes dashboard.
3. Hermes replies with an address, a username and a password, plus a sign-in link. Tap the link on your phone, or open Conduit and type the details in. If Hermes shows a QR code, tap Scan Code on Conduit's sign-in screen.

I want to use the Hermes Conduit app on my iPhone to talk to you. Conduit signs in to the Hermes web dashboard (the one started by `hermes dashboard`, default port 9119). Please set everything up and then tell me what to enter in the app.

1. Check whether the Hermes dashboard is running and which port it uses. If it isn't, start it, and make sure it starts again after a reboot.
2. Make sure the dashboard requires a sign-in. Never turn authentication off. If no username and password are set up yet, create them (HERMES_DASHBOARD_BASIC_AUTH_USERNAME and HERMES_DASHBOARD_BASIC_AUTH_PASSWORD in the Hermes .env file), and set HERMES_DASHBOARD_BASIC_AUTH_SECRET to a long random value so I stay signed in when the dashboard restarts.
3. Set up remote access with Tailscale Serve: check that Tailscale is installed and signed in on this machine, then run `tailscale serve --bg 9119` (with the dashboard's real port) and set dashboard.public_url in config.yaml to the https://<machine>.<tailnet>.ts.net address that Serve gives you. If the dashboard only listens on 127.0.0.1, leave it that way. Never open the dashboard port to the internet.
4. Install the Conduit companion plugin: `hermes plugins install kaishi00/hermes-conduit-notifier --enable`
5. If something needs me (installing or signing in to Tailscale, turning on HTTPS certificates for my tailnet, or a step on the host because you run inside a Docker container or on a NAS and can't make the change yourself), stop and tell me exactly what to do or which commands to run, then continue once I've done it.
6. When it's ready, tell me the address to enter in Conduit, the username and the password. Also make me a sign-in link: conduit://connect?url=ADDRESS&username=USERNAME&password=PASSWORD with each value percent-encoded and the full https:// address, never localhost. If we're talking in a terminal, show the link as a QR code there so the password stays out of chat history.
7. Last, restart the gateway and the dashboard so the plugin and the new settings load. Do this only after you've sent me everything from step 6, because the restart may end this conversation.

Only using Conduit at home on the same Wi-Fi? You can skip Tailscale: replace step 3 with "Make the dashboard reachable from other devices on my local network and tell me this machine's local IP address and the dashboard port." That address only works at home.

Conduit also has this built in: on the sign-in screen, Need help connecting? walks through the same questions and gives you a ready-to-copy prompt for each step.

Hermes in Docker or on a NAS

Conduit works the same when Hermes runs in a container: all it needs is the dashboard. The differences:

• Turn the dashboard on. The offi