Support

Getting Started

SpeakAble connects to your own Hermes agent through a LiveKit server. You'll need:

1. A running LiveKit server (brew install livekit)
2. The bridge agent (agent_bridge.py) connecting LiveKit to your Hermes API
3. Your server address entered in SpeakAble Settings

Full setup instructions are in the GitHub README.

Common Issues

App shows "Offline"

• Make sure your LiveKit server is running
• Check that the bridge agent is running (launchctl list | grep voice-bridge)
• Verify the server address in Settings (use http:// not ws://)
• Tap "Reconnect" or restart the app

Voice recognition isn't working

• Grant microphone permission when prompted
• Ensure the correct language is selected (English, Cantonese, or Mandarin)
• Download the speech recognition model for your language in Settings → General → Keyboard

TTS voice sounds robotic

• Download a premium voice: Settings → Accessibility → Spoken Content → Voices
• Premium voices sound dramatically more natural than compact ones
• Select your preferred voice in SpeakAble's voice picker

"Sorry, couldn't reach SpeakAble"

• Check that your Hermes API server is running
• Verify the API key in your bridge's .env file
• Check bridge logs: ~/hermes-voice/agent/agent.log

Contact

For help or feedback: yeung.vincent@gmail.com

GitHub Issues: github.com/bbugs280/hermes-voice/issues