Voice mode
Headmaster supports real-time voice interaction — talk to the agent with your voice and hear responses spoken aloud.How it works
The full voice cycle:1
You speak
Click the microphone icon in the chat composer to start recording.
2
STT transcribes
Your speech is converted to text by either a local faster-whisper model or OpenAI Whisper.
3
Agent processes
The transcribed text is sent as a message to the agent, which generates a response.
4
TTS speaks
The agent’s text response is converted to speech audio and played back through your speakers.
Enabling voice mode
1
Open Voice settings
Go to Settings → My Headmaster → Look → Voice.
2
Turn on voice mode
Enable Enable voice mode.
3
Choose a TTS provider
Pick a provider and voice from the dropdown.
4
Choose an STT backend
Select local faster-whisper (no API key) or OpenAI Whisper (requires key).
5
Save
Click Save. Voice mode is ready in your next message.
Providers
- TTS providers
- STT backends
Using voice mode
- Click to talk
- Push to talk
- Continuous mode
Click the microphone icon in the chat composer. The icon turns red to indicate recording. Speak your message, then click the icon again (or press
Esc) to stop. The agent transcribes, processes, and speaks the response.Voice on messaging platforms
On Telegram and Discord, voice messages you send are transcribed and processed as text. If TTS is enabled for that platform, the response comes back as a voice message.Microphone button states
Voice settings reference
Tips
- 🎙️ Speak clearly — the STT model works best with moderate-paced, clear speech.
- 🤫 Use a quiet environment — background noise reduces transcription accuracy.
- 🔊 Try different voices — some TTS voices sound more natural for your use case.
- ⚡ Adjust speed — if the agent speaks too fast or slow, tweak the TTS speed setting.
Channels
Voice messages on Telegram and other messaging platforms.
Modes
Continuous voice works best in Hands-Off or Autopilot mode.