Real answers from the person who builds Herald. Most questions are about getting your phone and your Hermes talking, and the guide below covers them. For anything else, send us a message.
We usually reply within a couple of days. Include your device, Herald version and how your phone reaches Hermes, and we can usually solve it in one go.
npx herald-setupIt sets a dashboard username and password, starts hermes serve if nothing is running, uses Tailscale when it is installed, and prints a QR code.mac.tailnet.ts.net is fine. Herald tries https://, port 9119 and http:// and keeps whichever answers.hermes-bot-push plugin on your computer (Settings › General in the app explains how), then tap Register on a real device.Check that hermes serve is running. On the computer, curl http://127.0.0.1:9119/api/health should answer. Then make sure the phone and computer are on the same network or the same tailnet, and that the address in Herald matches how the phone reaches the computer.
Your dashboard password changed or the session expired. Herald signs in again on its own when it has the password saved. Otherwise open Settings › Connections, tap the connection and enter the password, or run npx herald-setup again and rescan.
The default profile’s gateway may be stopped while your bots run under another profile. Start the gateway for that profile, or pair Herald with a hermes serve scoped to it.
Push needs three things: the hermes-bot-push plugin on your computer, a real phone (simulators can’t receive push), and a tap on Register while connected. Use Send a test push to check the phone side, then check the plugin log on the computer.
A new bot starts from your default profile’s model. A model from a custom provider works when that provider is also behind your default model. Otherwise pick a built-in provider model or Use Hermes default, or add the provider to the new profile’s config.yaml by hand.
The recovery screen has a Copy error button. Paste the result into the support form along with your device and Herald version, and we’ll take it from there.
Herald costs $12.99 once, with no subscription and no in-app purchases. One App Store purchase covers iPhone, iPad and Apple Watch. Google Play is a separate purchase. Reinstalling on the same store account is always free.
Refunds are handled by the store you bought from. Your rights under consumer law, including the Australian Consumer Law, always apply. See our terms.
Herald has no server and no accounts, so we hold almost nothing about you. To ask about, export or delete anything you’ve sent us, choose Privacy request in the form above. We respond within 30 days.
Conversations live on your own Hermes, so you can delete them there at any time. Read the full privacy policy.