Add JavaScript (WebAssembly) example for ZipVoice TTS (#3341)

Author: csukuangfj

.github/scripts/test-nodejs-npm.sh

@@ -157,6 +157,17 @@ rm -fv enhanced*.wav
 
 # offline tts
 
+curl -SL -O https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+tar xf sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+rm sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+
+curl -SL -O https://github.com/k2-fsa/sherpa-onnx/releases/download/vocoder-models/vocos_24khz.onnx
+
+node ./test-offline-tts-zipvoice-zh-en.js
+ls -lh *.wav
+rm -rf sherpa-onnx-zipvoice-distill-int8-zh-en-emilia
+rm -f vocos_24khz.onnx
+
 curl -SL -O https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/kokoro-multi-lang-v1_0.tar.bz2
 tar xf kokoro-multi-lang-v1_0.tar.bz2
 rm kokoro-multi-lang-v1_0.tar.bz2

nodejs-examples/README.md

@@ -81,6 +81,24 @@ node ./test-offline-speaker-diarization.js
 
 In the following, we demonstrate how to run text-to-speech.
 
+## ./test-offline-tts-zipvoice-zh-en.js
+
+[./test-offline-tts-zipvoice-zh-en.js](./test-offline-tts-zipvoice-zh-en.js)
+shows how to use ZipVoice for Zero-shot TTS in Chinese and English.
+
+Please make sure that the reference transcript matches the reference audio.
+
+You can use the following command to run it:
+```bash
+curl -SL -O https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+tar xf sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+rm sherpa-onnx-zipvoice-distill-int8-zh-en-emilia.tar.bz2
+
+curl -SL -O https://github.com/k2-fsa/sherpa-onnx/releases/download/vocoder-models/vocos_24khz.onnx
+
+node ./test-offline-tts-zipvoice-zh-en.js
+```
+
 ## ./test-offline-tts-pocket-en.js
 
 [./test-offline-tts-pocket-en.js](./test-offline-tts-pocket-en.js)

nodejs-examples/test-offline-tts-zipvoice-zh-en.js

@@ -0,0 +1,52 @@
+// Copyright (c)  2026  Xiaomi Corporation (authors: Fangjun Kuang)
+
+const sherpa_onnx = require('sherpa-onnx');
+
+function createOfflineTts() {
+  const zipvoice = {
+    encoder: './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/encoder.int8.onnx',
+    decoder: './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/decoder.int8.onnx',
+    tokens: './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/tokens.txt',
+    lexicon: './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/lexicon.txt',
+    dataDir: './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/espeak-ng-data',
+    vocoder: './vocos_24khz.onnx',
+  };
+
+  const offlineTtsModelConfig = {
+    offlineTtsZipVoiceModelConfig: zipvoice,
+    numThreads: 1,
+    debug: 1,  // set it to 1 to see verbose logs; 0 to disable logs
+    provider: 'cpu',
+  };
+
+  const offlineTtsConfig = {
+    offlineTtsModelConfig: offlineTtsModelConfig,
+    maxNumSentences: 1,
+  };
+
+  return sherpa_onnx.createOfflineTts(offlineTtsConfig);
+}
+
+const referenceWaveFilename =
+    './sherpa-onnx-zipvoice-distill-int8-zh-en-emilia/test_wavs/leijun-1.wav';
+const wave = sherpa_onnx.readWave(referenceWaveFilename);
+
+const referenceText =
+    '那还是三十六年前, 一九八七年. 我呢考上了武汉大学的计算机系.';
+const text =
+    '小米的价值观是真诚, 热爱. 真诚，就是不欺人也不自欺. 热爱, 就是全心投入并享受其中.';
+
+const generationConfig = {
+  referenceAudio: wave.samples,
+  referenceSampleRate: wave.sampleRate,
+  // It must match the transcript of the reference audio above.
+  referenceText: referenceText,
+  numSteps: 4,
+  extra: {min_char_in_sentence: 10},
+};
+
+const tts = createOfflineTts();
+const audio = tts.generateWithConfig(text, generationConfig);
+tts.save('./test-zipvoice-zh-en.wav', audio);
+console.log('Saved to test-zipvoice-zh-en.wav successfully.');
+tts.free();