termux-stt 1.2.11 → 1.2.12

package/README.md

@@ -1,77 +1,77 @@
-# Termux-STT
-
-[![PyPI](https://img.shields.io/pypi/v/termux-stt.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-stt/)
-[![Python](https://img.shields.io/pypi/pyversions/termux-stt.svg?style=flat-square)](https://pypi.org/project/termux-stt/)
-[![npm](https://img.shields.io/npm/v/termux-stt.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/termux-stt)
-[![npm downloads](https://img.shields.io/npm/dm/termux-stt.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/termux-stt)
-[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-stt)
-
-> **디바이스 리소스를 활용한 통합 온디바이스 음성인식(STT) 및 순수 Python 128d X-Vector 화자 분리 프레임워크**  
-> *Unified On-Device Speech-to-Text Utilizing Device Resources & Pure Python 128d X-Vector Speaker Diarization*
-
----
-
-## Architecture & Overview
-
-Whisper.cpp, Vosk, Sherpa-ONNX 3대 네이티브 엔진을 통합하고, 닫힌 형태 순수 Python 128차원 X-Vector 클러스터링을 결합하여 80MB 미만의 초경량 메모리로 100% 온디바이스 실시간 음성인식과 화자 분리를 구현합니다.
-
-Integrates Whisper.cpp, Vosk, and Sherpa-ONNX with a closed-form pure-Python 128-dimensional X-Vector clustering algorithm that operates in under 80MB RAM with zero cloud egress.
-
----
-
-## Installation & Quickstart
-
-### Python (PyPI)
-```bash
-pip install termux-stt
-```
-```python
-from termux_stt import create_engine
-
-# 1. Initialize Engine (auto-loads native ARM NEON binary & cached model)
-engine = create_engine("whisper", model="tiny", lang="en", threads=4)
-
-# 2. Transcribe Audio directly into Subtitles
-result = engine.transcribe("samples/jfk_1min.wav")
-print("Transcript:\n", result.text)
-print("SRT Subtitles:\n", result.to_srt())
-
-# 3. 2-Speaker Diarization without PyTorch
-hybrid = create_engine("hybrid", lang="en", num_speakers=2)
-diar_result = hybrid.diarize("samples/jfk_1min.wav")
-for seg in diar_result.segments:
-    print(f"[{seg.speaker}] ({seg.start:.1f}s -> {seg.end:.1f}s): {seg.text}")
-
-```
-
-### Node.js / TypeScript (npm)
-```bash
-npm install termux-stt
-```
-```typescript
-const { createEngine } = require("termux-stt");
-
-async function main() {
-  // 1. Initialize Whisper Engine
-  const engine = createEngine("whisper", { model: "tiny", lang: "en", threads: 4 });
-
-  // 2. Transcribe Audio
-  const result = await engine.transcribe("samples/jfk_1min.wav");
-  console.log("Transcript:", result.text);
-  console.log("SRT Subtitles:\n", result.toSrt());
-}
-main();
-
-```
-
----
-
-## Official Documentation & Benchmarks
-- [Official Architecture & API Reference](https://uno-km.vercel.app/lib/stt/)
-- [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)
-- [AMEVA Open-Source Foundation Portal](https://uno-km.vercel.app/foundation/index.html)
-
----
-
-## License
-Licensed under the Apache-2.0 License. Copyright (c) 2026 Eunho Kim ([@uno-km](https://github.com/uno-km)).
+# Termux-STT
+
+[![PyPI](https://img.shields.io/pypi/v/termux-stt.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-stt/)
+[![Python](https://img.shields.io/pypi/pyversions/termux-stt.svg?style=flat-square)](https://pypi.org/project/termux-stt/)
+[![npm](https://img.shields.io/npm/v/termux-stt.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/termux-stt)
+[![npm downloads](https://img.shields.io/npm/dm/termux-stt.svg?style=flat-square&color=b91c1c)](https://www.npmjs.com/package/termux-stt)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-stt)
+
+> **디바이스 리소스를 활용한 통합 온디바이스 음성인식(STT) 및 순수 Python 128d X-Vector 화자 분리 프레임워크**  
+> *Unified On-Device Speech-to-Text Utilizing Device Resources & Pure Python 128d X-Vector Speaker Diarization*
+
+---
+
+## Architecture & Overview
+
+Whisper.cpp, Vosk, Sherpa-ONNX 3대 네이티브 엔진을 통합하고, 닫힌 형태 순수 Python 128차원 X-Vector 클러스터링을 결합하여 80MB 미만의 초경량 메모리로 100% 온디바이스 실시간 음성인식과 화자 분리를 구현합니다.
+
+Integrates Whisper.cpp, Vosk, and Sherpa-ONNX with a closed-form pure-Python 128-dimensional X-Vector clustering algorithm that operates in under 80MB RAM with zero cloud egress.
+
+---
+
+## Installation & Quickstart
+
+### Python (PyPI)
+```bash
+pip install termux-stt
+```
+```python
+from termux_stt import create_engine
+
+# 1. Initialize Engine (auto-loads native ARM NEON binary & cached model)
+engine = create_engine("whisper", model="tiny", lang="en", threads=4)
+
+# 2. Transcribe Audio directly into Subtitles
+result = engine.transcribe("samples/jfk_1min.wav")
+print("Transcript:\n", result.text)
+print("SRT Subtitles:\n", result.to_srt())
+
+# 3. 2-Speaker Diarization without PyTorch
+hybrid = create_engine("hybrid", lang="en", num_speakers=2)
+diar_result = hybrid.diarize("samples/jfk_1min.wav")
+for seg in diar_result.segments:
+    print(f"[{seg.speaker}] ({seg.start:.1f}s -> {seg.end:.1f}s): {seg.text}")
+
+```
+
+### Node.js / TypeScript (npm)
+```bash
+npm install termux-stt
+```
+```typescript
+const { createEngine } = require("termux-stt");
+
+async function main() {
+  // 1. Initialize Whisper Engine
+  const engine = createEngine("whisper", { model: "tiny", lang: "en", threads: 4 });
+
+  // 2. Transcribe Audio
+  const result = await engine.transcribe("samples/jfk_1min.wav");
+  console.log("Transcript:", result.text);
+  console.log("SRT Subtitles:\n", result.toSrt());
+}
+main();
+
+```
+
+---
+
+## Official Documentation & Benchmarks
+- [Official Architecture & API Reference](https://uno-km.vercel.app/lib/stt/)
+- [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)
+- [AMEVA Open-Source Foundation Portal](https://uno-km.vercel.app/foundation/index.html)
+
+---
+
+## License
+Licensed under the Apache-2.0 License. Copyright (c) 2026 Eunho Kim ([@uno-km](https://github.com/uno-km)).

package/README.pypi.md

@@ -1,44 +1,44 @@
-# Termux-STT (Python)
-
-[![PyPI](https://img.shields.io/pypi/v/termux-stt.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-stt/)
-[![Python](https://img.shields.io/pypi/pyversions/termux-stt.svg?style=flat-square)](https://pypi.org/project/termux-stt/)
-[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-stt)
-
-> Unified On-Device Speech-to-Text Utilizing Device Resources & Pure Python 128d X-Vector Speaker Diarization
-
-## Installation
-
-```bash
-pip install termux-stt
-```
-
-## Quickstart
-
-```python
-from termux_stt import create_engine
-
-# 1. Initialize Engine (auto-loads native ARM NEON binary & cached model)
-engine = create_engine("whisper", model="tiny", lang="en", threads=4)
-
-# 2. Transcribe Audio directly into Subtitles
-result = engine.transcribe("samples/jfk_1min.wav")
-print("Transcript:\n", result.text)
-print("SRT Subtitles:\n", result.to_srt())
-
-# 3. 2-Speaker Diarization without PyTorch
-hybrid = create_engine("hybrid", lang="en", num_speakers=2)
-diar_result = hybrid.diarize("samples/jfk_1min.wav")
-for seg in diar_result.segments:
-    print(f"[{seg.speaker}] ({seg.start:.1f}s -> {seg.end:.1f}s): {seg.text}")
-
-```
-
-## Description
-Integrates Whisper.cpp, Vosk, and Sherpa-ONNX with a closed-form pure-Python 128-dimensional X-Vector clustering algorithm that operates in under 80MB RAM with zero cloud egress.
-
-## Documentation
-- [Official Documentation & API Reference](https://uno-km.vercel.app/lib/stt/)
-- [GitHub Repository](https://github.com/uno-km/termux-stt)
-
-## License
-Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).
+# Termux-STT (Python)
+
+[![PyPI](https://img.shields.io/pypi/v/termux-stt.svg?style=flat-square&color=0369a1)](https://pypi.org/project/termux-stt/)
+[![Python](https://img.shields.io/pypi/pyversions/termux-stt.svg?style=flat-square)](https://pypi.org/project/termux-stt/)
+[![License](https://img.shields.io/badge/License-Apache_2.0-004499.svg?style=flat-square)](https://github.com/uno-km/termux-stt)
+
+> Unified On-Device Speech-to-Text Utilizing Device Resources & Pure Python 128d X-Vector Speaker Diarization
+
+## Installation
+
+```bash
+pip install termux-stt
+```
+
+## Quickstart
+
+```python
+from termux_stt import create_engine
+
+# 1. Initialize Engine (auto-loads native ARM NEON binary & cached model)
+engine = create_engine("whisper", model="tiny", lang="en", threads=4)
+
+# 2. Transcribe Audio directly into Subtitles
+result = engine.transcribe("samples/jfk_1min.wav")
+print("Transcript:\n", result.text)
+print("SRT Subtitles:\n", result.to_srt())
+
+# 3. 2-Speaker Diarization without PyTorch
+hybrid = create_engine("hybrid", lang="en", num_speakers=2)
+diar_result = hybrid.diarize("samples/jfk_1min.wav")
+for seg in diar_result.segments:
+    print(f"[{seg.speaker}] ({seg.start:.1f}s -> {seg.end:.1f}s): {seg.text}")
+
+```
+
+## Description
+Integrates Whisper.cpp, Vosk, and Sherpa-ONNX with a closed-form pure-Python 128-dimensional X-Vector clustering algorithm that operates in under 80MB RAM with zero cloud egress.
+
+## Documentation
+- [Official Documentation & API Reference](https://uno-km.vercel.app/lib/stt/)
+- [GitHub Repository](https://github.com/uno-km/termux-stt)
+
+## License
+Apache-2.0 License. Copyright (c) 2026 Eunho Kim (@uno-km).

package/bin/cli.js

@@ -1,51 +1,51 @@
-#!/usr/bin/env node
-/**
- * AMEVA Standard Node.js CLI Runner for termux_stt.
- * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
- */
-const fs = require('fs');
-const { spawn, execSync } = require('child_process');
-
-function findPython() {
-  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
-    return process.env.PYTHON;
-  }
-  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
-  if (fs.existsSync(termuxBin)) {
-    return termuxBin;
-  }
-  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
-  if (fs.existsSync(termuxBinAlt)) {
-    return termuxBinAlt;
-  }
-  const candidates = ['python3', 'python'];
-  for (const cmd of candidates) {
-    try {
-      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
-      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
-      if (res) return cmd;
-    } catch (_) {}
-  }
-  return 'python3';
-}
-
-const pythonBin = findPython();
-const args = ['-m', 'termux_stt', ...process.argv.slice(2)];
-
-const child = spawn(pythonBin, args, {
-  stdio: 'inherit',
-  env: process.env
-});
-
-child.on('error', (err) => {
-  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
-  process.exit(1);
-});
-
-child.on('exit', (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal);
-  } else {
-    process.exit(code || 0);
-  }
-});
+#!/usr/bin/env node
+/**
+ * AMEVA Standard Node.js CLI Runner for termux_stt.
+ * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
+ */
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+
+function findPython() {
+  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
+    return process.env.PYTHON;
+  }
+  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
+  if (fs.existsSync(termuxBin)) {
+    return termuxBin;
+  }
+  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
+  if (fs.existsSync(termuxBinAlt)) {
+    return termuxBinAlt;
+  }
+  const candidates = ['python3', 'python'];
+  for (const cmd of candidates) {
+    try {
+      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
+      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+      if (res) return cmd;
+    } catch (_) {}
+  }
+  return 'python3';
+}
+
+const pythonBin = findPython();
+const args = ['-m', 'termux_stt', ...process.argv.slice(2)];
+
+const child = spawn(pythonBin, args, {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('error', (err) => {
+  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/bin/termux-stt.js

@@ -1,51 +1,51 @@
-#!/usr/bin/env node
-/**
- * AMEVA Standard Node.js CLI Runner for termux_stt.
- * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
- */
-const fs = require('fs');
-const { spawn, execSync } = require('child_process');
-
-function findPython() {
-  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
-    return process.env.PYTHON;
-  }
-  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
-  if (fs.existsSync(termuxBin)) {
-    return termuxBin;
-  }
-  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
-  if (fs.existsSync(termuxBinAlt)) {
-    return termuxBinAlt;
-  }
-  const candidates = ['python3', 'python'];
-  for (const cmd of candidates) {
-    try {
-      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
-      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
-      if (res) return cmd;
-    } catch (_) {}
-  }
-  return 'python3';
-}
-
-const pythonBin = findPython();
-const args = ['-m', 'termux_stt.platform.installer', ...process.argv.slice(2)];
-
-const child = spawn(pythonBin, args, {
-  stdio: 'inherit',
-  env: process.env
-});
-
-child.on('error', (err) => {
-  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
-  process.exit(1);
-});
-
-child.on('exit', (code, signal) => {
-  if (signal) {
-    process.kill(process.pid, signal);
-  } else {
-    process.exit(code || 0);
-  }
-});
+#!/usr/bin/env node
+/**
+ * AMEVA Standard Node.js CLI Runner for termux_stt.
+ * Automatically resolves Python 3 environment and dispatches to python -m termux_stt.
+ */
+const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+
+function findPython() {
+  if (process.env.PYTHON && fs.existsSync(process.env.PYTHON)) {
+    return process.env.PYTHON;
+  }
+  const termuxBin = '/data/data/com.termux/files/usr/bin/python3';
+  if (fs.existsSync(termuxBin)) {
+    return termuxBin;
+  }
+  const termuxBinAlt = '/data/data/com.termux/files/usr/bin/python';
+  if (fs.existsSync(termuxBinAlt)) {
+    return termuxBinAlt;
+  }
+  const candidates = ['python3', 'python'];
+  for (const cmd of candidates) {
+    try {
+      const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `command -v ${cmd}`;
+      const res = execSync(checkCmd, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+      if (res) return cmd;
+    } catch (_) {}
+  }
+  return 'python3';
+}
+
+const pythonBin = findPython();
+const args = ['-m', 'termux_stt.platform.installer', ...process.argv.slice(2)];
+
+const child = spawn(pythonBin, args, {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('error', (err) => {
+  console.error(`[${'termux_stt'}] Failed to spawn python process (${pythonBin}):`, err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/index.d.ts

@@ -60,4 +60,4 @@ export function createEngine(
   options?: EngineOptions
 ): Engine;
 
-export function formatTime(seconds: number, separator?: string): string;
+export function formatTime(seconds: number, separator?: string): string;

package/package.json

@@ -1,87 +1,87 @@
-{
-  "name": "termux-stt",
-  "version": "1.2.11",
-  "description": "On-device Speech-to-Text & speaker diarization framework utilizing device resources for Android Termux",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "bin": {
-    "termux-stt": "bin/cli.js",
-    "termux-stt-install": "bin/termux-stt.js"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "lib",
-    "bin",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/uno-km/termux-stt.git"
-  },
-  "keywords": [
-    "termux",
-    "stt",
-    "speech-to-text",
-    "whisper",
-    "whisper-cpp",
-    "vosk",
-    "sherpa-onnx",
-    "diarization",
-    "speaker-diarization",
-    "voice-recognition",
-    "audio-transcription",
-    "on-device-ai",
-    "edge-ai",
-    "mobile-ai",
-    "vulkan",
-    "vulkan-compute",
-    "gpu-acceleration",
-    "real-time-factor",
-    "low-latency",
-    "arm64",
-    "android",
-    "snapdragon",
-    "adreno",
-    "exynos",
-    "arm-mali",
-    "zero-compilation",
-    "vad",
-    "voice-activity-detection",
-    "silero-vad",
-    "x-vector",
-    "k-means",
-    "clustering",
-    "srt-export",
-    "vtt-export",
-    "rttm",
-    "microphone-streaming",
-    "headless-audio",
-    "pulseaudio",
-    "offline-speech",
-    "privacy-first",
-    "termux-aichain",
-    "termux-tts",
-    "termux-llamacpp",
-    "termux-diffusion",
-    "ameva-runtime",
-    "ggml",
-    "quantization",
-    "bionic-libc",
-    "autonomous-agents",
-    "voice-assistant"
-  ],
-  "author": "uno-km (AMEVA Foundation) <dev@ameva.org>",
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/uno-km/termux-stt/issues"
-  },
-  "homepage": "https://uno-km.github.io/termux-stt/",
-  "dependencies": {
-    "@ameva/runtime": ">=2.0.0"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  }
-}
+{
+  "name": "termux-stt",
+  "version": "1.2.12",
+  "description": "On-device Speech-to-Text & speaker diarization framework utilizing device resources for Android Termux",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "termux-stt": "bin/cli.js",
+    "termux-stt-install": "bin/termux-stt.js"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "lib",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uno-km/termux-stt.git"
+  },
+  "keywords": [
+    "termux",
+    "stt",
+    "speech-to-text",
+    "whisper",
+    "whisper-cpp",
+    "vosk",
+    "sherpa-onnx",
+    "diarization",
+    "speaker-diarization",
+    "voice-recognition",
+    "audio-transcription",
+    "on-device-ai",
+    "edge-ai",
+    "mobile-ai",
+    "vulkan",
+    "vulkan-compute",
+    "gpu-acceleration",
+    "real-time-factor",
+    "low-latency",
+    "arm64",
+    "android",
+    "snapdragon",
+    "adreno",
+    "exynos",
+    "arm-mali",
+    "zero-compilation",
+    "vad",
+    "voice-activity-detection",
+    "silero-vad",
+    "x-vector",
+    "k-means",
+    "clustering",
+    "srt-export",
+    "vtt-export",
+    "rttm",
+    "microphone-streaming",
+    "headless-audio",
+    "pulseaudio",
+    "offline-speech",
+    "privacy-first",
+    "termux-aichain",
+    "termux-tts",
+    "termux-llamacpp",
+    "termux-diffusion",
+    "ameva-runtime",
+    "ggml",
+    "quantization",
+    "bionic-libc",
+    "autonomous-agents",
+    "voice-assistant"
+  ],
+  "author": "uno-km (AMEVA Foundation) <dev@ameva.org>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/uno-km/termux-stt/issues"
+  },
+  "homepage": "https://uno-km.github.io/termux-stt/",
+  "dependencies": {
+    "@ameva/runtime": ">=2.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}