speakdrill 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 myet-practice contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 myet-practice contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,46 +1,46 @@
-# speakdrill
-
-口說課程自動化練習：用 TTS 產生示範語音、逐句驅動課程演練、輸出可追蹤的分數報告。
-
-Rust 實作，含 CLI、TUI 與原生 GUI（egui，不是 Electron / Tauri webview）。
-
-> 目前只支援 **Windows x64**（相依 VoiceMeeter）。
-
-## 安裝
-
-```bash
-npm i -g speakdrill
-speakdrill init
-speakdrill doctor
-```
-
-安裝時會從 GitHub Releases 下載原生二進位（`speakdrill.exe` / `speakdrill-gui.exe`）。
-
-## 快速開始
-
-```bash
-speakdrill init                  # 偵測裝置、寫設定、設 VoiceMeeter 路由、拉音量
-speakdrill doctor                # 檢查環境
-speakdrill tui                   # 終端機介面
-speakdrill-gui                   # 原生 GUI
-speakdrill run  --lesson <ID> --course <ID>
-speakdrill batch --code <CODE> --limit 5
-speakdrill reset                 # 還原音訊路由
-```
-
-## 前置需求
-
-1. **VoiceMeeter**（Banana 或 Potato）
-2. **一個 TTS**：`pip install kokoro-onnx soundfile`，或自備 [piper](https://github.com/rhasspy/piper)
-3. 目標 App 需開啟 debug port：
-   `--remote-debugging-port=9222 --remote-allow-origins=*`
-4. 在 `ms-settings:apps-volume` 把目標 App 的**輸入裝置**設成 `Voicemeeter Out B1`
-   （這步只能用介面做，Windows 會產生綁定 GUID）
-
-## 文件
-
-完整說明、架構與踩坑紀錄：<https://github.com/thumb2086/speakdrill>
-
-## 授權
-
-MIT
+# speakdrill
+
+口說課程自動化練習：用 TTS 產生示範語音、逐句驅動課程演練、輸出可追蹤的分數報告。
+
+Rust 實作，含 CLI、TUI 與原生 GUI（egui，不是 Electron / Tauri webview）。
+
+> 目前只支援 **Windows x64**（相依 VoiceMeeter）。
+
+## 安裝
+
+```bash
+npm i -g speakdrill
+speakdrill init
+speakdrill doctor
+```
+
+安裝時會從 GitHub Releases 下載原生二進位（`speakdrill.exe` / `speakdrill-gui.exe`）。
+
+## 快速開始
+
+```bash
+speakdrill init                  # 偵測裝置、寫設定、設 VoiceMeeter 路由、拉音量
+speakdrill doctor                # 檢查環境
+speakdrill tui                   # 終端機介面
+speakdrill-gui                   # 原生 GUI
+speakdrill run  --lesson <ID> --course <ID>
+speakdrill batch --code <CODE> --limit 5
+speakdrill reset                 # 還原音訊路由
+```
+
+## 前置需求
+
+1. **VoiceMeeter**（Banana 或 Potato）
+2. **一個 TTS**：`pip install kokoro-onnx soundfile`，或自備 [piper](https://github.com/rhasspy/piper)
+3. 目標 App 需開啟 debug port：
+   `--remote-debugging-port=9222 --remote-allow-origins=*`
+4. 在 `ms-settings:apps-volume` 把目標 App 的**輸入裝置**設成 `Voicemeeter Out B1`
+   （這步只能用介面做，Windows 會產生綁定 GUID）
+
+## 文件
+
+完整說明、架構與踩坑紀錄：<https://github.com/thumb2086/speakdrill>
+
+## 授權
+
+MIT

package/bin/speakdrill.js

@@ -1,35 +1,35 @@
-#!/usr/bin/env node
-/**
- * npm 包裝器：把 `speakdrill ...` 轉給對應平台的原生二進位。
- *
- * 二進位由 scripts/install.js 從 GitHub Releases 下載到
- *   <package>/bin/binaries/<platform>-<arch>/speakdrill[.exe]
- */
-const { spawn } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-const exe = process.platform === 'win32' ? 'speakdrill.exe' : 'speakdrill';
-const dir = `${process.platform}-${process.arch}`;
-const candidates = [
-  path.join(__dirname, 'binaries', dir, exe),
-  path.join(__dirname, '..', '..', 'target', 'release', exe),
-  path.join(__dirname, '..', '..', 'target', 'debug', exe),
-];
-
-const bin = candidates.find((p) => fs.existsSync(p));
-
-if (!bin) {
-  console.error(
-    `[speakdrill] 找不到可執行檔（${dir}）。\n` +
-      `      請重新安裝：npm rebuild speakdrill\n` +
-      `      或從 https://github.com/thumb2086/speakdrill/releases 下載`
-  );
-  process.exit(1);
-}
-
-const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
-child.on('exit', (code, signal) => {
-  if (signal) process.kill(process.pid, signal);
-  else process.exit(code ?? 1);
-});
+#!/usr/bin/env node
+/**
+ * npm 包裝器：把 `speakdrill ...` 轉給對應平台的原生二進位。
+ *
+ * 二進位由 scripts/install.js 從 GitHub Releases 下載到
+ *   <package>/bin/binaries/<platform>-<arch>/speakdrill[.exe]
+ */
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const exe = process.platform === 'win32' ? 'speakdrill.exe' : 'speakdrill';
+const dir = `${process.platform}-${process.arch}`;
+const candidates = [
+  path.join(__dirname, 'binaries', dir, exe),
+  path.join(__dirname, '..', '..', 'target', 'release', exe),
+  path.join(__dirname, '..', '..', 'target', 'debug', exe),
+];
+
+const bin = candidates.find((p) => fs.existsSync(p));
+
+if (!bin) {
+  console.error(
+    `[speakdrill] 找不到可執行檔（${dir}）。\n` +
+      `      請重新安裝：npm rebuild speakdrill\n` +
+      `      或從 https://github.com/thumb2086/speakdrill/releases 下載`
+  );
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+child.on('exit', (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 1);
+});

package/package.json

@@ -1,24 +1,44 @@
-{
-  "name": "speakdrill",
-  "version": "0.1.0",
-  "description": "口說課程自動化練習：TTS 產生示範語音、逐句驅動課程演練、輸出分數報告（Rust，含 TUI / 原生 GUI）",
-  "keywords": ["speaking", "shadowing", "drill", "tts", "voicemeeter", "english", "cli", "tui", "gui", "windows"],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/thumb2086/speakdrill.git"
-  },
-  "homepage": "https://github.com/thumb2086/speakdrill#readme",
-  "bin": {
-    "speakdrill": "bin/speakdrill.js"
-  },
-  "files": ["bin/", "scripts/", "README.md", "LICENSE"],
-  "scripts": {
-    "postinstall": "node scripts/install.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "os": ["win32"],
-  "cpu": ["x64"]
-}
+{
+  "name": "speakdrill",
+  "version": "0.1.1",
+  "description": "口說課程自動化練習：TTS 產生示範語音、逐句驅動課程演練、輸出分數報告（Rust，含 TUI / 原生 GUI）",
+  "keywords": [
+    "speaking",
+    "shadowing",
+    "drill",
+    "tts",
+    "voicemeeter",
+    "english",
+    "cli",
+    "tui",
+    "gui",
+    "windows"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thumb2086/speakdrill.git"
+  },
+  "homepage": "https://github.com/thumb2086/speakdrill#readme",
+  "bin": {
+    "speakdrill": "bin/speakdrill.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ]
+}

package/scripts/install.js

@@ -1,89 +1,89 @@
-#!/usr/bin/env node
-/**
- * 安裝時下載對應平台的原生二進位。
- *
- * 環境變數：
- *   SPEAKDRILL_SKIP_DOWNLOAD=1   跳過下載（本機開發用，會直接用 target/ 的執行檔）
- *   SPEAKDRILL_VERSION           指定版本（預設讀 package.json）
- *   SPEAKDRILL_REPO              覆寫 GitHub repo（預設 thumb2086/speakdrill）
- */
-const fs = require('fs');
-const path = require('path');
-const https = require('https');
-const { execFileSync } = require('child_process');
-
-const pkg = require('../package.json');
-const VERSION = process.env.SPEAKDRILL_VERSION || pkg.version;
-const REPO = process.env.SPEAKDRILL_REPO || 'thumb2086/speakdrill';
-
-if (process.env.SPEAKDRILL_SKIP_DOWNLOAD === '1') {
-  console.log('[speakdrill] SPEAKDRILL_SKIP_DOWNLOAD=1，跳過下載');
-  process.exit(0);
-}
-
-if (process.platform !== 'win32') {
-  console.log(
-    `[speakdrill] 目前只支援 Windows（需要 VoiceMeeter）。你的平台是 ${process.platform}，跳過安裝。`
-  );
-  process.exit(0);
-}
-
-const exes = ['speakdrill.exe', 'speakdrill-gui.exe'];
-const dir = `${process.platform}-${process.arch}`;
-const outDir = path.join(__dirname, '..', 'bin', 'binaries', dir);
-
-const tag = `v${VERSION}`;
-const asset = `speakdrill-${tag}-${dir}.zip`;
-const url = `https://github.com/${REPO}/releases/download/${tag}/${asset}`;
-
-function download(u, dest) {
-  return new Promise((resolve, reject) => {
-    const go = (u2, depth = 0) => {
-      if (depth > 5) return reject(new Error('太多重新導向'));
-      https
-        .get(u2, { headers: { 'User-Agent': 'speakdrill-installer' } }, (res) => {
-          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-            res.resume();
-            return go(res.headers.location, depth + 1);
-          }
-          if (res.statusCode !== 200) {
-            res.resume();
-            return reject(new Error(`HTTP ${res.statusCode} ${u2}`));
-          }
-          const f = fs.createWriteStream(dest);
-          res.pipe(f);
-          f.on('finish', () => f.close(() => resolve()));
-        })
-        .on('error', reject);
-    };
-    go(u);
-  });
-}
-
-(async () => {
-  fs.mkdirSync(outDir, { recursive: true });
-  const archive = path.join(outDir, asset);
-
-  const existing = path.join(outDir, exes[0]);
-  if (fs.existsSync(existing)) {
-    console.log(`[speakdrill] 已存在 ${existing}`);
-    return;
-  }
-
-  console.log(`[speakdrill] 下載 ${url}`);
-  try {
-    await download(url, archive);
-    execFileSync(
-      'powershell',
-      ['-NoProfile', '-Command',
-        `Expand-Archive -LiteralPath '${archive}' -DestinationPath '${outDir}' -Force`],
-      { stdio: 'inherit' }
-    );
-    fs.unlinkSync(archive);
-    console.log(`[speakdrill] 安裝完成 → ${outDir}`);
-  } catch (e) {
-    console.error(`[speakdrill] 下載失敗：${e.message}`);
-    console.error('[speakdrill] 可改用手動安裝，或設定 SPEAKDRILL_SKIP_DOWNLOAD=1 使用本機建置');
-    process.exit(0); // 不讓 npm install 整個失敗
-  }
-})();
+#!/usr/bin/env node
+/**
+ * 安裝時下載對應平台的原生二進位。
+ *
+ * 環境變數：
+ *   SPEAKDRILL_SKIP_DOWNLOAD=1   跳過下載（本機開發用，會直接用 target/ 的執行檔）
+ *   SPEAKDRILL_VERSION           指定版本（預設讀 package.json）
+ *   SPEAKDRILL_REPO              覆寫 GitHub repo（預設 thumb2086/speakdrill）
+ */
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execFileSync } = require('child_process');
+
+const pkg = require('../package.json');
+const VERSION = process.env.SPEAKDRILL_VERSION || pkg.version;
+const REPO = process.env.SPEAKDRILL_REPO || 'thumb2086/speakdrill';
+
+if (process.env.SPEAKDRILL_SKIP_DOWNLOAD === '1') {
+  console.log('[speakdrill] SPEAKDRILL_SKIP_DOWNLOAD=1，跳過下載');
+  process.exit(0);
+}
+
+if (process.platform !== 'win32') {
+  console.log(
+    `[speakdrill] 目前只支援 Windows（需要 VoiceMeeter）。你的平台是 ${process.platform}，跳過安裝。`
+  );
+  process.exit(0);
+}
+
+const exes = ['speakdrill.exe', 'speakdrill-gui.exe'];
+const dir = `${process.platform}-${process.arch}`;
+const outDir = path.join(__dirname, '..', 'bin', 'binaries', dir);
+
+const tag = `v${VERSION}`;
+const asset = `speakdrill-${tag}-${dir}.zip`;
+const url = `https://github.com/${REPO}/releases/download/${tag}/${asset}`;
+
+function download(u, dest) {
+  return new Promise((resolve, reject) => {
+    const go = (u2, depth = 0) => {
+      if (depth > 5) return reject(new Error('太多重新導向'));
+      https
+        .get(u2, { headers: { 'User-Agent': 'speakdrill-installer' } }, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            res.resume();
+            return go(res.headers.location, depth + 1);
+          }
+          if (res.statusCode !== 200) {
+            res.resume();
+            return reject(new Error(`HTTP ${res.statusCode} ${u2}`));
+          }
+          const f = fs.createWriteStream(dest);
+          res.pipe(f);
+          f.on('finish', () => f.close(() => resolve()));
+        })
+        .on('error', reject);
+    };
+    go(u);
+  });
+}
+
+(async () => {
+  fs.mkdirSync(outDir, { recursive: true });
+  const archive = path.join(outDir, asset);
+
+  const existing = path.join(outDir, exes[0]);
+  if (fs.existsSync(existing)) {
+    console.log(`[speakdrill] 已存在 ${existing}`);
+    return;
+  }
+
+  console.log(`[speakdrill] 下載 ${url}`);
+  try {
+    await download(url, archive);
+    execFileSync(
+      'powershell',
+      ['-NoProfile', '-Command',
+        `Expand-Archive -LiteralPath '${archive}' -DestinationPath '${outDir}' -Force`],
+      { stdio: 'inherit' }
+    );
+    fs.unlinkSync(archive);
+    console.log(`[speakdrill] 安裝完成 → ${outDir}`);
+  } catch (e) {
+    console.error(`[speakdrill] 下載失敗：${e.message}`);
+    console.error('[speakdrill] 可改用手動安裝，或設定 SPEAKDRILL_SKIP_DOWNLOAD=1 使用本機建置');
+    process.exit(0); // 不讓 npm install 整個失敗
+  }
+})();

package/scripts/kokoro_tts.py

@@ -1,93 +1,93 @@
-#!/usr/bin/env python3
-"""
-kokoro_tts.py — 給 speakdrill 用的 TTS 轉接器
-
-用法：
-    python kokoro_tts.py <文字檔> <輸出.wav>
-
-環境變數：
-    KOKORO_MODEL   模型路徑（預設找常見位置）
-    KOKORO_VOICES  聲音檔路徑
-    KOKORO_VOICE   音色 ID（預設 af_sol）
-    KOKORO_SPEED   語速（預設 1.0）
-
-安裝：
-    pip install kokoro-onnx soundfile
-    # 模型：https://github.com/thewh1teagle/kokoro-onnx/releases
-"""
-import os
-import sys
-import wave
-
-def find_model():
-    env = os.environ.get("KOKORO_MODEL")
-    if env and os.path.isfile(env):
-        return env
-    cands = [
-        os.path.join(os.path.dirname(__file__), "..", "models", "kokoro-v1.0.onnx"),
-        os.path.expanduser("~/.cache/kokoro/kokoro-v1.0.onnx"),
-        r"C:\Users\CPXru\Desktop\thumb\Projects\ai_vtuber\models\kokoro\kokoro-v1.1-zh.onnx",
-    ]
-    for c in cands:
-        if os.path.isfile(c):
-            return os.path.abspath(c)
-    return None
-
-def find_voices():
-    env = os.environ.get("KOKORO_VOICES")
-    if env and os.path.isfile(env):
-        return env
-    cands = [
-        os.path.join(os.path.dirname(__file__), "..", "models", "voices-v1.0.bin"),
-        os.path.expanduser("~/.cache/kokoro/voices-v1.0.bin"),
-        r"C:\Users\CPXru\Desktop\thumb\Projects\ai_vtuber\models\kokoro\voices-v1.1-zh.bin",
-    ]
-    for c in cands:
-        if os.path.isfile(c):
-            return os.path.abspath(c)
-    return None
-
-def main():
-    if len(sys.argv) < 3:
-        print("usage: kokoro_tts.py <textfile> <out.wav>", file=sys.stderr)
-        return 2
-
-    textfile, out = sys.argv[1], sys.argv[2]
-    with open(textfile, encoding="utf-8") as f:
-        text = f.read().strip()
-    if not text:
-        print("empty text", file=sys.stderr)
-        return 2
-
-    # 清掉會讓 TTS 拉長的寫法（MyET 錄音視窗只有 ~2.7 秒）
-    import re
-    text = text.replace("...", ", ").replace("…", ", ")
-    text = re.sub(r"\s+", " ", text).strip()
-
-    try:
-        import numpy as np
-        import soundfile as sf
-        from kokoro_onnx import Kokoro
-    except ImportError as e:
-        print(f"缺少套件：{e}\n請執行： pip install kokoro-onnx soundfile", file=sys.stderr)
-        return 3
-
-    model, voices = find_model(), find_voices()
-    if not model or not voices:
-        print("找不到 Kokoro 模型檔；請設定 KOKORO_MODEL / KOKORO_VOICES", file=sys.stderr)
-        return 3
-
-    voice = os.environ.get("KOKORO_VOICE", "af_sol")
-    speed = float(os.environ.get("KOKORO_SPEED", "1.0"))
-
-    k = Kokoro(model, voices)
-    samples, sr = k.create(text, voice=voice, speed=speed, lang="en-us")
-    a = np.asarray(samples, dtype="float32")
-    peak = float(np.max(np.abs(a))) if a.size else 0.0
-    if peak > 0:
-        a = a * (0.95 / peak)
-    sf.write(out, a, sr)
-    return 0
-
-if __name__ == "__main__":
-    sys.exit(main())
+#!/usr/bin/env python3
+"""
+kokoro_tts.py — 給 speakdrill 用的 TTS 轉接器
+
+用法：
+    python kokoro_tts.py <文字檔> <輸出.wav>
+
+環境變數：
+    KOKORO_MODEL   模型路徑（預設找常見位置）
+    KOKORO_VOICES  聲音檔路徑
+    KOKORO_VOICE   音色 ID（預設 af_sol）
+    KOKORO_SPEED   語速（預設 1.0）
+
+安裝：
+    pip install kokoro-onnx soundfile
+    # 模型：https://github.com/thewh1teagle/kokoro-onnx/releases
+"""
+import os
+import sys
+import wave
+
+def find_model():
+    env = os.environ.get("KOKORO_MODEL")
+    if env and os.path.isfile(env):
+        return env
+    cands = [
+        os.path.join(os.path.dirname(__file__), "..", "models", "kokoro-v1.0.onnx"),
+        os.path.expanduser("~/.cache/kokoro/kokoro-v1.0.onnx"),
+        r"C:\Users\CPXru\Desktop\thumb\Projects\ai_vtuber\models\kokoro\kokoro-v1.1-zh.onnx",
+    ]
+    for c in cands:
+        if os.path.isfile(c):
+            return os.path.abspath(c)
+    return None
+
+def find_voices():
+    env = os.environ.get("KOKORO_VOICES")
+    if env and os.path.isfile(env):
+        return env
+    cands = [
+        os.path.join(os.path.dirname(__file__), "..", "models", "voices-v1.0.bin"),
+        os.path.expanduser("~/.cache/kokoro/voices-v1.0.bin"),
+        r"C:\Users\CPXru\Desktop\thumb\Projects\ai_vtuber\models\kokoro\voices-v1.1-zh.bin",
+    ]
+    for c in cands:
+        if os.path.isfile(c):
+            return os.path.abspath(c)
+    return None
+
+def main():
+    if len(sys.argv) < 3:
+        print("usage: kokoro_tts.py <textfile> <out.wav>", file=sys.stderr)
+        return 2
+
+    textfile, out = sys.argv[1], sys.argv[2]
+    with open(textfile, encoding="utf-8") as f:
+        text = f.read().strip()
+    if not text:
+        print("empty text", file=sys.stderr)
+        return 2
+
+    # 清掉會讓 TTS 拉長的寫法（MyET 錄音視窗只有 ~2.7 秒）
+    import re
+    text = text.replace("...", ", ").replace("…", ", ")
+    text = re.sub(r"\s+", " ", text).strip()
+
+    try:
+        import numpy as np
+        import soundfile as sf
+        from kokoro_onnx import Kokoro
+    except ImportError as e:
+        print(f"缺少套件：{e}\n請執行： pip install kokoro-onnx soundfile", file=sys.stderr)
+        return 3
+
+    model, voices = find_model(), find_voices()
+    if not model or not voices:
+        print("找不到 Kokoro 模型檔；請設定 KOKORO_MODEL / KOKORO_VOICES", file=sys.stderr)
+        return 3
+
+    voice = os.environ.get("KOKORO_VOICE", "af_sol")
+    speed = float(os.environ.get("KOKORO_SPEED", "1.0"))
+
+    k = Kokoro(model, voices)
+    samples, sr = k.create(text, voice=voice, speed=speed, lang="en-us")
+    a = np.asarray(samples, dtype="float32")
+    peak = float(np.max(np.abs(a))) if a.size else 0.0
+    if peak > 0:
+        a = a * (0.95 / peak)
+    sf.write(out, a, sr)
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())