Voice Mode 활용
기준일: 2026-07-26
난이도: 중급
공식 기준: Use Voice Mode with Hermes
개요
CLI·Telegram·Discord에서 STT/TTS 보이스 모드를 설정·사용하는 방법입니다.
핵심 개념
| 구성 | 설명 |
|---|---|
| STT / TTS | 음성↔텍스트 |
| CLI mic | 로컬 녹음 루프 |
| Messaging voice | 보이스 메시지 |
| Discord VC | 보이스 채널 |
상세
Voice Mode가 적합한 경우
원문 절: What voice mode is good for
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
구성 선택
원문 절: Choose your voice mode setup
- get text working first
- enable voice replies second
- move to Discord voice channels last if you want the full experience
| Mode | Best for | Platform |
|---|---|---|
| Interactive microphone loop | Personal hands-free use while coding or researching | CLI |
| Voice replies in chat | Spoken responses alongside normal messaging | Telegram, Discord |
| Live voice channel bot | Group or personal live conversation in a VC | Discord voice channels |
1단계: 텍스트 Hermes 먼저
원문 절: Step 1: make sure normal Hermes works first
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
hermes
2단계: extras 설치
원문 절: Step 2: install the right extras
- CLI microphone + playback — 공식 하위 절. 구현·설정 세부 원문 참조.
- Messaging platforms — 공식 하위 절. 구현·설정 세부 원문 참조.
- Premium ElevenLabs TTS — 공식 하위 절. 구현·설정 세부 원문 참조.
- Local NeuTTS (optional) — 공식 하위 절. 구현·설정 세부 원문 참조.
- Everything — 공식 하위 절. 구현·설정 세부 원문 참조.
cd ~/.hermes/hermes-agent && uv pip install -e ".[voice]"
3단계: 시스템 의존성
원문 절: Step 3: install system dependencies
- macOS — 공식 하위 절. 구현·설정 세부 원문 참조.
- Ubuntu / Debian — 공식 하위 절. 구현·설정 세부 원문 참조.
brew install portaudio ffmpeg opus
brew install espeak-ng
4단계: STT/TTS provider
원문 절: Step 4: choose STT and TTS providers
- Easiest / cheapest setup — 공식 하위 절. 구현·설정 세부 원문 참조.
- Environment file example — 공식 하위 절. 구현·설정 세부 원문 참조.
- Provider recommendations — 공식 하위 절. 구현·설정 세부 원문 참조.
- If you use
hermes setup— 공식 하위 절. 구현·설정 세부 원문 참조.
# Cloud STT options (local needs no key)
GROQ_API_KEY=***
VOICE_TOOLS_OPENAI_KEY=***
# Premium TTS (optional)
ELEVENLABS_API_KEY=***
5단계: 권장 설정
원문 절: Step 5: recommended config
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
voice:
record_key: "ctrl+b"
max_recording_seconds: 120
auto_tts: false
beep_enabled: true
silence_threshold: 200
silence_duration: 3.0
stt:
provider: "local"
local:
model: "base"
tts:
provider: "edge"
edge:
voice: "en-US-AriaNeural"
유스케이스 1: CLI
원문 절: Use case 1: CLI voice mode
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
Turn it on
- Recording flow — 공식 하위 절. 구현·설정 세부 원문 참조.
- Useful commands — 공식 하위 절. 구현·설정 세부 원문 참조.
- Good CLI workflows — 공식 하위 절. 구현·설정 세부 원문 참조.
- press
Ctrl+B - speak
- wait for silence detection to stop recording automatically
hermes
Tuning CLI behavior
- Silence threshold — 공식 하위 절. 구현·설정 세부 원문 참조.
- Silence duration — 공식 하위 절. 구현·설정 세부 원문 참조.
- Record key — 공식 하위 절. 구현·설정 세부 원문 참조.
voice:
silence_threshold: 250
Use case 2: voice replies in Telegram or Discord
- Start the gateway — 공식 하위 절. 구현·설정 세부 원문 참조.
- Turn on voice replies — 공식 하위 절. 구현·설정 세부 원문 참조.
- Modes — 공식 하위 절. 구현·설정 세부 원문 참조.
- When to use which mode — 공식 하위 절. 구현·설정 세부 원문 참조.
- Good messaging workflows — 공식 하위 절. 구현·설정 세부 원문 참조.
| Mode | Meaning |
|---|---|
off |
text only |
voice_only |
speak only when the user sent voice |
all |
speak every reply |
hermes gateway
Use case 3: Discord voice channels
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
Required Discord permissions
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
Join and leave
- What happens when joined — 공식 하위 절. 구현·설정 세부 원문 참조.
- Best practices for Discord VC use — 공식 하위 절. 구현·설정 세부 원문 참조.
/voice join
/voice leave
/voice status
Voice quality recommendations
- Best quality setup — 공식 하위 절. 구현·설정 세부 원문 참조.
- Best speed / convenience setup — 공식 하위 절. 구현·설정 세부 원문 참조.
- Best zero-cost setup — 공식 하위 절. 구현·설정 세부 원문 참조.
Common failure modes
- "No audio device found" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "Bot joins but hears nothing" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "It transcribes but does not speak" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "Whisper outputs garbage" — 공식 하위 절. 구현·설정 세부 원문 참조.
- "It works in DMs but not in server channels" — 공식 하위 절. 구현·설정 세부 원문 참조.
Suggested first-week setup
- get text Hermes working
- run
hermes setup voiceto enable voice support - use CLI voice mode with local STT + Edge TTS
- then enable
/voice onin Telegram or Discord - only after that, try Discord VC mode
Where to read next
- 이 절의 절차·표·코드는 공식 원문을 기준으로 적용한다.
체크리스트
- 공식 원문 Use Voice Mode with Hermes과 대조했다
- 관련 코드·설정·권한을 로컬에서 확인했다
- 보안·opt-in·allowlist 정책을 지켰다
- 스모크 테스트 또는 단계 검증을 수행했다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스