@qvac/sdk 0.14.1 → 0.16.0

package/dist/examples/transcription/whispercpp-prompt.js

@@ -9,20 +9,20 @@
  * Set audioChunk to a custom WAV, or download the default audio into examples/audio/:
  *   https://github.com/tetherto/qvac/blob/main/packages/sdk/examples/audio/sample-16khz.wav
  */
-import { loadModel, unloadModel, transcribe, WHISPER_TINY } from "@qvac/sdk";
+import { loadModel, unloadModel, transcribe, WHISPER_TINY } from '@qvac/sdk';
 try {
-    console.log("▸ Starting Whisper transcription with prompt example...");
+    console.log('▸ Starting Whisper transcription with prompt example...');
     // Load the Whisper model
-    console.log("▸ Loading Whisper model...");
+    console.log('▸ Loading Whisper model...');
     const modelId = await loadModel({
         modelSrc: WHISPER_TINY,
         modelConfig: {
-            audio_format: "f32le",
+            audio_format: 'f32le',
             // Sampling strategy
-            strategy: "greedy",
+            strategy: 'greedy',
             n_threads: 4,
             // Transcription options
-            language: "en",
+            language: 'en',
             translate: false,
             no_timestamps: false,
             single_segment: false,
@@ -42,40 +42,40 @@ try {
                 min_silence_duration_ms: 150,
                 max_speech_duration_s: 30.0,
                 speech_pad_ms: 600,
-                samples_overlap: 0.3,
+                samples_overlap: 0.3
             },
             // Context parameters for GPU
             contextParams: {
                 use_gpu: true,
                 flash_attn: true,
-                gpu_device: 0,
-            },
+                gpu_device: 0
+            }
         },
         onProgress: (p) => {
             const mb = (n) => (n / 1e6).toFixed(1);
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     console.log(`▸ Whisper model loaded with ID: ${modelId}`);
     // Perform transcription
-    console.log("▸ Transcribing audio...");
+    console.log('▸ Transcribing audio...');
     const text = await transcribe({
         modelId,
-        audioChunk: "examples/audio/sample-16khz.wav",
-        prompt: "This is a test recording with clear speech and proper punctuation.",
+        audioChunk: 'examples/audio/sample-16khz.wav',
+        prompt: 'This is a test recording with clear speech and proper punctuation.'
     });
-    console.log("▸ Transcription result:");
+    console.log('▸ Transcription result:');
     console.log(text);
     // Unload the model when done
-    console.log("▸ Unloading Whisper model...");
+    console.log('▸ Unloading Whisper model...');
     await unloadModel({ modelId });
-    console.log("▸ Whisper model unloaded successfully");
+    console.log('▸ Whisper model unloaded successfully');
     process.exit(0);
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-bergamot-batch.js

@@ -1,44 +1,44 @@
-import { loadModel, translate, unloadModel, BERGAMOT_EN_FR } from "@qvac/sdk";
+import { loadModel, translate, unloadModel, BERGAMOT_EN_FR } from '@qvac/sdk';
 try {
     const modelId = await loadModel({
         modelSrc: BERGAMOT_EN_FR,
         modelConfig: {
-            engine: "Bergamot",
-            from: "en",
-            to: "fr",
+            engine: 'Bergamot',
+            from: 'en',
+            to: 'fr',
             beamsize: 1,
             normalize: 1,
             temperature: 0.2,
             norepeatngramsize: 3,
-            lengthpenalty: 1.2,
+            lengthpenalty: 1.2
         },
         onProgress: (p) => {
             const mb = (n) => (n / 1e6).toFixed(1);
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     console.log(`▸ Bergamot model loaded: ${modelId}`);
     // Test with array of texts for batch processing
     const texts = [
-        "Hello world",
-        "How are you today?",
-        "This is a test of batch translation",
-        "The weather is nice",
+        'Hello world',
+        'How are you today?',
+        'This is a test of batch translation',
+        'The weather is nice'
     ];
-    console.log("▸ Translating batch of texts:");
+    console.log('▸ Translating batch of texts:');
     texts.forEach((text, i) => console.log(`▸   ${i + 1}. ${text}`));
     const result = translate({
         modelId,
         text: texts, // Pass array for batch processing
-        modelType: "nmtcpp-translation",
-        stream: false,
+        modelType: 'nmtcpp-translation',
+        stream: false
     });
     const translatedText = await result.text;
-    const translations = translatedText.split("\n");
-    console.log("▸ Translations:");
+    const translations = translatedText.split('\n');
+    console.log('▸ Translations:');
     translations.forEach((translation, i) => {
         if (i < texts.length) {
             console.log(`  ${i + 1}. ${texts[i]} -> "${translation}"`);
@@ -47,6 +47,6 @@ try {
     await unloadModel({ modelId });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-bergamot-pivot.js

@@ -1,4 +1,4 @@
-import { BERGAMOT_ES_EN, BERGAMOT_EN_IT, loadModel, translate, unloadModel, } from "@qvac/sdk";
+import { BERGAMOT_ES_EN, BERGAMOT_EN_IT, loadModel, translate, unloadModel } from '@qvac/sdk';
 /**
  * Example: Pivot Translation with Bergamot
  *
@@ -18,9 +18,9 @@ try {
     const modelId = await loadModel({
         modelSrc: BERGAMOT_ES_EN, // Primary model: Spanish → English
         modelConfig: {
-            engine: "Bergamot",
-            from: "es",
-            to: "it", // Final target language (SDK handles the pivot internally)
+            engine: 'Bergamot',
+            from: 'es',
+            to: 'it', // Final target language (SDK handles the pivot internally)
             beamsize: 4,
             normalize: 1,
             temperature: 0.3,
@@ -33,44 +33,44 @@ try {
                 temperature: 0.3,
                 topk: 100,
                 normalize: 1,
-                lengthpenalty: 1.2,
-            },
+                lengthpenalty: 1.2
+            }
         },
         onProgress: (p) => {
             const mb = (n) => (n / 1e6).toFixed(1);
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     console.log(`▸ Pivot translation model loaded: ${modelId}`);
-    console.log("▸ Primary: Spanish → English");
-    console.log("▸ Pivot: English → Italian");
+    console.log('▸ Primary: Spanish → English');
+    console.log('▸ Pivot: English → Italian');
     // Spanish text to translate
     const spanishText = `Era una mañana soleada cuando María decidió visitar el mercado local.
   Compró frutas frescas, verduras y flores para su casa.
   El vendedor le recomendó las mejores manzanas de la temporada.`;
-    console.log("▸ Original Spanish text:");
+    console.log('▸ Original Spanish text:');
     console.log(spanishText);
     // Translate Spanish → English → Italian
     const result = translate({
         modelId,
         text: spanishText,
-        modelType: "nmtcpp-translation",
-        stream: false,
+        modelType: 'nmtcpp-translation',
+        stream: false
     });
     const italianText = await result.text;
-    console.log("▸ Translated to Italian (via English):");
+    console.log('▸ Translated to Italian (via English):');
     console.log(italianText);
     // Expected output (approximate):
     // "Era una mattina di sole quando Maria decise di visitare il mercato locale.
     //  Ha comprato frutta fresca, verdura e fiori per la sua casa.
     //  Il venditore ha consigliato le migliori mele della stagione."
     await unloadModel({ modelId });
-    console.log("▸ Model unloaded successfully");
+    console.log('▸ Model unloaded successfully');
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-bergamot.js

@@ -1,4 +1,4 @@
-import { loadModel, translate, unloadModel, BERGAMOT_EN_FR } from "@qvac/sdk";
+import { loadModel, translate, unloadModel, BERGAMOT_EN_FR } from '@qvac/sdk';
 try {
     // Bergamot models automatically derive vocabulary files from the model source.
     // You can still override them explicitly if needed:
@@ -7,36 +7,36 @@ try {
     const modelId = await loadModel({
         modelSrc: BERGAMOT_EN_FR,
         modelConfig: {
-            engine: "Bergamot",
-            from: "en",
-            to: "fr",
+            engine: 'Bergamot',
+            from: 'en',
+            to: 'fr',
             beamsize: 1,
             normalize: 1,
             temperature: 0.2,
             norepeatngramsize: 3,
-            lengthpenalty: 1.2,
+            lengthpenalty: 1.2
         },
         onProgress: (p) => {
             const mb = (n) => (n / 1e6).toFixed(1);
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     console.log(`▸ Bergamot model loaded: ${modelId}`);
-    const text = "This is a test of the Bergamot translation model.";
+    const text = 'This is a test of the Bergamot translation model.';
     const result = translate({
         modelId,
         text,
-        modelType: "nmtcpp-translation",
-        stream: false,
+        modelType: 'nmtcpp-translation',
+        stream: false
     });
     const translatedText = await result.text;
     console.log(`Translated text EN -> FR: ${text} -> "${translatedText}"`);
     await unloadModel({ modelId });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-indic.js

@@ -1,4 +1,4 @@
-import { loadModel, translate, unloadModel, MARIAN_EN_HI_INDIC_1B_Q4_0, } from "@qvac/sdk";
+import { loadModel, translate, unloadModel, MARIAN_EN_HI_INDIC_1B_Q4_0 } from '@qvac/sdk';
 // NOTE: @qvac/translation-nmtcpp version 0.1.6 does not work well with IndicTrans models
 // This example is expected to fail
 // A fix is in progress for future releases
@@ -10,27 +10,27 @@ try {
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
+                process.stderr.write('\n');
         },
         modelConfig: {
-            engine: "IndicTrans",
-            from: "eng_Latn",
-            to: "hin_Deva",
-        },
+            engine: 'IndicTrans',
+            from: 'eng_Latn',
+            to: 'hin_Deva'
+        }
     });
     console.log(`▸ Model loaded: ${modelId}`);
-    const text = "Hello, how are you today?";
+    const text = 'Hello, how are you today?';
     const result = translate({
         modelId,
         text,
-        modelType: "nmtcpp-translation",
-        stream: false,
+        modelType: 'nmtcpp-translation',
+        stream: false
     });
     const translatedText = await result.text;
     console.log(`Translated text EN -> HI: ${text} -> "${translatedText}"`);
     await unloadModel({ modelId });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-llm-afriquegemma.js

@@ -1,4 +1,4 @@
-import { translate, loadModel, unloadModel, AFRICAN_4B_TRANSLATION_Q4_K_M, } from "@qvac/sdk";
+import { translate, loadModel, unloadModel, AFRICAN_4B_TRANSLATION_Q4_K_M } from '@qvac/sdk';
 try {
     const modelId = await loadModel({
         modelSrc: AFRICAN_4B_TRANSLATION_Q4_K_M,
@@ -7,7 +7,7 @@ try {
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
+                process.stderr.write('\n');
         },
         // IMPORTANT: these parameters are validated to be optimal
         modelConfig: {
@@ -19,24 +19,24 @@ try {
             repeat_penalty: 1,
             seed: 42,
             predict: 256,
-            stop_sequences: ["\n"],
-        },
+            stop_sequences: ['\n']
+        }
     });
     // With explicit source language
-    const engText = "Hello, how are you today?";
+    const engText = 'Hello, how are you today?';
     const resultExplicit = translate({
         modelId,
         text: engText,
-        from: "en",
-        to: "swh_Latn",
-        modelType: "llamacpp-completion",
-        stream: false,
+        from: 'en',
+        to: 'swh_Latn',
+        modelType: 'llamacpp-completion',
+        stream: false
     });
     const translatedTextExplicit = await resultExplicit.text;
     console.log(`Explicit source: ${engText} -> "${translatedTextExplicit}"`);
     await unloadModel({ modelId, clearStorage: false });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-llm-context.js

@@ -1,4 +1,4 @@
-import { translate, loadModel, unloadModel, SALAMANDRATA_2B_INST_Q8, } from "@qvac/sdk";
+import { translate, loadModel, unloadModel, SALAMANDRATA_2B_INST_Q8 } from '@qvac/sdk';
 try {
     const modelId = await loadModel({
         modelSrc: SALAMANDRATA_2B_INST_Q8,
@@ -7,26 +7,26 @@ try {
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     console.log(`▸ Model loaded: ${modelId}`);
     // With explicit source language
-    const engText = "bank";
+    const engText = 'bank';
     const resultExplicit = translate({
         modelId,
         text: engText,
-        from: "en",
-        to: "es",
-        modelType: "llamacpp-completion",
-        context: "Use formal language, letter for financial institution",
-        stream: false,
+        from: 'en',
+        to: 'es',
+        modelType: 'llamacpp-completion',
+        context: 'Use formal language, letter for financial institution',
+        stream: false
     });
     const translatedTextExplicit = await resultExplicit.text;
     console.log(`${engText} -> "${translatedTextExplicit}"`); // "banco" (not "orilla")
     await unloadModel({ modelId, clearStorage: false });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-llm.js

@@ -1,4 +1,4 @@
-import { translate, loadModel, unloadModel, SALAMANDRATA_2B_INST_Q4, } from "@qvac/sdk";
+import { translate, loadModel, unloadModel, SALAMANDRATA_2B_INST_Q4 } from '@qvac/sdk';
 try {
     const modelId = await loadModel({
         modelSrc: SALAMANDRATA_2B_INST_Q4,
@@ -7,28 +7,28 @@ try {
             const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
             process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
             if (p.percentage >= 100)
-                process.stderr.write("\n");
-        },
+                process.stderr.write('\n');
+        }
     });
     // With explicit source language
-    const engText = "Hello, how are you today?";
+    const engText = 'Hello, how are you today?';
     const resultExplicit = translate({
         modelId,
         text: engText,
-        from: "en",
-        to: "it",
-        modelType: "llamacpp-completion",
-        stream: false,
+        from: 'en',
+        to: 'it',
+        modelType: 'llamacpp-completion',
+        stream: false
     });
     const translatedTextExplicit = await resultExplicit.text;
     // With autodetection (must await previous translate — LLM addon runs one job at a time)
-    const espText = "Hola, como estas?";
+    const espText = 'Hola, como estas?';
     const resultAutodetect = translate({
         modelId,
         text: espText,
-        to: "en",
-        modelType: "llamacpp-completion",
-        stream: false,
+        to: 'en',
+        modelType: 'llamacpp-completion',
+        stream: false
     });
     const translatedTextAutodetect = await resultAutodetect.text;
     console.log(`Explicit source: ${engText} -> "${translatedTextExplicit}"`);
@@ -36,6 +36,6 @@ try {
     await unloadModel({ modelId, clearStorage: false });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/translation/translation-stream.js

@@ -1,23 +1,23 @@
-import { loadModel, translate, unloadModel, BERGAMOT_EN_ES } from "@qvac/sdk";
+import { loadModel, translate, unloadModel, BERGAMOT_EN_ES } from '@qvac/sdk';
 try {
     const modelId = await loadModel({
         modelSrc: BERGAMOT_EN_ES,
         modelConfig: {
-            engine: "Bergamot",
-            from: "en",
-            to: "es",
-        },
+            engine: 'Bergamot',
+            from: 'en',
+            to: 'es'
+        }
     });
     console.log(`▸ Model loaded: ${modelId}`);
-    const text = "Hello, how are you today? I hope you are having a wonderful day!";
-    console.log("▸ Streaming Translation");
+    const text = 'Hello, how are you today? I hope you are having a wonderful day!';
+    console.log('▸ Streaming Translation');
     const streamResult = translate({
         modelId,
         text,
-        modelType: "nmtcpp-translation",
-        stream: true,
+        modelType: 'nmtcpp-translation',
+        stream: true
     });
-    process.stdout.write("Translated text EN -> ES: ");
+    process.stdout.write('Translated text EN -> ES: ');
     for await (const token of streamResult.tokenStream) {
         process.stdout.write(token);
     }
@@ -29,6 +29,6 @@ try {
     await unloadModel({ modelId, clearStorage: false });
 }
 catch (error) {
-    console.error("✖", error);
+    console.error('✖', error);
     process.exit(1);
 }

package/dist/examples/tts/chatterbox-enhanced.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chatterbox-enhanced.d.ts.map

package/dist/examples/tts/chatterbox-enhanced.js

@@ -0,0 +1,55 @@
+import { loadModel, textToSpeech, unloadModel, TTS_T3_TURBO_EN_CHATTERBOX_Q8_0, TTS_S3GEN_EN_CHATTERBOX, TTS_ENHANCER_LAVASR_FP16 } from '@qvac/sdk';
+import { createWav, playAudio, int16ArrayToBuffer, createWavHeader } from './utils.js';
+// Chatterbox TTS (GGML) with the LavaSR enhancer: synthesized audio is neurally
+// bandwidth-extended to 48 kHz. Supplying the enhancer GGUF is what enables
+// enhancement — there is no on/off flag — and it forces the output to 48 kHz.
+// Usage: node chatterbox-enhanced.ts [referenceAudioSrc]
+const [referenceAudioSrc] = process.argv.slice(2);
+const ENHANCED_SAMPLE_RATE = 48000;
+try {
+    const modelId = await loadModel({
+        modelSrc: TTS_T3_TURBO_EN_CHATTERBOX_Q8_0,
+        modelConfig: {
+            ttsEngine: 'chatterbox',
+            language: 'en',
+            s3genModelSrc: TTS_S3GEN_EN_CHATTERBOX.src,
+            lavasrEnhancerModelSrc: TTS_ENHANCER_LAVASR_FP16.src,
+            ...(referenceAudioSrc ? { referenceAudioSrc } : {})
+        },
+        onProgress: (p) => {
+            const mb = (n) => (n / 1e6).toFixed(1);
+            const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
+            process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
+            if (p.percentage >= 100)
+                process.stderr.write('\n');
+        }
+    });
+    console.log(`▸ Model loaded: ${modelId}`);
+    console.log('▸ Testing Text-to-Speech (LavaSR enhancer)...');
+    const result = textToSpeech({
+        modelId,
+        text: `QVAC SDK is the canonical entry point to QVAC. Written in TypeScript, it provides all QVAC capabilities through a unified interface while also abstracting away the complexity of running your application in a JS environment other than Bare. Supported JS environments include Bare, Node.js, Expo and Bun.`,
+        inputType: 'text',
+        stream: false
+    });
+    const audioBuffer = await result.buffer;
+    console.log(`▸ TTS complete. Total samples: ${audioBuffer.length}`);
+    console.log('▸ Saving audio to file...');
+    createWav(audioBuffer, ENHANCED_SAMPLE_RATE, 'chatterbox-enhanced-output.wav');
+    console.log('▸ Audio saved to chatterbox-enhanced-output.wav');
+    console.log('▸ Playing audio...');
+    const audioData = int16ArrayToBuffer(audioBuffer);
+    const wavBuffer = Buffer.concat([
+        createWavHeader(audioData.length, ENHANCED_SAMPLE_RATE),
+        audioData
+    ]);
+    playAudio(wavBuffer);
+    console.log('▸ Audio playback complete');
+    await unloadModel({ modelId });
+    console.log('▸ Model unloaded');
+    process.exit(0);
+}
+catch (error) {
+    console.error('✖', error);
+    process.exit(1);
+}

package/dist/examples/tts/chatterbox-multilingual.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chatterbox-multilingual.d.ts.map

package/dist/examples/tts/chatterbox-multilingual.js

@@ -0,0 +1,54 @@
+import { loadModel, textToSpeech, unloadModel, TTS_T3_MULTILINGUAL_CHATTERBOX_Q4_0, TTS_S3GEN_MULTILINGUAL_CHATTERBOX_Q4_0, TTS_MECAB_IPADIC_CHATTERBOX } from '@qvac/sdk';
+import { createWav, playAudio, int16ArrayToBuffer, createWavHeader } from './utils.js';
+// Chatterbox multilingual TTS (GGML): Japanese synthesis with MeCab/IPAdic.
+// Uses registry model constants — downloads automatically from QVAC Registry.
+const CHATTERBOX_SAMPLE_RATE = 24000;
+const OUTPUT_FILE = 'chatterbox-multilingual-output.wav';
+try {
+    const modelId = await loadModel({
+        modelSrc: TTS_T3_MULTILINGUAL_CHATTERBOX_Q4_0,
+        modelConfig: {
+            ttsEngine: 'chatterbox',
+            language: 'ja',
+            s3genModelSrc: TTS_S3GEN_MULTILINGUAL_CHATTERBOX_Q4_0,
+            mecabDictSrc: TTS_MECAB_IPADIC_CHATTERBOX, //Optional: Only needed for Japanese synthesis
+            cfmSteps: 1,
+            threads: 8
+        },
+        onProgress: (p) => {
+            const mb = (n) => (n / 1e6).toFixed(1);
+            const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${mb(p.downloaded)}/${mb(p.total)} MB)`;
+            process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
+            if (p.percentage >= 100)
+                process.stderr.write('\n');
+        }
+    });
+    console.log(`▸ Model loaded: ${modelId}`);
+    console.log('▸ Testing Japanese Text-to-Speech...');
+    const result = textToSpeech({
+        modelId,
+        text: 'こんにちは。これはQVAC SDKを使った日本語音声合成のテストです。',
+        inputType: 'text',
+        stream: false
+    });
+    const audioBuffer = await result.buffer;
+    console.log(`▸ TTS complete. Total samples: ${audioBuffer.length}`);
+    console.log('▸ Saving audio to file...');
+    createWav(audioBuffer, CHATTERBOX_SAMPLE_RATE, OUTPUT_FILE);
+    console.log(`▸ Audio saved to ${OUTPUT_FILE}`);
+    console.log('▸ Playing audio...');
+    const audioData = int16ArrayToBuffer(audioBuffer);
+    const wavBuffer = Buffer.concat([
+        createWavHeader(audioData.length, CHATTERBOX_SAMPLE_RATE),
+        audioData
+    ]);
+    playAudio(wavBuffer);
+    console.log('▸ Audio playback complete');
+    await unloadModel({ modelId });
+    console.log('▸ Model unloaded');
+    process.exit(0);
+}
+catch (error) {
+    console.error('✖', error);
+    process.exit(1);
+}