Voice Mode — Talk to AI

Remember the last time your hands were covered in flour, dough, or grease, and you desperately needed to look something up? Typing was out of the question. That’s exactly the problem Hermes Agent’s voice mode solves: it turns AI from something you type at into something you simply talk to.

Three Ways to Open Your Mouth

Voice isn’t a single feature—it adapts to where you’re working. Here’s the quick map:

Feature	Platform	What Happens
Interactive Voice	Command Line (CLI)	Press Ctrl+B, speak, release—AI answers instantly
Auto Voice Replies	Telegram, Discord	Send text, get text plus a spoken reply
Voice Channel	Discord	Bot joins the channel and talks with you in real time

In plain words: press a key on your computer to talk, receive voice replies in chat apps, or “call” the AI inside Discord.

Before You Start: Three Quick Checks

1. Install Hermes Agent (see the installation guide)
2. Configure your AI model — run hermes model or drop your API key into ~/.hermes/.env
3. Confirm text chat works — run hermes and make sure the AI replies before adding voice

Pro tip: The first time you run hermes, it creates the ~/.hermes/ folder and config.yaml automatically. You only need to create ~/.hermes/.env yourself for API keys.

Money saver: If you subscribe to Nous Portal, you get both the AI model and text-to-speech (TTS) in one subscription—no separate OpenAI voice key needed. On a fresh install, just run hermes setup --portal and you’re done.

Three Steps to Start Talking

Step 1: Install the voice dependencies

pip install hermes-agent[voice]

Step 2: Launch Hermes

hermes

Step 3: Start speaking

• In the terminal: hold Ctrl+B, talk, release—the AI detects the silence and answers
• In Telegram or Discord: send a normal message, and the AI automatically adds a voice reply
• In a Discord voice channel: invite the bot in, and it listens and responds live

Level Up: Hands-Free Wake Word

Too lazy to press a button? Set a wake word—say “Hey Hermes” to your computer, and a new voice session starts automatically. Full setup is in the wake word guide.

Final Thoughts and a Practical Tip

Voice mode’s core value is simple: it lowers the barrier from “can type” to “can talk.” For multitasking moments—cooking, driving, crafting—or for anyone who finds keyboards unfriendly, this is a genuine productivity boost.

My practical advice: Start in the terminal with Ctrl+B to get a feel for the rhythm of voice interaction. Once comfortable, move to a Discord voice channel—that’s where the truly immersive, hands-free conversation lives. And if your room is noisy, speak close to the mic; the silence detection works better with a clearer signal.