captnspdr/wyoming-glados

wyoming-glados Docker镜像文档

镜像概述

wyoming-glados是一个遵循Wyoming协议的容器化语音处理服务，旨在提供高效的语音合成（TTS）与语音识别（STT）能力。该镜像基于轻量级容器架构，可无缝对接Wyoming服务器及相关客户端，为智能家居、语音助手等应用提供底层语音交互支持。

核心功能与特性

• Wyoming协议兼容：严格遵循Wyoming协议规范，支持与Home Assistant等智能家居系统及Wyoming生态组件通信。
• 双功能集成：同时提供语音合成（文本转语音）和语音识别（语音转文本）能力，满足双向语音交互需求。
• 轻量化部署：容器化设计减少依赖冲突，支持快速启停和资源隔离，适配边缘设备及服务器环境。
• 可定制配置：支持通过环境变量或配置文件调整端口、日志级别、语音模型参数等，适配不同场景需求。

使用场景与适用范围

• 智能家居系统：作为语音交互核心组件，实现设备语音控制、状态播报（如"灯光已打开"）等功能。
• 语音助手应用：为自定义语音助手提供底层语音处理能力，支持命令识别（如"查询天气"）与语音响应生成。
• 自动化语音交互：适用于客服机器人、语音通知系统等场景，实现无人值守的语音信息处理。
• 开发测试环境：为语音应用开发者提供本地快速部署的服务实例，加速功能验证与调试。

使用方法与配置说明

基础部署（Docker Run）

通过以下命令启动服务：

bash
docker run -d \
  --name wyoming-glados \
  -p 10300:10300 \
  -v ./wyoming-config:/config \
  -e LOG_LEVEL=info \
  docker.xuanyuan.run/jonahmmay/wyoming-glados:latest

参数说明：

• -p 10300:10300：映射容器默认端口（***）到主机，用于Wyoming协议通信。
• -v ./wyoming-config:/config：挂载主机目录至容器/config，持久化配置文件与模型数据。
• -e LOG_LEVEL=info：设置日志级别，可选值：debug（调试）、info（常规）、warn（警告）、error（错误）。

Docker Compose配置

创建docker-compose.yml文件实现编排部署：

yaml
version: '3.8'
services:
  wyoming-glados:
    image: docker.xuanyuan.run/jonahmmay/wyoming-glados:latest
    container_name: wyoming-glados
    ports:
      - "10300:10300"  # 协议通信端口
    volumes:
      - ./wyoming-config:/config  # 配置与模型持久化目录
    environment:
      - PORT=10300  # 服务监听端口
      - LOG_LEVEL=info  # 日志级别
      - TTS_VOICE=default  # 默认TTS语音（依模型支持而定）
      - STT_LANGUAGE=en-US  # 默认STT识别语言（支持zh-CN、en-GB等）
    restart: unless-stopped  # 异常退出后自动重启

启动服务：

bash
docker-compose up -d

环境变量配置

注意事项

• 首次启动时，容器会在/config目录生成默认配置文件（如settings.json），可通过主机挂载目录修改配置，重启后生效。
• 自定义语音模型需放置于/config/models目录，并在配置文件中指定模型路径。
• 生产环境建议限制容器资源（如--memory=512m），避免资源耗尽。