Talk to AI with Voice Mode
Talk to AI with Voice Mode — easy-to-understand guide based on official docs
Remember walkie-talkies? Press a button, speak, release, and your voice carries across the room. That’s exactly what voice mode feels like for Hermes Agent—except the person on the other end is an AI that actually understands you, thinks, and talks back. No typing. No staring at a screen. Just conversation.
What Can You Actually Do?
Voice support in Hermes Agent covers three real-world scenarios:
- In your terminal (CLI): Press a hotkey, speak, and the agent replies out loud.
- In Telegram or Discord chats: Send a text message, and the agent replies with text plus a voice message.
- In Discord voice channels: The bot literally joins your voice channel, listens to everyone, and answers with speech—like a conference call with an extra smart participant.
Before You Start (Three Quick Checks)
Don’t rush. Confirm these three things first:
- Install Hermes Agent using the official installation script.
- Configure an AI model (like OpenAI or Nous Portal). Run
hermes modelor drop your API key into the~/.hermes/.envfile. - Test text chat first: Run
hermesand make sure it replies normally before enabling voice.
Tip: The
~/.hermes/folder andconfig.yamlare generated automatically the first time you runhermes. You only need to manually create the.envfile for your keys.
Money-saving trick: If you subscribe to Nous Portal, it provides both the AI model and text-to-speech (TTS)—no need to pay extra for OpenAI’s voice service. On a fresh setup, run
hermes setup --portalto configure everything at once.
How to Use It
1. Speak in the Terminal (CLI)
- Press
Ctrl+Bto start recording. - Pause after speaking—it detects the silence and stops automatically.
- The agent then replies with voice.
2. Automatic Voice Replies in Chat Apps
- Send a message to the agent in Telegram or Discord.
- It replies with text and a generated voice message.
- Perfect for when you’re busy or away from the screen—just listen.
3. Real-Time Conversation in a Discord Voice Channel
- Invite the bot to your voice channel.
- It listens to everyone and answers out loud.
- Feels like having a teammate who never zones out.
Going Hands-Free
Want to go fully hands-free? Set up a wake word (like “Hey Hermes”). Say it, and the agent opens a new voice session automatically—no keyboard needed. Check the official Wake Word docs for setup details.
Final Thoughts and Practical Advice
Voice mode turns the AI from a typing tool into a conversation partner. For beginners, the most practical path is:
- Get text chat working first.
- Try
Ctrl+Bin the terminal once. - Then, if you’re ready, connect Discord voice.
My recommendation: If you work at a computer all day, start with CLI voice mode—it’s lightweight and needs zero extra setup. If you want to use it on your phone, Telegram’s automatic voice replies are a game-changer; you can “listen” to the AI’s answers while walking. Don’t be afraid to experiment—press Ctrl+B a few times, and it’ll feel natural in no time.
📖 Official Docs
This article is based on the official Hermes Agent documentation:Official docs › guides/use-voice-mode-with-hermes