dustynv/whisper

whisper

概述

whisper镜像是jetson-containers项目中的音频处理容器，提供基于Whisper语音识别模型的Jupyter Lab开发环境。该镜像包含Whisper原始notebooks（LibriSpeech.ipynb、Multilingual_ASR.ipynb）及jetson-containers添加的record-and-transcribe.ipynb，适用于Jetson设备，支持通过Jupyter Lab进行交互式音频转录、多语言语音识别等任务。

核心功能与特性

• 内置Whisper开发资源：容器内/opt/whisper/notebooks目录包含Whisper官方notebooks及录音转录专用notebook，开箱即可进行语音识别实验
• 自动Jupyter Lab启动：默认通过Dockerfile的CMD命令自动启动Jupyter Lab，无需手动配置
• HTTPS安全访问：启用SSL加密连接，支持麦克风访问（需处理浏览器安全警告）
• 完整依赖集成：预装CUDA、PyTorch、torchaudio、JupyterLab等必要组件，满足Whisper运行需求
• JetPack兼容性：支持L4T R35.x及以上版本（JetPack 5.1+），提供多版本镜像选择

使用场景

• Jetson设备上的语音识别模型开发与测试
• 多语言自动语音识别（ASR）任务验证
• 实时音频录制与转录功能原型开发
• 通过Jupyter notebooks进行交互式语音处理算法调试

使用方法

运行容器

方式1：使用jetson-containers（推荐）

bash
# 自动拉取或构建兼容当前JetPack版本的镜像
jetson-containers run $(autotag whisper)

# 或指定具体镜像标签
jetson-containers run dustynv/whisper:r35.3.1

方式2：直接使用docker run

bash
sudo docker run --runtime nvidia -it --rm --network=host dustynv/whisper:r35.3.1

挂载外部目录

如需将主机目录挂载到容器内，使用-v参数：

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

运行指定命令

以非交互式方式运行命令（而非默认shell）：

bash
jetson-containers run $(autotag whisper) your_command --option value

访问Jupyter Lab

1. 容器启动后，通过浏览器访问 http://<主机名>:8888
2. 由于启用HTTPS，浏览器会显示SSL安全警告，点击高级→继续访问<IP地址>（不安全）
3. 输入密码：nvidia 登录Jupyter Lab
4. 日志位置：容器内 /var/log/jupyter.log

Jupyter Lab默认启动命令

容器通过以下CMD自动启动Jupyter Lab：

bash
CMD /bin/bash -c "jupyter lab --ip 0.0.0.0 --port 8888  --certfile=mycert.pem --keyfile mykey.key --allow-root &> /var/log/jupyter.log" & \
    echo "allow 10 sec for JupyterLab to start @ https://$(hostname -I | cut -d' ' -f1):8888 (password nvidia)" && \
    echo "JupterLab logging location:  /var/log/jupyter.log  (inside the container)" && \
    /bin/bash

构建容器

自动构建

使用autotag时，若本地无兼容镜像，系统会提示自动构建：

bash
jetson-containers run $(autotag whisper)

手动构建

1. 先完成https://github.com/dusty-nv/jetson-containers/tree/master/docs/setup.md
2. 执行构建命令：

bash
jetson-containers build whisper

可添加--help查看构建选项：jetson-containers build whisper --help

容器信息

基础信息

可用镜像

兼容性说明：

• L4T R32.7容器可运行于其他L4T R32.7版本（JetPack 4.6+）
• L4T R35.x容器可运行于其他L4T R35.x版本（JetPack 5.1+）