Support
How can we help?
A real person reads every message. Most setup questions are answered in the setup guide.
What to include
Three things let us help on the first reply instead of the third.
- What you did and what you expected. Screenshots help.
- The diagnostic text from Kuya. Open Settings, then About, then Report a problem. It has your server address, connection status, and app version, and only the last four characters of your key.
- Your Hermes version (hermes --version) and how the phone reaches the computer: Tailscale, Wi-Fi, or Kuya Cloud.
Never send your full access key or dashboard password to anyone, including us.
Common fixes
Kuya says it can't reach the server
Check that Tailscale is on for both the iPhone and the computer, or that the phone is on the same Wi-Fi as the computer. Then open http://<address>:8642/health in Safari on the phone.
If that page doesn't load either, the problem is the network or the Hermes gateway, not the app.
It connected, but replies never arrive
Make sure the gateway is running (hermes gateway status) and that your Hermes has a model provider set up. Kuya Pair's "Sign in to your AI" step does this for you.
The QR code didn't work
A code from Kuya Pair works for 10 minutes, and the window makes a new one on its own. With hermes-pair, just run it again. It's safe to repeat and never overwrites your settings.
My Kuya Cloud invite link doesn't work
Invite links work once and expire after a while. Ask Brandon for a new invite. The same goes for a new phone: a new invite connects it and signs the old phone out.
Settings, tools, or skills look empty
Those screens use the Hermes dashboard and need its login. In Kuya, open Settings, pick the connection, and tap Add dashboard login. Chat works without it.
Photos attach, but the model ignores them
Image understanding depends on the model your Hermes uses. Pick a model that can see images for that chat.
I want to try Kuya without a server
On the welcome screen, tap Try a sample chat. It shows the interface with sample conversations. It's a tour, not a working agent.
I'd like a refund
Apple handles App Store purchases and refunds. Request one at reportaproblem.apple.com.