Piper Tts Docker 镜像

piper-tts 镜像文档

镜像概述和主要用途

piper-tts是为Jetson嵌入式平台优化的文本转语音(TTS) Docker镜像，基于Piper TTS引擎构建。该镜像集成GPU加速能力，依赖CUDA、cuDNN、TensorRT等深度学习框架，提供低延迟、高效能的语音合成功能，适用于资源受限环境下的实时语音生成任务。

核心功能和特性

• GPU加速：利用Jetson设备的CUDA和TensorRT加速，提升语音合成推理速度
• 完整依赖链：包含build-essential、Python、NumPy、ONNX、ONNX Runtime等基础组件，确保TTS功能完整运行
• 生态兼容性：作为wyoming-piper等智能家居语音组件的依赖项，支持语音交互系统集成
• 多版本支持：兼容L4T R35.x（JetPack 5.1+）和R36.x等Jetson系统版本

使用场景和适用范围

• Jetson系列设备（Nano、Xavier、Orin等）上的嵌入式语音合成应用
• 智能家居语音助手、语音提示系统等实时交互场景
• 资源受限环境下需要高效文本转语音的边缘计算应用
• 与wyoming协议集成的语音服务系统构建

容器镜像信息

兼容性说明：容器镜像兼容同主版本的其他JetPack/L4T次要版本：

• L4T R32.7容器支持JetPack 4.6+
• L4T R35.x容器支持JetPack 5.1+

运行容器

使用jetson-containers运行

通过jetson-containers run结合autotag自动匹配兼容镜像，或指定具体标签：

bash
# 自动拉取/构建兼容镜像
jetson-containers run $(autotag piper-tts)

# 显式指定镜像标签
jetson-containers run dustynv/piper-tts:r36.2.0

jetson-containers run默认添加--runtime nvidia、挂载/data缓存、检测设备等配置
autotag自动匹配当前JetPack/L4T版本兼容的镜像（本地/仓库拉取/构建）

使用docker run运行

手动指定镜像及运行参数：

bash
sudo docker run --runtime nvidia -it --rm --network=host dustynv/piper-tts:r36.2.0

挂载目录

使用-v参数挂载主机目录到容器：

bash
jetson-containers run -v /host/path:/container/path $(autotag piper-tts)

运行命令

启动容器时直接执行命令（非交互式shell）：

bash
jetson-containers run $(autotag piper-tts) my_app --abc xyz

构建容器

若需手动构建，先完成https://github.com/dusty-nv/jetson-containers/tree/master/docs/setup.md，然后运行：

bash
jetson-containers build piper-tts

构建过程会集成所有依赖项并进行测试，可通过--help查看构建选项：jetson-containers build piper-tts --help