n8n-nodes-tts-bigboss 1.0.1 → 1.0.2

package/dist/TTSBigBoss.node.js

@@ -43,6 +43,10 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const child_process = __importStar(require("child_process"));
 const ws_1 = __importDefault(require("ws"));
+const https = __importStar(require("https"));
+const stream = __importStar(require("stream"));
+const util_1 = require("util");
+const pipeline = (0, util_1.promisify)(stream.pipeline);
 const EDGE_URL = 'wss://speech.platform.bing.com/consumer/speech/synthesize/readaloud/edge/v1?TrustedClientToken=6A5AA1D4EAFF4E9FB37E23D68491D6F4';
 const EDGE_VOICES = [
     { name: 'Arabic (Egypt) - Salma', value: 'ar-EG-SalmaNeural' },
@@ -71,7 +75,7 @@ class TTSBigBoss {
             icon: 'fa:comment-dots',
             group: ['transform'],
             version: 1,
-            description: 'Advanced Text-to-Speech (Edge-TTS & System Clone)',
+            description: 'Advanced Text-to-Speech (Edge-TTS & Local Standalone)',
             defaults: {
                 name: 'TTS BigBoss',
             },
@@ -89,9 +93,14 @@ class TTSBigBoss {
                             description: 'High quality, multilingual, supports Arabic & perfect subtitles. Requires internet.',
                         },
                         {
-                            name: 'System Command (Local/Clone)',
+                            name: 'Local Piper (Auto-Download)',
+                            value: 'piper_local',
+                            description: 'Downloads and runs Piper locally (Offline). Good quality, fast.',
+                        },
+                        {
+                            name: 'System Command (Custom)',
                             value: 'system',
-                            description: 'Use locally installed tools (Piper, XTTS, Coqui) via command line.',
+                            description: 'Use custom command for installed tools (XTTS, etc).',
                         },
                     ],
                     default: 'edge',
@@ -174,8 +183,8 @@ class TTSBigBoss {
                     displayName: 'Command',
                     name: 'systemCommand',
                     type: 'string',
-                    default: 'piper --model en_US-lessac-medium --output_file "{output_file}"',
-                    description: 'Command to execute. Use placeholders: "{text}" for input text, "{output_file}" for the temporary audio path.',
+                    default: 'echo "Custom command here" > "{output_file}"',
+                    description: 'Command to execute. Use placeholders: "{text}", "{output_file}".',
                     displayOptions: {
                         show: {
                             engine: ['system'],
@@ -207,6 +216,18 @@ class TTSBigBoss {
                     },
                     description: 'Binary property name containing the reference audio for cloning. Use placeholder "{reference_audio}" in command.',
                 },
+                {
+                    displayName: 'Piper Voice Model (HF URL or Path)',
+                    name: 'piperModel',
+                    type: 'string',
+                    default: 'en_US-lessac-medium',
+                    description: 'Enter a known Piper model name (e.g. "en_US-lessac-medium") which will be auto-downloaded, OR a full URL to the .onnx file.',
+                    displayOptions: {
+                        show: {
+                            engine: ['piper_local'],
+                        },
+                    },
+                }
             ],
         };
     }
@@ -214,6 +235,10 @@ class TTSBigBoss {
         const items = this.getInputData();
         const returnData = [];
         const tempDir = os.tmpdir();
+        const binDir = path.join(path.dirname(__dirname), 'bin');
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
         for (let i = 0; i < items.length; i++) {
             try {
                 const engine = this.getNodeParameter('engine', i);
@@ -231,7 +256,41 @@ class TTSBigBoss {
                     const pitch = this.getNodeParameter('edgePitch', i);
                     const result = await runEdgeTTS(text, voice, rate, pitch);
                     audioBuffer = result.audio;
-                    srtBuffer = Buffer.from(result.srt, 'utf8');
+                    if (!result.srt || result.srt.trim().length === 0) {
+                        srtBuffer = Buffer.from(generateHeuristicSRT(text, result.audio.length), 'utf8');
+                    }
+                    else {
+                        srtBuffer = Buffer.from(result.srt, 'utf8');
+                    }
+                }
+                else if (engine === 'piper_local') {
+                    const piperModel = this.getNodeParameter('piperModel', i);
+                    const piperBinPath = await ensurePiperBinary(binDir);
+                    const { modelPath, configPath } = await ensurePiperModel(binDir, piperModel);
+                    const outFile = path.join(tempDir, `piper_out_${(0, uuid_1.v4)()}.wav`);
+                    await new Promise((resolve, reject) => {
+                        const piperProc = child_process.spawn(piperBinPath, [
+                            '--model', modelPath,
+                            '--config', configPath,
+                            '--output_file', outFile
+                        ]);
+                        piperProc.stdin.write(text);
+                        piperProc.stdin.end();
+                        let errData = '';
+                        piperProc.stderr.on('data', (d) => errData += d.toString());
+                        piperProc.on('close', (code) => {
+                            if (code === 0)
+                                resolve();
+                            else
+                                reject(new Error(`Piper failed (exit ${code}): ${errData}`));
+                        });
+                        piperProc.on('error', (err) => reject(err));
+                    });
+                    if (!fs.existsSync(outFile))
+                        throw new Error('Piper did not produce output file');
+                    audioBuffer = fs.readFileSync(outFile);
+                    srtBuffer = Buffer.from(generateHeuristicSRT(text, audioBuffer.length), 'utf8');
+                    fs.unlinkSync(outFile);
                 }
                 else {
                     const commandTpl = this.getNodeParameter('systemCommand', i);
@@ -320,36 +379,35 @@ async function runEdgeTTS(text, voice, rate, pitch) {
         });
         ws.on('message', (data, isBinary) => {
             const textData = data.toString();
-            if (textData.includes('Path:turn.start')) {
-            }
-            else if (textData.includes('Path:turn.end')) {
-                ws.close();
-                const fullAudio = Buffer.concat(audioChunks);
-                const srt = buildSRT(wordBoundaries);
-                resolve({ audio: fullAudio, srt });
-            }
-            else if (textData.includes('Path:audio.metadata')) {
-                try {
-                    const parts = textData.split('\r\n\r\n');
-                    if (parts.length > 1) {
-                        const json = JSON.parse(parts[1]);
-                        if (json.Metadata && Array.isArray(json.Metadata)) {
-                            for (const meta of json.Metadata) {
-                                if (meta.Type === 'Word') {
-                                    wordBoundaries.push({
-                                        offset: meta.Offset,
-                                        duration: meta.Duration,
-                                        text: meta.Text,
-                                    });
+            if (textData.includes('Path:audio.metadata')) {
+                const parts = textData.split(/\r\n\r\n/);
+                for (const part of parts) {
+                    try {
+                        if (part.trim().startsWith('{')) {
+                            const json = JSON.parse(part);
+                            if (json.Metadata && Array.isArray(json.Metadata)) {
+                                for (const meta of json.Metadata) {
+                                    if (meta.Type === 'Word') {
+                                        wordBoundaries.push({
+                                            offset: meta.Offset,
+                                            duration: meta.Duration,
+                                            text: meta.Text,
+                                        });
+                                    }
                                 }
                             }
                         }
                     }
-                }
-                catch (e) {
+                    catch (e) { }
                 }
             }
-            else if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
+            if (textData.includes('Path:turn.end')) {
+                ws.close();
+                const fullAudio = Buffer.concat(audioChunks);
+                const srt = buildSRT(wordBoundaries);
+                resolve({ audio: fullAudio, srt });
+            }
+            if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
                 const headerLen = data.readUInt16BE(0);
                 if (data.length > headerLen + 2) {
                     const audioData = data.slice(headerLen + 2);
@@ -363,6 +421,8 @@ async function runEdgeTTS(text, voice, rate, pitch) {
     });
 }
 function buildSRT(words) {
+    if (!words || words.length === 0)
+        return '';
     let srt = '';
     let counter = 1;
     let currentPhrase = [];
@@ -421,3 +481,88 @@ function generateHeuristicSRT(text, byteLength) {
     }
     return srt;
 }
+async function ensurePiperBinary(binDir) {
+    const platform = os.platform();
+    const arch = os.arch();
+    let binaryName = 'piper';
+    if (platform === 'win32')
+        binaryName = 'piper.exe';
+    const finalPath = path.join(binDir, binaryName);
+    if (fs.existsSync(finalPath))
+        return finalPath;
+    let url = '';
+    let archiveName = '';
+    if (platform === 'linux' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz';
+        archiveName = 'piper.tar.gz';
+    }
+    else if (platform === 'win32' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip';
+        archiveName = 'piper.zip';
+    }
+    else {
+        throw new Error(`Auto-download for Piper not supported on ${platform} ${arch}. Please install manually.`);
+    }
+    const archivePath = path.join(binDir, archiveName);
+    console.log(`Downloading Piper from ${url}...`);
+    await downloadFile(url, archivePath);
+    try {
+        if (platform === 'win32') {
+            child_process.execSync(`powershell -command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`);
+            const extractedFolder = path.join(binDir, 'piper');
+            return path.join(binDir, 'piper', 'piper.exe');
+        }
+        else {
+            child_process.execSync(`tar -xzf "${archivePath}" -C "${binDir}"`);
+            return path.join(binDir, 'piper', 'piper');
+        }
+    }
+    catch (e) {
+        throw new Error(`Failed to extract Piper: ${e.message}`);
+    }
+}
+async function ensurePiperModel(binDir, modelNameOrUrl) {
+    if (modelNameOrUrl.startsWith('http')) {
+        const fileName = path.basename(modelNameOrUrl);
+        const modelPath = path.join(binDir, fileName);
+        if (!fs.existsSync(modelPath)) {
+            await downloadFile(modelNameOrUrl, modelPath);
+        }
+        const configUrl = modelNameOrUrl + '.json';
+        const configPath = modelPath + '.json';
+        if (!fs.existsSync(configPath)) {
+            await downloadFile(configUrl, configPath);
+        }
+        return { modelPath, configPath };
+    }
+    if (modelNameOrUrl === 'en_US-lessac-medium') {
+        const url = 'https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/lessac/medium/en_US-lessac-medium.onnx';
+        const modelPath = path.join(binDir, 'en_US-lessac-medium.onnx');
+        const configPath = path.join(binDir, 'en_US-lessac-medium.onnx.json');
+        if (!fs.existsSync(modelPath))
+            await downloadFile(url, modelPath);
+        if (!fs.existsSync(configPath))
+            await downloadFile(url + '.json', configPath);
+        return { modelPath, configPath };
+    }
+    return { modelPath: modelNameOrUrl, configPath: modelNameOrUrl + '.json' };
+}
+async function downloadFile(url, dest) {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+                return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                resolve();
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}

package/nodes/TTSBigBoss/TTSBigBoss.node.ts

@@ -10,6 +10,12 @@ import * as path from 'path';
 import * as os from 'os';
 import * as child_process from 'child_process';
 import WebSocket from 'ws';
+import * as https from 'https';
+import * as stream from 'stream';
+import { promisify } from 'util';
+import * as zlib from 'zlib'; // For extracting .tar.gz if needed, typically usage of tar command is easier on linux
+
+const pipeline = promisify(stream.pipeline);
 
 // Edge TTS Constants
 const EDGE_URL = 'wss://speech.platform.bing.com/consumer/speech/synthesize/readaloud/edge/v1?TrustedClientToken=6A5AA1D4EAFF4E9FB37E23D68491D6F4';
@@ -52,7 +58,7 @@ export class TTSBigBoss implements INodeType {
         icon: 'fa:comment-dots',
         group: ['transform'],
         version: 1,
-        description: 'Advanced Text-to-Speech (Edge-TTS & System Clone)',
+        description: 'Advanced Text-to-Speech (Edge-TTS & Local Standalone)',
         defaults: {
             name: 'TTS BigBoss',
         },
@@ -70,9 +76,14 @@ export class TTSBigBoss implements INodeType {
                         description: 'High quality, multilingual, supports Arabic & perfect subtitles. Requires internet.',
                     },
                     {
-                        name: 'System Command (Local/Clone)',
+                        name: 'Local Piper (Auto-Download)',
+                        value: 'piper_local',
+                        description: 'Downloads and runs Piper locally (Offline). Good quality, fast.',
+                    },
+                    {
+                        name: 'System Command (Custom)',
                         value: 'system',
-                        description: 'Use locally installed tools (Piper, XTTS, Coqui) via command line.',
+                        description: 'Use custom command for installed tools (XTTS, etc).',
                     },
                 ],
                 default: 'edge',
@@ -164,8 +175,8 @@ export class TTSBigBoss implements INodeType {
                 displayName: 'Command',
                 name: 'systemCommand',
                 type: 'string',
-                default: 'piper --model en_US-lessac-medium --output_file "{output_file}"',
-                description: 'Command to execute. Use placeholders: "{text}" for input text, "{output_file}" for the temporary audio path.',
+                default: 'echo "Custom command here" > "{output_file}"',
+                description: 'Command to execute. Use placeholders: "{text}", "{output_file}".',
                 displayOptions: {
                     show: {
                         engine: ['system'],
@@ -197,6 +208,21 @@ export class TTSBigBoss implements INodeType {
                 },
                 description: 'Binary property name containing the reference audio for cloning. Use placeholder "{reference_audio}" in command.',
             },
+            // ----------------------------------
+            // Local Piper Settings
+            // ----------------------------------
+            {
+                displayName: 'Piper Voice Model (HF URL or Path)',
+                name: 'piperModel',
+                type: 'string',
+                default: 'en_US-lessac-medium',
+                description: 'Enter a known Piper model name (e.g. "en_US-lessac-medium") which will be auto-downloaded, OR a full URL to the .onnx file.',
+                displayOptions: {
+                    show: {
+                        engine: ['piper_local'],
+                    },
+                },
+            }
         ],
     };
 
@@ -205,6 +231,12 @@ export class TTSBigBoss implements INodeType {
         const returnData: INodeExecutionData[] = [];
         const tempDir = os.tmpdir();
 
+        // Ensure bin directory exists for local tools
+        const binDir = path.join(path.dirname(__dirname), 'bin'); // ../bin from nodes/TTSBigBoss/
+        if (!fs.existsSync(binDir)) {
+            fs.mkdirSync(binDir, { recursive: true });
+        }
+
         for (let i = 0; i < items.length; i++) {
             try {
                 const engine = this.getNodeParameter('engine', i) as string;
@@ -228,7 +260,57 @@ export class TTSBigBoss implements INodeType {
 
                     const result = await runEdgeTTS(text, voice, rate, pitch);
                     audioBuffer = result.audio;
-                    srtBuffer = Buffer.from(result.srt, 'utf8');
+                    // Fallback if SRT empty
+                    if (!result.srt || result.srt.trim().length === 0) {
+                        srtBuffer = Buffer.from(generateHeuristicSRT(text, result.audio.length), 'utf8');
+                    } else {
+                        srtBuffer = Buffer.from(result.srt, 'utf8');
+                    }
+
+                } else if (engine === 'piper_local') {
+                    // ----------------------------------
+                    // PIPER LOCAL AUTOMATION
+                    // ----------------------------------
+                    const piperModel = this.getNodeParameter('piperModel', i) as string;
+
+                    // 1. Ensure Piper Binary
+                    const piperBinPath = await ensurePiperBinary(binDir);
+
+                    // 2. Ensure Voice Model
+                    const { modelPath, configPath } = await ensurePiperModel(binDir, piperModel);
+
+                    // 3. Execute
+                    const outFile = path.join(tempDir, `piper_out_${uuidv4()}.wav`);
+                    // Piper command: echo "text" | piper --model model.onnx --output_file out.wav
+                    // We use child_process.spawn to pipe text safely
+
+                    await new Promise<void>((resolve, reject) => {
+                        const piperProc = child_process.spawn(piperBinPath, [
+                            '--model', modelPath,
+                            '--config', configPath,
+                            '--output_file', outFile
+                        ]);
+
+                        piperProc.stdin.write(text);
+                        piperProc.stdin.end();
+
+                        let errData = '';
+                        piperProc.stderr.on('data', (d) => errData += d.toString());
+
+                        piperProc.on('close', (code) => {
+                            if (code === 0) resolve();
+                            else reject(new Error(`Piper failed (exit ${code}): ${errData}`));
+                        });
+
+                        piperProc.on('error', (err) => reject(err));
+                    });
+
+                    if (!fs.existsSync(outFile)) throw new Error('Piper did not produce output file');
+
+                    audioBuffer = fs.readFileSync(outFile);
+                    srtBuffer = Buffer.from(generateHeuristicSRT(text, audioBuffer.length), 'utf8');
+
+                    fs.unlinkSync(outFile);
 
                 } else {
                     // ----------------------------------
@@ -353,47 +435,45 @@ async function runEdgeTTS(text: string, voice: string, rate: string, pitch: stri
         });
 
         ws.on('message', (data: Buffer, isBinary: boolean) => {
+            // Try to interpret as text first
             const textData = data.toString();
 
-            if (textData.includes('Path:turn.start')) {
-                // Start of turn
-            } else if (textData.includes('Path:turn.end')) {
-                // End of turn - Finish
-                ws.close();
-                const fullAudio = Buffer.concat(audioChunks);
-                const srt = buildSRT(wordBoundaries);
-                resolve({ audio: fullAudio, srt });
-            } else if (textData.includes('Path:audio.metadata')) {
+            if (textData.includes('Path:audio.metadata')) {
                 // Parse Metadata (Word Boundaries)
-                try {
-                    const parts = textData.split('\r\n\r\n');
-                    if (parts.length > 1) {
-                        const json = JSON.parse(parts[1]);
-                        if (json.Metadata && Array.isArray(json.Metadata)) {
-                            for (const meta of json.Metadata) {
-                                if (meta.Type === 'Word') {
-                                    wordBoundaries.push({
-                                        offset: meta.Offset, // 100ns units
-                                        duration: meta.Duration,
-                                        text: meta.Text,
-                                    });
+                // Markers might be interleaved with header, need robust split
+                const parts = textData.split(/\r\n\r\n/);
+                // iterate to find JSON
+                for (const part of parts) {
+                    try {
+                        // Look for JSON object start
+                        if (part.trim().startsWith('{')) {
+                            const json = JSON.parse(part);
+                            if (json.Metadata && Array.isArray(json.Metadata)) {
+                                for (const meta of json.Metadata) {
+                                    if (meta.Type === 'Word') {
+                                        wordBoundaries.push({
+                                            offset: meta.Offset, // 100ns units
+                                            duration: meta.Duration,
+                                            text: meta.Text,
+                                        });
+                                    }
                                 }
                             }
                         }
-                    }
-                } catch (e) {
-                    // Ignore parse errors
+                    } catch (e) { /* ignore non-json parts */ }
                 }
-            } else if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
-                // Binary Audio Data
-                // The header is usually 2 bytes + requestID length + timestamp. 
-                // Edge TTS binary format: Header length (2B) + Header + Audio Data
-                // We need to strip the header to get clean MP3.
-                // Header format: "X-RequestId:...\r\nPath:audio\r\n..."
-
-                // Simple Strip: Look for "Path:audio\r\n\r\n" in the buffer?
-                // Binary messages have a specific binary header structure.
-                // Structure: 2 bytes (header length) + Header Text + Data
+            }
+
+            if (textData.includes('Path:turn.end')) {
+                // End of turn - Finish
+                ws.close();
+                const fullAudio = Buffer.concat(audioChunks);
+                const srt = buildSRT(wordBoundaries);
+                resolve({ audio: fullAudio, srt });
+            }
+
+            if (isBinary || (data.length > 2 && data[0] === 0x00 && data[1] === 0x67)) {
+                // Binary Audio Data (header 2 bytes length + content)
                 const headerLen = data.readUInt16BE(0);
                 if (data.length > headerLen + 2) {
                     const audioData = data.slice(headerLen + 2);
@@ -409,6 +489,7 @@ async function runEdgeTTS(text: string, voice: string, rate: string, pitch: stri
 }
 
 function buildSRT(words: WordBoundary[]): string {
+    if (!words || words.length === 0) return '';
     let srt = '';
     let counter = 1;
     // Group words into reasonable chunks if they are close? 
@@ -503,3 +584,118 @@ function generateHeuristicSRT(text: string, byteLength: number): string {
 
     return srt;
 }
+
+// --------------------------------------------------------------------------
+// PIPER DOWNLOADER HELPERS
+// --------------------------------------------------------------------------
+async function ensurePiperBinary(binDir: string): Promise<string> {
+    // 1. Check Platform
+    const platform = os.platform(); // linux, darwin, win32
+    const arch = os.arch(); // x64, arm64
+
+    let binaryName = 'piper';
+    if (platform === 'win32') binaryName = 'piper.exe';
+
+    const finalPath = path.join(binDir, binaryName);
+    if (fs.existsSync(finalPath)) return finalPath;
+
+    // 2. Determine Download URL (Latest release 2023.11.14-2)
+    // https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz
+    // https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip
+
+    let url = '';
+    let archiveName = '';
+
+    if (platform === 'linux' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_linux_x86_64.tar.gz';
+        archiveName = 'piper.tar.gz';
+    } else if (platform === 'win32' && arch === 'x64') {
+        url = 'https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_windows_amd64.zip';
+        archiveName = 'piper.zip';
+    } else {
+        throw new Error(`Auto-download for Piper not supported on ${platform} ${arch}. Please install manually.`);
+    }
+
+    const archivePath = path.join(binDir, archiveName);
+
+    // Download
+    console.log(`Downloading Piper from ${url}...`);
+    await downloadFile(url, archivePath);
+
+    // Extract (Simple approach: use system tar/unzip if available)
+    // Since user environment is likely Linux (n8n docker) or Windows.
+    try {
+        if (platform === 'win32') {
+            child_process.execSync(`powershell -command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`);
+            const extractedFolder = path.join(binDir, 'piper'); // Zip contains 'piper' folder
+            // Move piper.exe to binDir root or return piper/piper.exe
+            // The zip contains a 'piper' folder.
+            return path.join(binDir, 'piper', 'piper.exe');
+        } else {
+            child_process.execSync(`tar -xzf "${archivePath}" -C "${binDir}"`);
+            return path.join(binDir, 'piper', 'piper'); // Tar contains 'piper' folder
+        }
+    } catch (e) {
+        throw new Error(`Failed to extract Piper: ${e.message}`);
+    }
+}
+
+async function ensurePiperModel(binDir: string, modelNameOrUrl: string): Promise<{ modelPath: string, configPath: string }> {
+    // If it's a known model name like "en_US-lessac-medium", construct URL
+    // https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/lessac/medium/en_US-lessac-medium.onnx
+    // This is tricky because directory structure varies.
+    // We'll rely on a direct URL or a simplied map for BigBoss defaults.
+
+    // If full URL provided
+    if (modelNameOrUrl.startsWith('http')) {
+        const fileName = path.basename(modelNameOrUrl);
+        const modelPath = path.join(binDir, fileName);
+        if (!fs.existsSync(modelPath)) {
+            await downloadFile(modelNameOrUrl, modelPath);
+        }
+
+        const configUrl = modelNameOrUrl + '.json';
+        const configPath = modelPath + '.json';
+        if (!fs.existsSync(configPath)) {
+            await downloadFile(configUrl, configPath);
+        }
+        return { modelPath, configPath };
+    }
+
+    // If short name provided, try a heuristic for common English voice
+    // We only support auto-download for "en_US-lessac-medium" easily for now.
+    if (modelNameOrUrl === 'en_US-lessac-medium') {
+        const url = 'https://huggingface.co/rhasspy/piper-voices/resolve/main/en/en_US/lessac/medium/en_US-lessac-medium.onnx';
+        const modelPath = path.join(binDir, 'en_US-lessac-medium.onnx');
+        const configPath = path.join(binDir, 'en_US-lessac-medium.onnx.json');
+
+        if (!fs.existsSync(modelPath)) await downloadFile(url, modelPath);
+        if (!fs.existsSync(configPath)) await downloadFile(url + '.json', configPath);
+
+        return { modelPath, configPath };
+    }
+
+    // Assume local path if not url/special name
+    return { modelPath: modelNameOrUrl, configPath: modelNameOrUrl + '.json' };
+}
+
+async function downloadFile(url: string, dest: string): Promise<void> {
+    return new Promise((resolve, reject) => {
+        const file = fs.createWriteStream(dest);
+        https.get(url, (response) => {
+            if (response.statusCode === 302 || response.statusCode === 301) {
+                // Follow redirect
+                downloadFile(response.headers.location!, dest).then(resolve).catch(reject);
+                return;
+            }
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                resolve();
+            });
+        }).on('error', (err) => {
+            fs.unlink(dest, () => { });
+            reject(err);
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-tts-bigboss",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "BigBoss TTS node with multi-engine support and automatic SRT generation",
   "keywords": [
     "n8n-community-node-package",