{"repo":"NousResearch/hermes-agent","public_id":"29782","display_label":"faster-whisper voice STT setup and install fixes","summary":"These items cover adding local Whisper transcription support via faster-whisper and fixing related installation instructions, including venv targeting, Docker issues, and lazy-install behavior on first use.","subsystem":"docs","counts":{"members":6,"open_issues":0,"open_issues_distinct":0,"open_prs":0,"closed_issues":2,"merged_prs":2,"attempt_prs":2},"landed_fix":{"status":"merged_to_main","basis":"structural","pr":29800},"resolution":{"state":"partially_resolved","by":"pr-29800"},"freshness":{"state":"verified","last_verified_at":"2026-07-28T18:57:37+00:00","is_stale":false},"grouping":{"backbone":"STRUCTURAL_PARTIAL","link_density":0.29066666666666663},"fix_edges":[{"issue_number":8098,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":21088,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":29782,"pr_number":29800,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true},{"issue_number":31015,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":38831,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":38893,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":44364,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":67545,"pr_number":73520,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false}],"members":[{"kind":"issue","number":29782,"title":"[Bug]: I can not install voice for Telegram in Docker","url":null,"state":"closed"},{"kind":"issue","number":44364,"title":"Docs: voice extra install command fails unless installer venv is activated or targeted","url":null,"state":"closed"},{"kind":"pr","number":29800,"title":"docs(voice): use `uv pip install faster-whisper` in STT install hints","url":null,"state":"merged","close_reason":{"category":"merged","implication":"superseded"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["cli.py","gateway/run.py","tools/voice_mode.py"],"fix_hunks":[{"file":"cli.py","hunks":["@@ -10640,7 +10640,8 @@ def _voice_start_recording(self):\n         if not reqs.get(\"stt_available\", reqs.get(\"stt_key_set\")):\n             raise RuntimeError(\n                 \"Voice mode requires an STT provider for transcription.\\n\"\n-                \"Option 1: pip install faster-whisper  (free, local)\\n\"\n+                \"Option 1: uv pip install faster-whisper  \"\n+                \"(free, local; `pip install faster-whisper` also works if pip is on PATH)\\n\"\n                 \"Option 2: Set GROQ_API_KEY (free tier)\\n\"\n                 \"Option 3: Set VOICE_TOOLS_OPENAI_KEY (paid)\"\n             )"]},{"file":"gateway/run.py","hunks":["@@ -7938,7 +7938,8 @@ async def _prepare_inbound_message_text(\n                                 \"🎤 I received your voice message but can't transcribe it — \"\n                                 \"no speech-to-text provider is configured.\\n\\n\"\n                                 \"To enable voice: install faster-whisper \"\n-                                \"(`pip install faster-whisper` in the Hermes venv) \"\n+                                \"(`uv pip install faster-whisper` in the Hermes venv; \"\n+                                \"`pip install faster-whisper` also works if pip is on PATH) \"\n                                 \"and set `stt.enabled: true` in config.yaml, \"\n                                 \"then /restart the gateway.\"\n                             )"]},{"file":"tools/voice_mode.py","hunks":["@@ -1077,7 +1077,8 @@ def check_voice_requirements() -> Dict[str, Any]:\n         details_parts.append(\"STT provider: OK (OpenAI)\")\n     else:\n         details_parts.append(\n-            \"STT provider: MISSING (pip install faster-whisper, \"\n+            \"STT provider: MISSING (uv pip install faster-whisper — \"\n+            \"`pip install faster-whisper` also works if pip is on PATH, \"\n             \"or set GROQ_API_KEY / VOICE_TOOLS_OPENAI_KEY)\"\n         )\n \n"]}]},{"kind":"pr","number":29815,"title":"fix(stt): lazy-install faster-whisper on first voice message (#29782)","url":null,"state":"closed","close_reason":{"refs":[{"kind":"pr","value":"#29800","number":29800}],"category":"partial_fix","implication":"needs_llm"},"merged":false},{"kind":"pr","number":44367,"title":"fix(docs): target installer venv in voice extra install command","url":null,"state":"closed","close_reason":{"refs":[{"kind":"commit","value":"e04c2a9ebd","number":0},{"kind":"pr","value":"#73520","number":73520}],"category":"merged_via","implication":"superseded"},"merged":false},{"kind":"pr","number":73520,"title":"fix(voice): CLI/TUI voice mode UX and environment fixes (15 items)","url":null,"state":"merged","close_reason":{"category":"merged","implication":"superseded"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["cli.py","contributors/emails/[redacted:email]","contributors/emails/[redacted:email]","contributors/emails/[redacted:email]","contributors/emails/[redacted:email]","contributors/emails/[redacted:email]","contributors/emails/[redacted:email]","hermes_cli/config.py","hermes_cli/voice.py","tests/hermes_cli/test_voice_wrapper.py","tests/test_tui_gateway_server.py","tests/test_voice_max_recording_seconds.py","tests/tools/test_clipboard.py","tests/tools/test_termux_api_detection.py","tests/tools/test_tts_macos_output.py","tests/tools/test_voice_cli_integration.py","tests/tools/test_voice_mode.py","tests/tools/test_voice_wsl_pipewire.py","tools/tts_tool.py","tools/voice_mode.py","tui_gateway/server.py","website/docs/getting-started/quickstart.md","website/docs/user-guide/configuration.md","website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/getting-started/quickstart.md"]}],"trust":{"default_tier":"verified","includes_suggested":false}}