Support
How can we help?
A real person reads every message. For setup, the setup guide is the fastest start.
Please include what happened and the report from Settings, About, Report a Problem. We will never ask for your key or password.
Common fixes
What is Hermes?
Hermes Agent is an open-source AI agent from Nous Research. It runs on a computer or server with the AI model you pick. Kuya is an independent iPhone app for talking to it and isn't made by or affiliated with Nous Research.
What does it cost?
$4.99, once, on the App Store. No subscription. Kuya Pair and Hermes Agent are free; the AI service behind your Hermes may charge for what you use. Apple handles refunds at reportaproblem.apple.com.
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 the person who invited you for a new one. 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 app with sample conversations. There's no working agent behind it.