dustynv/wyoming-assist-microphone Docker 镜像 - 轩辕镜像

assist-microphone

容器 镜像 运行 构建

Home Assistant 附加组件，使用 wyoming-satellite 在 NVIDIA Jetson 设备上通过 wyoming协议 实现远程语音卫星功能。感谢 @ms1design 贡献这些 Home Assistant 和 Wyoming 容器！

核心功能

• 与 Jetson设备 上的 home-assistant-core 容器以及不同主机上的 Home Assistant 兼容
• 使用 wyoming-openwakeword 容器进行唤醒词检测
• 使用 wyoming-whisper 容器处理语音转文本(STT)
• 使用 wyoming-piper 容器处理文本转语音(TTS)

要求 Home Assistant 2023.9 或更高版本。

docker-compose 示例

若要在启用 cuda 的 Jetson 设备上使用 docker compose 运行 Home Assistant Core 语音助手管道，可参考完整示例 docker-compose.yaml。

yaml
name: home-assistant-jetson
version: "3.9"
services:
  homeassistant:
    image: dustynv/homeassistant-core:latest-r36.2.0
    restart: unless-stopped
    init: false
    privileged: true
    network_mode: host
    container_name: homeassistant
    hostname: homeassistant
    ports:
      - "8123:8123"
    volumes:
      - ha-config:/config
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro

  assist-microphone:
    image: dustynv/wyoming-assist-microphone:latest-r36.2.0
    restart: unless-stopped
    network_mode: host
    container_name: assist-microphone
    hostname: assist-microphone
    runtime: nvidia
    init: false
    ports:
      - "***:***/tcp"
    devices:
      - /dev/snd:/dev/snd
      - /dev/bus/usb
    volumes:
      - ha-assist-microphone:/share
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    environment:
      SATELLITE_AUDIO_DEVICE: "plughw:CARD=S330,DEV=0"
      SATELLITE_SND_VOLUME_MULTIPLIER: 0.3
      WAKEWORD_NAME: "ok_nabu"
      ASSIST_PIPELINE_NAME: "Home Assistant"

volumes:
  ha-config:
  ha-assist-microphone:

环境变量

配置

有关 wyoming-assist-microphone 的详细配置方法，请参考 官方文档。

确定音频设备

选择正确的麦克风/扬声器设备对卫星功能至关重要。

列出可用麦克风：

bash
arecord -L

列出可用扬声器：

bash
aplay -L

两个命令的输出应类似如下：

bash
plughw:CARD=seeed2micvoicec,DEV=0
    seeed-2mic-voicecard, bcm2835-i2s-wm8960-hifi wm8960-hifi-0
    Hardware device with all software conversions

建议选择以 plughw: 开头的设备，或在不确定时使用 default。推荐选择标注有“Hardware device with all software conversions”的麦克风和扬声器。将环境变量 SATELLITE_AUDIO_DEVICE 设置为：

bash
plughw:CARD=seeed2micvoicec,DEV=0

wyoming-assist-microphone 使用同一设备作为麦克风和扬声器。

待办事项

• 研究当通过 ASSIST_PIPELINE_NAME 指定对话管道名称时，用户是否应在Home Assistant Assist聊天弹窗中看到语音命令和响应的转录文本。
• 将 SATELLITE_AUDIO_DEVICE 拆分为 SATELLITE_MIC_DEVICE 和 SATELLITE_SND_DEVICE，以支持选择不同的音频硬件组合。

支持

有问题？您可以通过以下方式获取帮助：

一般 Home Assistant 支持：

• Home Assistant ***聊天服务器
• Home Assistant 社区论坛
• 加入Reddit子版块 /r/homeassistant
• 如发现Home Assistant bug，请在GitHub上提交issue

NVIDIA Jetson 基于Home Assistant的支持：

• NVIDIA Jetson AI Lab 教程部分
• Jetson AI Lab - Home Assistant集成 NVIDIA开发者论坛线程
• 如发现jetson-containers bug，请在GitHub上提交issue

[!NOTE] 本项目由 Jetson AI Lab研究组 创建。

bash
# 自动拉取或构建兼容的容器镜像
jetson-containers run $(autotag assist-microphone)

# 或使用'docker run'（指定镜像和挂载等）
sudo docker run --runtime nvidia -it --rm --network=host assist-microphone:35.2.1

bash
jetson-containers run -v /主机路径:/容器路径 $(autotag assist-microphone)

bash
jetson-containers run $(autotag assist-microphone) my_app --abc xyz

bash
jetson-containers build assist-microphone