rhasspy/wyoming-openwakeword

镜像概述

本镜像为基于Wyoming协议的服务器，专为openWakeWord唤醒词检测系统设计，提供高效的唤醒词检测功能，支持模型预加载及自定义模型集成。

核心功能与特性

• 模型预加载：通过--preloaded-model参数可在启动时将指定模型加载至内存，避免首次请求时的加载延迟
• 自定义模型支持：支持挂载外部自定义模型目录，扩展唤醒词检测能力

使用场景

适用于需集成唤醒词检测功能的语音交互系统，如智能家居设备、语音助手、智能音箱等场景，尤其适合对唤醒词检测响应速度有要求或需使用特定自定义唤醒词模型的应用。

使用方法与配置说明

常规运行（预加载模型）

通过--preloaded-model参数指定启动时预加载的模型，示例命令如下：

sh
docker run -it -p 10400:10400 docker.xuanyuan.run/rhasspy/wyoming-openwakeword \
    --preload-model 'ok_nabu'

• -p 10400:10400：映射容器端口***至主机，用于服务通信
• --preload-model 'ok_nabu'：指定启动时预加载名为'ok_nabu'的模型

使用自定义模型

如需使用自定义模型，需挂载本地模型目录并通过--custom-model-dir参数指定路径，示例命令如下：

sh
docker run -it -p 10400:10400 -v /path/to/custom/models:/custom docker.xuanyuan.run/rhasspy/wyoming-openwakeword \
    --preload-model 'ok_nabu' \
    --custom-model-dir /custom

• -v /path/to/custom/models:/custom：将主机上的自定义模型目录/path/to/custom/models挂载至容器内/custom目录
• --custom-model-dir /custom：指定容器内自定义模型的存放目录，服务器将从该目录加载自定义模型

参数说明

• --preload-model <model_name>：可选，指定启动时预加载的模型名称（如'ok_nabu'）
• --custom-model-dir <path>：可选，指定自定义模型存放目录的路径，需配合-v参数挂载主机目录使用