Das gravações
à voz.

Integrar o Piper num projeto Node.js com pipertts

O pipertts expõe o Piper em Node.js, com escrita de ficheiros ou áudio em memória. O modo recomendado é PiperNativeTTS: inferência 100% nativa em processo (ONNX + ponte espeak compilada), sem Python, cerca de 10 vezes mais rápida que o wrapper. As vozes (.onnx + .onnx.json) continuam a ser ficheiros separados.

1. 01

   Instalar as dependências

   A documentação anuncia Node.js 18+ e TypeScript 5+. O modo nativo não exige mais nada: basta um npm install. O modo wrapper clássico (PiperTTS via python3 -m piper) exige ainda Python e o módulo Piper. A seleção por identificador de catálogo pode descarregar o modelo e a sua configuração para models/.

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

2. 02

   Início rápido com uma voz do 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 um modelo local

   Para uma voz descarregada manualmente, passa o caminho do ficheiro ONNX. O ficheiro .onnx.json associado deve estar ao lado; podes indicar configPath se a localização for diferente.

   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 formatos

   synthesize() devolve audio (Buffer), sampleRate e text; outputFile também grava em disco. Opções: speakerId (várias vozes e estilos), lengthScale (> 1 torna mais lento, < 1 acelera), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume e outputFormat (wav, raw, mp3, ogg ou opus). mp3 e opus têm soluções JS puras; ogg exige FFmpeg. phonemize() e synthesizeChunks() dão acesso de baixo nível, frase a frase.

5. 05

   Wrapper legado (PiperTTS)

   O PiperTTS lança python3 -m piper, um processo por síntese: cerca de 10 vezes mais lento, a reservar para ambientes onde o motor nativo não funciona. Exige Python e o 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 ↗Repositório GitHub de pipertts ↗Documentação e exemplos pipertts ↗