De las grabaciones
a una voz.

Integrar Piper en un proyecto Node.js con pipertts

pipertts lleva Piper a Node.js, con escritura de archivos o audio en memoria. El modo recomendado es PiperNativeTTS: inferencia 100 % nativa en proceso (ONNX más puente espeak compilado), sin Python, unas 10 veces más rápida que el wrapper. Las voces (.onnx más .onnx.json) siguen siendo archivos separados.

1. 01

   Instalar las dependencias

   La documentación anuncia Node.js 18+ y TypeScript 5+. El modo nativo no pide nada más: basta un npm install. El modo wrapper clásico (PiperTTS con python3 -m piper) exige además Python y el módulo Piper. La selección por identificador de catálogo puede descargar el modelo y su configuración en models/.

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

2. 02

   Inicio rápido con una voz del catálogo

   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

   Usar un modelo local

   Para una voz descargada a mano, pasa la ruta del archivo ONNX. Su archivo .onnx.json asociado debe estar al lado; puedes indicar configPath si está en otro lugar.

   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 y formatos

   synthesize() devuelve audio (Buffer), sampleRate y text; outputFile también escribe en disco. Opciones: speakerId (varias voces y estilos), lengthScale (> 1 ralentiza, < 1 acelera), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volumen y outputFormat (wav, raw, mp3, ogg u opus). mp3 y opus tienen soluciones JS puras; ogg pide FFmpeg. phonemize() y synthesizeChunks() dan acceso de bajo nivel, frase por frase.

5. 05

   Wrapper heredado (PiperTTS)

   PiperTTS lanza python3 -m piper, un proceso por síntesis: unas 10 veces más lento, solo para entornos donde el motor nativo no funciona. Exige Python y el módulo 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");

   Página npm de pipertts ↗Repositorio GitHub de pipertts ↗Documentación y ejemplos de pipertts ↗