StreamAssist: 打造本地化的语音助手

StreamAssist: 打造本地化的语音助手

StreamAssistHome Assistant custom component that allows you to turn almost any camera and almost any speaker into a local voice assistant项目地址:https://gitcode.com/gh_mirrors/st/StreamAssist

项目介绍

StreamAssist 是一个专为 Home Assistant 设计的自定义组件，旨在将几乎任何摄像头与扬声器转化为一个本地语音助手系统。该组件通过流媒体集成接收来自摄像头（支持 RTSP、HTTP、RTMP）的音频，并自动转码为适合语音识别的格式。它利用了 Speech-to-Text (STT) 和 Text-to-Speech (TTS) 的处理流程，可以与多种核心插件或自定义集成协同工作，如 openWakeWord 进行唤醒词检测、Whisper 或 Piper 进行本地 STT 和 TTS。此外，还支持使用Google Translate进行云端TTS。

项目快速启动

安装步骤

1. 通过HACS安装:

   • 登录Home Assistant。
   • 转至“集成”页面，点击右上角的三个点，选择“自定义仓库”。
   • 输入仓库URL: AlexxIT/StreamAssist，类别选择“集成”，然后添加仓库并等待同步完成。
   • 在“自定义集成”列表中找到“Stream Assist”，点击安装。

2. 手动安装:

   • 下载最新版本的stream_assist文件夹。
   • 将其复制到Home Assistant配置目录下的custom_components文件夹内。

3. 配置示例: 编辑您的configuration.yaml文件，加入以下基本配置（基于默认管道，以特定相机和媒体播放器为例）:

   stream_assist:
     mic_source: camera.your_camera_entity
     pipeline_id: default
     stt_start_media: 'media-source://media_source/local/beep.mp3'
     player_entities:
       - media_player.your_speaker_entity
   

命令行服务运行示例

若要更灵活地控制，可以通过服务调用来指定参数:

service: stream_assist.run
data:
  stream_source: rtsp://your_stream_url
  camera_entity_id: camera.xxx
  player_entity_id: media_player.xxx
  stt_start_media: media-source://media_source/local/beep.mp3
  pipeline_id: abcdefg
  assist: start_stage:

应用案例和最佳实践

• 家庭自动化场景: 配置StreamAssist与智能摄像头相连，当家中有人时，仅需简单的口头命令就能控制智能家居设备，如开关灯光、调整恒温器温度等。
• 安全监控: 结合醒词检测，实现无人值守环境下的语音警报触发，提升家庭安防系统的交互性。
• 个性化音乐控制: 使用特定命令控制音乐播放器，实现无需动手即可切换歌曲或调整音量。

典型生态项目结合

StreamAssist因其灵活性可与Home Assistant生态系统中的多个项目整合，例如：

• WebRTC Camera: 支持双向音频的摄像头可通过自定义集成转换成语音交互终端，增强远程通讯功能。
• openWakeWord 和 Whisper: 利用这些插件提供高效的本地唤醒词和STT服务，减少对云服务的依赖。
• Piper 或 Faster Whisper: 提供多样化的本地TTS选项，满足不同语言及音质需求。

通过上述步骤和策略，您可以高效地部署和定制StreamAssist，将其融入您的智能家居系统之中，享受便捷的本地化语音控制体验。

StreamAssistHome Assistant custom component that allows you to turn almost any camera and almost any speaker into a local voice assistant项目地址:https://gitcode.com/gh_mirrors/st/StreamAssist