Hermes 语音输入（STT）安装指南

完整的语音转写安装指南可以直接给新的hermes agent使用。Hermes 语音输入STT安装指南前置条件Hermes Agent 已安装有麦克风步骤1. 安装 faster-whisper语音识别引擎用 uv 装不要用 pipHermes 的 pip 有版本错乱问题代码· bash uv pip install faster-whisper1.02. 设置国内镜像如果翻墙了就跳过代码· bash set HF_ENDPOINThttps://hf-mirror.com3. 下载 whisper 模型首次需要下载代码· bash # 直接运行下面命令会自动从 HuggingFace 下载 small 模型 python -c from faster_whisper import WhisperModel model WhisperModel(small, devicecpu) print(✅ 下载并加载成功) 如果下载慢或失败有翻墙→直接重试没翻墙→先 set HF_ENDPOINThttps://hf-mirror.com 再用国内镜像4. 配置 Hermes代码· bash # 启用 STT hermes config set stt.enabled true hermes config set stt.provider local hermes config set stt.local.model small hermes config set stt.local.language zh # 设置录音快捷键默认 CtrlB改成不冲突的 hermes config set voice.record_key ctrlq5. 重启 Hermes新开一个会话生效。6. 使用在 Hermes 输入框中代码 按 CtrlQ → 听到提示音 → 说话 → 按 Enter → 文字自动填入全程离线、免费、不翻墙。如果遇到问题Q: 按快捷键没反应 → 快捷键被输入法/其他软件拦截了换一个代码· bash hermes config set voice.record_key ctrlmQ: ModuleNotFoundError: No module named faster_whisper → Hermes 的 pip 和 python 版本可能错位。用 uv pip install faster-whisper不要用 pip install。Q: ConnectTimeout / 下载超时 → 国内网络被墙了。有翻墙就开翻墙重试。没翻墙就代码· bash set HF_ENDPOINThttps://hf-mirror.com然后再跑第 3 步。