什么是 Whisper Turbo？

Whisper Turbo 是一个快速、跨平台的 Whisper 实现，专为在您的浏览器或 Electron 应用中完全运行于客户端而设计。

请查看 Whisper Turbo 背后的 Rust 库 Ratchet。

演示

https://github.com/FL33TW00D/whisper-turbo/assets/45471420/1e19aa1f-bb56-4b5c-bc00-e79aabb4d1e0

支持的平台

WebGPU 目前仅正式支持基于 Chromium 的浏览器，且运行在 Windows 和 macOS 上。 更多信息，请参阅 支持的平台。

想参与进来吗？

• 您是 GPU 方面的高手吗？
• 您知道 Rust 中的 HRTB 是什么吗？
• 您了解 这里 发生了什么吗？
• 请联系：chris@fleetwood.dev

Whisper Turbo 快速上手指南

Whisper Turbo 是一个高性能、跨平台的 Whisper 实现，专为在浏览器或 Electron 应用中完全客户端运行而设计。它利用 WebGPU 技术加速推理，无需后端服务器即可实现语音转文字。

环境准备

系统要求

• 操作系统：Windows 或 macOS（Linux 支持尚在实验中）
• 浏览器：基于 Chromium 的浏览器（如 Chrome, Edge），需开启 WebGPU 支持
  • 注意：WebGPU 目前仅在 Windows 和 macOS 上的 Chromium 内核浏览器中获得官方支持。
• 硬件：支持 WebGPU 的 GPU（推荐近期发布的独立显卡或集成显卡）

前置依赖

由于该项目主要作为库集成或在演示站点运行，普通用户可直接访问 Demo，开发者需准备以下环境：

• Node.js (v18+)
• npm 或 yarn
• Rust (可选，用于构建底层的 Ratchet 库)

提示：国内开发者若遇到 npm 安装缓慢，建议使用淘宝镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

Whisper Turbo 通常作为 JavaScript/TypeScript 库集成到项目中。

1. 初始化项目（如尚未创建）

   mkdir my-whisper-app
   cd my-whisper-app
   npm init -y
   

2. 安装 Whisper Turbo

   npm install whisper-turbo
   

3. 安装底层依赖（如需自定义构建） 如果需要使用底层的 Rust 库 Ratchet 进行深度定制，请确保已安装 Rust，然后克隆仓库：

   git clone https://github.com/FL33TW00D/whisper-turbo.git
   cd whisper-turbo
   # 遵循 Ratchet 文档构建 Rust 后端
   

基本使用

以下是在前端项目中调用 Whisper Turbo 进行语音识别的最简示例。

1. 引入库并初始化

在你的 JavaScript/TypeScript 文件中：

import { WhisperTurbo } from 'whisper-turbo';

// 初始化模型
const whisper = new WhisperTurbo({
  model: 'base', // 可选: tiny, base, small, medium, large
  device: 'webgpu' // 强制使用 WebGPU 加速
});

await whisper.load();

2. 执行语音转录

加载音频文件（支持 Blob 或 File 对象）并进行转录：

async function transcribeAudio(file) {
  try {
    const result = await whisper.transcribe(file, {
      language: 'zh', // 指定语言，例如中文 'zh'
      task: 'transcribe' // 或 'translate'
    });
    
    console.log('识别结果:', result.text);
  } catch (error) {
    console.error('转录失败:', error);
  }
}

// 示例：绑定文件输入框
document.getElementById('audioInput').addEventListener('change', (e) => {
  const file = e.target.files[0];
  if (file) transcribeAudio(file);
});

3. 在线体验

无需安装，直接访问官方演示站点测试效果：

• Demo Site
• 完整文档