Des enregistrements
à une voix.

Intégrer Piper dans un projet Node.js avec pipertts

pipertts expose Piper dans Node.js, avec écriture de fichiers ou retour audio en mémoire. Le mode recommandé est PiperNativeTTS : inférence 100 % native en processus (ONNX + pont espeak compilé), sans Python, environ 10 fois plus rapide que le wrapper. Les voix (.onnx + .onnx.json) restent des fichiers séparés.

1. 01

   Installer les dépendances

   La documentation annonce Node.js 18+ et TypeScript 5+. Le mode natif ne demande rien d’autre : un npm install suffit. Le mode wrapper classique (PiperTTS via python3 -m piper) exige en plus Python et le module Piper. La sélection par identifiant de catalogue peut télécharger le modèle et sa configuration dans models/.

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

2. 02

   Démarrage avec une voix du catalogue

   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

   Utiliser un modèle local

   Pour une voix téléchargée manuellement, passez le chemin du fichier ONNX. Le fichier .onnx.json associé doit être placé à côté ; vous pouvez préciser configPath si son emplacement diffère.

   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 et formats

   synthesize() retourne audio (Buffer), sampleRate et text ; outputFile écrit aussi sur disque. Options : speakerId (multi-voix et multi-styles), lengthScale (> 1 ralentit, < 1 accélère), noiseScale, noiseWScale, sentenceSilence, normalizeAudio, volume et outputFormat (wav, raw, mp3, ogg ou opus). mp3 et opus ont des solutions JS pures ; ogg demande FFmpeg. phonemize() et synthesizeChunks() donnent accès au bas niveau, phrase par phrase.

5. 05

   Wrapper legacy (PiperTTS)

   PiperTTS lance python3 -m piper, un processus par synthèse : environ 10 fois plus lent, à réserver aux environnements où le moteur natif ne tourne pas. Exige Python et le module 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");

   Page npm de pipertts ↗Dépôt GitHub de pipertts ↗Documentation et exemples pipertts ↗