Dalle registrazioni
alla voce.

Integrare Piper in un progetto Node.js con pipertts

pipertts porta Piper in Node.js, con scrittura di file o audio in memoria. La modalità consigliata è PiperNativeTTS: inferenza 100 % nativa in processo (ONNX più ponte espeak compilato), senza Python, circa 10 volte più veloce del wrapper. Le voci (.onnx più .onnx.json) restano file separati.

1. 01

   Installare le dipendenze

   La documentazione indica Node.js 18+ e TypeScript 5+. La modalità nativa non chiede altro: basta un npm install. La modalità wrapper classica (PiperTTS con python3 -m piper) richiede in più Python e il modulo Piper. La selezione per identificativo di catalogo può scaricare modello e configurazione in models/.

   npm install pipertts
   # mode wrapper uniquement : python3 -m pip install piper-tts

2. 02

   Avvio rapido con una voce del catalogo

   import { PiperNativeTTS, resolveModelPathFromOptions } from "pipertts";
   import * as fs from "node:fs";
   
   const modelPath = await resolveModelPathFromOptions({
     model: "en_US-lessac-medium",
     modelsDir: "./models",
   });
   const tts = await PiperNativeTTS.load({ modelPath });
   
   const { audio } = await tts.synthesize("Hello from Piper.");
   fs.writeFileSync("./hello.wav", audio);

3. 03

   Usare un modello locale

   Per una voce scaricata a mano, passa il percorso del file ONNX. Il file .onnx.json associato deve stare accanto; puoi indicare configPath se si trova altrove.

   import { PiperNativeTTS } from "pipertts";
   
   const tts = await PiperNativeTTS.load({
     modelPath: "./models/my-voice.onnx",
   });
   const { audio, sampleRate } = await tts.synthesize("Hello.", { speakerId: 0 });

4. 04

   API e formati

   synthesize() restituisce audio (Buffer), sampleRate e text; outputFile scrive anche su disco. Opzioni: speakerId (più voci e stili), lengthScale (> 1 rallenta, < 1 accelera), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume e outputFormat (wav, raw, mp3, ogg o opus). mp3 e opus hanno soluzioni JS pure; ogg richiede FFmpeg. phonemize() e synthesizeChunks() danno accesso di basso livello, frase per frase.

5. 05

   Wrapper legacy (PiperTTS)

   PiperTTS avvia python3 -m piper, un processo per sintesi: circa 10 volte più lento, solo per ambienti dove il motore nativo non gira. Richiede Python e il modulo Piper.

   import { PiperTTS } from "pipertts";
   
   const tts = await PiperTTS.create({
     modelPath: "./models/en_US-lessac-medium.onnx",
   });
   await tts.synthesizeToFile("Hello from the legacy wrapper.", "./hello.wav");

   Pagina npm di pipertts ↗Repository GitHub di pipertts ↗Documentazione ed esempi di pipertts ↗