termux-stt 1.1.5 → 1.1.7

package/README.md

@@ -1,389 +1,67 @@
-# Termux-STT
+# termux-stt
 
-<div align="center">
-
-```
- ████████╗███████╗██████╗ ███╗   ███╗██╗   ██╗██╗  ██╗      ███████╗████████╗████████╗
- ╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║   ██║╚██╗██╔╝      ██╔════╝╚══██╔══╝╚══██╔══╝
-    ██║   █████╗  ██████╔╝██╔████╔██║██║   ██║ ╚███╔╝ █████╗███████╗   ██║      ██║   
-    ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║██║   ██║ ██╔██╗ ╚════╝╚════██║   ██║      ██║   
-    ██║   ███████╗██║  ██║██║ ╚═╝ ██║╚██████╔╝██╔╝ ██╗      ███████║   ██║      ██║   
-    ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝      ╚══════╝   ╚═╝      ╚═╝   
-```
-
-**Production-Grade On-Device Speech-to-Text & Speaker Diarization Framework for Android Termux**  
-*Dual-Engine Architecture (Python & Node.js / TypeScript) with Native Bionic ARM64 Acceleration & 0 PyTorch Dependency*
+> **Production-Grade On-Device Speech-to-Text & Speaker Diarization Framework for Node.js on Android Termux.**
 
 <p align="center">
-  <a href="https://pypi.org/project/termux-stt/"><img src="https://img.shields.io/pypi/v/termux-stt.svg?style=for-the-badge&color=0088ff&logo=pypi&logoColor=white" alt="PyPI Version" /></a>
-  <a href="https://pypi.org/project/termux-stt/"><img src="https://img.shields.io/badge/PyPI%20Downloads-active-0088ff?style=for-the-badge&logo=pypi&logoColor=white" alt="PyPI Downloads" /></a>
-  <a href="https://www.npmjs.com/package/termux-stt"><img src="https://img.shields.io/npm/v/termux-stt.svg?style=for-the-badge&color=cb3837&logo=npm&logoColor=white" alt="npm Version" /></a>
-  <a href="https://www.npmjs.com/package/termux-stt"><img src="https://img.shields.io/badge/npm%20Downloads-active-cb3837?style=for-the-badge&logo=npm&logoColor=white" alt="npm Downloads" /></a>
+  <a href="https://www.npmjs.com/package/termux-stt"><img src="https://img.shields.io/npm/v/termux-stt.svg?style=flat-square&color=cb3837&logo=npm&logoColor=white" alt="npm Version" /></a>
+  <a href="https://www.npmjs.com/package/termux-stt"><img src="https://img.shields.io/badge/npm%20Downloads-active-cb3837?style=flat-square&logo=npm&logoColor=white" alt="npm Downloads" /></a>
+  <a href="https://github.com/uno-km/termux-stt/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=flat-square" alt="License" /></a>
+  <img src="https://img.shields.io/badge/Platform-Android%20Termux%20(ARM64)-00887A?style=flat-square&logo=android&logoColor=white" alt="Platform" />
 </p>
 
-<p align="center">
-  <a href="https://uno-km.vercel.app/lib/stt/"><img src="https://img.shields.io/badge/Official_Docs-uno--km.vercel.app%2Flib%2Fstt-004499?style=for-the-badge&logo=vercel&logoColor=white" alt="Live Docs" /></a>
-  <a href="https://uno-km.vercel.app/lib/stt/demo.html"><img src="https://img.shields.io/badge/Live_Showcase-▶_Audio_Player-00f5d4?style=for-the-badge&logo=googlechrome&logoColor=0b132b" alt="Live Audio Showcase" /></a>
-  <a href="https://github.com/uno-km/termux-stt"><img src="https://img.shields.io/github/stars/uno-km/termux-stt?style=for-the-badge&color=gold&logo=github" alt="GitHub Stars" /></a>
-  <a href="https://github.com/uno-km/termux-stt/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge" alt="License" /></a>
-</p>
-
-<p align="center">
-  <img src="https://img.shields.io/badge/Platform-Android%20Termux%20(ARM64%2Faarch64)-00887A?style=flat-square&logo=android&logoColor=white" alt="Platform" />
-  <img src="https://img.shields.io/badge/Engines-whisper.cpp%20%7C%20Vosk%20%7C%20Sherpa--ONNX-38bdf8?style=flat-square" alt="Engines" />
-  <img src="https://img.shields.io/badge/Diarization-128d%20X--Vector%20+%20Pure%20Python-a855f7?style=flat-square" alt="Diarization" />
-  <img src="https://img.shields.io/badge/RAM-Under%20350MB%20(Tiny%2FBase)-10b981?style=flat-square&logo=shield&logoColor=white" alt="RAM" />
-  <img src="https://img.shields.io/badge/Foundation-AOSF_Tier_1-orange?style=flat-square" alt="Foundation" />
-</p>
-
-<br/>
-
-**[Live Audio Showcase & Demo](https://uno-km.vercel.app/lib/stt/demo.html)** • **[Official Documentation Site (13 Languages)](https://uno-km.vercel.app/lib/stt/)** • **[AMEVA Foundation](https://uno-km.vercel.app/docs/foundation/)** • **[Quickstart](#1-quick-scenario-playbook)** • **[Architecture](#2-why-termux-stt-architectural-pillars)** • **[Benchmarks](#3-empirical-benchmarks-galaxy-a35--exynos-1380)**
-
-</div>
-
 ---
 
-## AMEVA Foundation — Mobile AI Ecosystem
-
-> **"$0 Cloud Egress, 0% External Data Leaks. Transforming every smartphone into an independent on-device AI workstation."**
-> The **AMEVA Open-Source Foundation (AOSF)** builds next-generation, client-centric AI runtimes spanning on-device large models, browser automation, neural network training, and speaker diarization.
-
-<div align="center">
+## 1. Quick Start
 
-| Project | Platform & Packages | Core Capability & Technology | Documentation & Demo |
-| :--- | :--- | :--- | :---: |
-| 🎙️ **[termux-stt](https://github.com/uno-km/termux-stt)** | [![Open Collective](https://img.shields.io/badge/Open_Collective-AOSF_Fund-004499?style=flat&logo=opencollective)](https://opencollective.com/ameva-fund) [![GitHub Sponsors](https://img.shields.io/badge/GitHub_Sponsors-uno--km-ea4aaa?style=flat&logo=githubsponsors)](https://github.com/sponsors/uno-km)<br/>[![PyPI](https://img.shields.io/pypi/v/termux-stt?color=blue&style=flat-square)](https://pypi.org/project/termux-stt/) [![npm](https://img.shields.io/npm/v/termux-stt?color=red&style=flat-square)](https://www.npmjs.com/package/termux-stt) | **Integrated On-Device STT & Pure Python 128d X-Vector Diarization** (Whisper + Vosk + Sherpa) | **[Showcase](https://uno-km.github.io/termux-stt/showcase.html)** • **[Docs](https://uno-km.vercel.app/lib/stt/)** |
-| 🎨 **[termux-diffusion](https://github.com/uno-km/termux-diffusion)** | [![PyPI](https://img.shields.io/pypi/v/termux-diffusion?color=blue&style=flat-square)](https://pypi.org/project/termux-diffusion/) [![npm](https://img.shields.io/npm/v/termux-diffusion?color=red&style=flat-square)](https://www.npmjs.com/package/termux-diffusion) | **Mobile On-Device Stable Diffusion Image Generation** (bfloat16 ARM NEON acceleration) | **[Docs](https://uno-km.github.io/termux-diffusion/)** |
-| 🌐 **[termux-playwright](https://github.com/uno-km/termux-playwright)** | [![PyPI](https://img.shields.io/pypi/v/termux-playwright?color=blue&style=flat-square)](https://pypi.org/project/termux-playwright/) [![npm](https://img.shields.io/npm/v/termux-playwright?color=red&style=flat-square)](https://www.npmjs.com/package/termux-playwright) | **Non-Root Native Headless Chromium Browser Automation & Scraping** | **[Docs](https://uno-km.github.io/termux-playwright/)** |
-| 🧠 **[termux-train](https://github.com/uno-km/termux-train)** | [![PyPI](https://img.shields.io/pypi/v/termux-train.svg?color=blue&style=flat-square)](https://pypi.org/project/termux-train/) | **Mobile Native Autograd Neural Network Training & LoRA Fine-Tuning** | **[Docs](https://uno-km.vercel.app/lib/train/)** |
-| 🖥️ **[AMEVA Workstation](https://github.com/uno-km/AMEVA-Workstation-Web)** | [![WebGPU](https://img.shields.io/badge/WebGPU-100%25_On--Device-00f5d4?style=flat-square)](https://ameva-workstation-web-core.vercel.app/) | **100% Client-Side WebGPU Multimodal Document Intelligence Workspace** | **[Live Demo](https://ameva-workstation-web-core.vercel.app/)** |
-| ⚡ **[AMEVA-Forge](https://github.com/uno-km/ameva-forge)** | [![WebGPU](https://img.shields.io/badge/3D_Studio-WebGPU-purple?style=flat-square)](https://uno-km.github.io/ameva-forge/demo.html) | **Real-Time 3D Neural Studio & WebGPU Visualization Engine** | **[Live Demo](https://uno-km.github.io/ameva-forge/demo.html)** |
+### 1.1 Installation
 
-</div>
-
----
-
-## 1. Installation & Provisioning
-
-### Method A: 1-Click Automated Installation (Recommended)
-`termux-stt install` automatically provisions lightweight system dependencies (`ffmpeg`, `libbluray`, `libxml2`) and fetches the **pre-compiled Bionic ARM64 `whisper-cli` binary from GitHub Releases in <1s** (with automatic local Clang/NEON compilation fallback if offline).
-
-#### Python SDK:
-```bash
-pkg update -y && pkg install python ffmpeg git -y
-pip install --upgrade termux-stt && termux-stt install
-```
-
-#### Node.js / TypeScript:
+#### 1-Click Automated Setup:
 ```bash
 pkg update -y && pkg install nodejs-lts ffmpeg git -y
-npm install -g termux-stt && termux-stt install
+npm install -g termux-stt
+termux-stt install
 ```
 
----
-
-### Method B: Manual Pre-Compiled Binary Download (Direct GitHub Release)
-If you prefer to manually download the pre-compiled ARM64 native binary without building from source:
-
+#### Manual Pre-Compiled Binary Download (Direct GitHub Release):
 ```bash
-# 1. Download official ARM64 Bionic binary directly into ~/.local/bin
 mkdir -p ~/.local/bin
 curl -sL "https://github.com/uno-km/termux-stt/releases/download/v1.1.1/whisper-cli-arm64-android" -o ~/.local/bin/whisper-cli
 chmod 755 ~/.local/bin/whisper-cli
 ln -sf ~/.local/bin/whisper-cli ~/.local/bin/whisper-cpp
-
-# 2. Ensure PATH includes ~/.local/bin
 export PATH=$HOME/.local/bin:$PATH
-
-# 3. Verify installation
-whisper-cli --help
-```
-
----
-
-### Method C: Manual Source Compilation (From Scratch)
-If you wish to compile `whisper.cpp` directly with Snapdragon / Cortex NEON vector optimizations:
-
-```bash
-pkg install -y clang cmake make git ffmpeg
-git clone --depth 1 https://github.com/ggerganov/whisper.cpp.git ~/tmp/whisper.cpp
-cmake -B ~/tmp/whisper.cpp/build -S ~/tmp/whisper.cpp -DWHISPER_NEON=ON -DCMAKE_BUILD_TYPE=Release
-cmake --build ~/tmp/whisper.cpp/build -j$(nproc)
-cp ~/tmp/whisper.cpp/build/bin/whisper-cli ~/.local/bin/whisper-cli
-chmod 755 ~/.local/bin/whisper-cli
 ```
 
----
-
-### 🎙️ Try with the Included Sample Audio! (JFK 1-Minute Speech)
+### 1.2 CLI Usage & Instant Sample Test
 
-`termux-stt` provides John F. Kennedy's 1961 Inaugural Address (60.00s 16kHz Mono PCM) for instant out-of-the-box testing.
+`termux-stt` includes a 60-second JFK inaugural address speech (`samples/jfk_1min.wav`) for immediate testing:
 
-#### Option A: CLI One-Liner (Python / npm)
 ```bash
-# 1. Download official 60s sample speech
-curl -sLO https://raw.githubusercontent.com/uno-km/termux-stt/main/samples/jfk_1min.wav
+# 1. Transcribe sample speech with Whisper Tiny (Generates SRT subtitles)
+termux-stt transcribe samples/jfk_1min.wav --engine whisper --model tiny --format srt
 
-# 2. Transcribe the 60s sample speech with Whisper (auto-generates SRT subtitles)
-termux-stt transcribe jfk_1min.wav --engine whisper --model tiny --format srt
-
-# 3. Transcribe and separate speakers (128d X-Vector Diarization)
-termux-stt diarize jfk_1min.wav --speakers 2 --format text
-
-# 4. Benchmark on-device latency & RTF
-termux-stt benchmark --audio jfk_1min.wav --model tiny
+# 2. Transcribe with 128d Pure Python Speaker Diarization
+termux-stt diarize samples/jfk_1min.wav --speakers 2
 ```
 
-#### Option B: Python SDK
-```python
-from termux_stt import create_engine
-
-# 1. Initialize Whisper Engine (auto-loads native ARM NEON binary)
-engine = create_engine("whisper", model="tiny", lang="en", threads=4)
-
-# 2. Transcribe JFK 60s speech
-result = engine.transcribe("samples/jfk_1min.wav")
+---
 
-print("Transcript:\n", result.text)
-print("SRT Subtitles:\n", result.to_srt())
-```
+## 2. Programmatic Node.js API
 
-#### Option C: Node.js / TypeScript
 ```javascript
-const { createEngine } = require("termux-stt");
+const { createEngine } = require('termux-stt');
 
 async function main() {
-  const engine = createEngine("whisper", { model: "tiny", lang: "en", threads: 4 });
-  const result = await engine.transcribe("samples/jfk_1min.wav");
-  
-  console.log("Transcript:", result.text);
-  console.log("SRT Subtitles:\n", result.toSrt());
+  const engine = createEngine('whisper', { model: 'tiny', lang: 'en', threads: 4 });
+  const result = await engine.transcribe('samples/jfk_1min.wav');
+  console.log('Transcription:', result.text);
+  console.log('SRT Subtitles:\n', result.toSrt());
 }
-main();
-```
-
----
-
-## 2. Advanced Scenarios
-
-### [Streaming] Scenario 3: Real-Time Microphone Streaming
-
-Speak into your smartphone microphone and receive real-time transcribed text with sub-second latency:
-
-```python
-from termux_stt import create_engine
-
-# Use ultra-lightweight Tiny model (RTF 0.80 on Exynos 1380)
-engine = create_engine("whisper", model="tiny", lang="ko")
-
-print("🎙️ Listening... Speak into your phone microphone (Ctrl+C to stop)")
-for segment in engine.stream_mic():
-    print(f"[{segment.start:.1f}s -> {segment.end:.1f}s] {segment.text}")
-```
-
----
-
-### [Diarize] Scenario 4: Hybrid Speaker Diarization ("Who Spoke When?")
-
-Run high-precision speaker diarization without PyTorch or CUDA:
 
-```python
-from termux_stt import create_engine
-
-# Hybrid Pipeline: Vosk 128d X-Vector + Whisper STT + Pure Python K-Means
-engine = create_engine("hybrid", lang="ko", num_speakers=2)
-result = engine.diarize("interview.wav")
-
-for seg in result.segments:
-    print(f"[{seg.speaker}] ({seg.start:.1f}s - {seg.end:.1f}s): {seg.text}")
-```
-
-*Output Example:*
-```text
-[Speaker_0] (0.0s - 3.5s): Welcome to today's financial intelligence briefing.
-[Speaker_1] (3.8s - 7.2s): Major equity indices closed higher following sustained foreign institutional inflows.
-[Speaker_0] (7.5s - 10.1s): What is the latest outlook on the semiconductor sector?
-```
-
----
-
-## 2. 🏛️ Why termux-stt? Architectural Pillars
-
-```
-┌─────────────────────────────────────────────────────────────────────────────┐
-│                           termux-stt Architecture                          │
-├────────────────────────┬────────────────────────┬───────────────────────────┤
-│   User Interface Layer │   Engine Abstraction   │   Output / Export Layer   │
-│  • Python API          │  • EngineRegistry      │  • JSON / SRT / VTT       │
-│  • Node.js API         │  • create_engine()     │  • RTTM (Diarization)     │
-│  • CLI (termux-stt)    │  • ModelHub & Cache    │  • Streaming Callback     │
-├────────────────────────┼────────────────────────┼───────────────────────────┤
-│                   Core Pipeline Layer                                       │
-│  Audio Loader (7 Formats) ➔ Preprocessor (16kHz Mono) ➔ Silero-VAD Filter  │
-│  ➔ Multi-Engine STT (whisper.cpp / Vosk / Sherpa-ONNX)                     │
-│  ➔ Hybrid Diarizer (128d X-Vector ➔ Pure Python Cosine/K-Means ➔ Time Align)│
-├─────────────────────────────────────────────────────────────────────────────┤
-│                   Platform & Process Isolation                              │
-│  • Subprocess Isolation (Host Python never crashes on C++ Segfault)         │
-│  • MobileGuard (WakeLock, Doze Mode Bypass, Phantom Process Killer Shield)  │
-│  • Bionic ARM64 NEON & FP16 SIMD Acceleration                               │
-└─────────────────────────────────────────────────────────────────────────────┘
-```
-
-1. **Subprocess Isolation**: C++ inference runs in isolated native subprocesses. Memory errors or Segfaults never kill the host Python/Node.js application.
-2. **Pure Python Clustering**: Cosine distance matrix and K-Means clustering are implemented with 0 external dependencies (`numpy` / `scikit-learn` optional, not required).
-3. **Automated Android Bionic Fixes**: Solves `sys.platform = 'linux'` spoofing, libvosk CFFI extraction, and ffmpeg audio format normalization (`16kHz / 1ch / PCM s16le`) under the hood.
-4. **Mobile Battery & CPU Guard**: Manages Android WakeLocks and background task states to prevent process termination when the screen locks.
-
----
-
-## 3. 📊 Empirical Benchmarks (Galaxy A35 / Exynos 1380)
-
-> *Measured on Samsung Galaxy A35 5G (Exynos 1380 4x A78 + 4x A55, 6GB RAM, Android 14 Termux).*
-
-| Engine / Pipeline | Model | Peak RAM | RTF (Speed) | KO Accuracy | Diarization Support | Termux Rating |
-| :--- | :--- | :---: | :---: | :---: | :---: | :---: |
-| **whisper.cpp** | `ggml-tiny` (39M) | **~150 MB** | **0.80** | 85% | ❌ External | ⭐⭐⭐⭐⭐ |
-| **whisper.cpp** | `ggml-base` (74M) | ~250 MB | 1.20 | 88% | ❌ External | ⭐⭐⭐⭐ |
-| **whisper.cpp** | `ggml-medium` (769M) | ~1.5 GB | 3.40 | **95%+** | ❌ External | ⭐⭐⭐ (Golden Acc) |
-| **Vosk** | `small-ko-0.22` (42M) | **~100 MB** | **0.25** | 78% | ✅ 128d X-Vector | ⭐⭐⭐ |
-| **Sherpa-ONNX** | `Zipformer` | ~300 MB | **0.42** | 86% | ✅ CAM++ | ⭐⭐⭐⭐ |
-| **Pyannote.audio 3.1** | `diarization-3.1` | **> 3.5 GB** | 2.80~3.50 | N/A | ✅ Gold Standard | ❌ OOM Crashes |
-| **termux-stt (Hybrid)** | `Vosk + Whisper Base`| **~350 MB** | **1.45** | **92%+** | **✅ Built-in K-Means** | **⭐⭐⭐⭐⭐ (Recommended)** |
-
----
-
-## 4. ⚙️ Engine Comparison Matrix
-
-| Feature | `whisper.cpp` | `Vosk` | `Sherpa-ONNX` | `Hybrid (Vosk+Whisper)` |
-| :--- | :---: | :---: | :---: | :---: |
-| **Primary Strength** | Highest Text Accuracy | Ultra-Low RAM & Fast | Ultra-Low Latency | **STT + Diarization Combined** |
-| **Memory Footprint** | 150MB ~ 1.5GB | **< 100MB** | 300MB ~ 500MB | **~ 350MB** |
-| **Real-Time Factor (RTF)** | 0.80 (Tiny) | **0.25 (Blazing)** | **0.42 (Fast)** | 1.45 (Full Pipeline) |
-| **Speaker Diarization** | ❌ None | ⚠️ Basic X-Vector | ⚠️ CAM++ C++ | **✅ High-Precision Aligned** |
-| **Recommended Use Case** | Quality Transcripts | Embedded / Low Spec | Live Voice Assistant | **Meetings / Interviews** |
-
----
-
-## 5. 📚 Complete API Reference Summary
-
-### Python API
-
-```python
-import termux_stt
-
-# Create Engine with fine-grained control parameters
-engine = termux_stt.create_engine(
-    engine="whisper",         # "whisper" | "vosk" | "sherpa" | "hybrid"
-    model="base",             # "tiny" | "base" | "small" | "medium" | "custom"
-    lang="ko",                # ISO 639-1 language code
-    num_speakers=0,           # 0 = disabled, 2+ = enable diarization
-    threads=4,                # CPU threads (defaults to big cores count)
-    vad=True,                 # Enable Silero-VAD silence stripping
-    quantization="q5_1",      # "f16" | "q8_0" | "q5_1" | "q4_0"
-    prompt="Financial briefing", # Initial decoding context / vocabulary
-    beam_size=5,              # Beam search beam size
-    temperature=0.0           # Sampling temperature
-)
-
-# Transcribe File
-result = engine.transcribe("audio.wav")
-# Returns: TranscriptResult(text=str, segments=List[Segment], language=str, duration=float)
-
-# Export Methods
-result.to_json()              # Structured JSON string
-result.to_srt()               # Standard SRT subtitle format
-result.to_vtt()               # WebVTT subtitle format
-result.to_rttm()              # NIST RTTM diarization format
-
-# Stream Microphone
-for seg in engine.stream_mic(duration=30.0):
-    print(f"[{seg.speaker}] {seg.text}")
-
-# Speaker Diarization
-diar_result = engine.diarize("meeting.wav", num_speakers=2)
-```
-
-### CLI Reference
-
-```bash
-# General Syntax
-termux-stt [COMMAND] [OPTIONS] [FILE]
-
-# Commands
-termux-stt transcribe [FILE]   # Transcribe audio file (--prompt, --beam-size, --translate)
-termux-stt listen              # Real-time microphone transcription
-termux-stt diarize [FILE]      # Perform speaker diarization
-termux-stt models list         # List installed and available models
-termux-stt models download [M] # Download specific model
-termux-stt doctor              # Run hardware and environment diagnostics
-termux-stt benchmark           # Run performance benchmark suite
+main();
 ```
 
 ---
 
-## 6. 🛠️ Troubleshooting & Android FAQs
-
-### Q1: `pip install vosk` fails with CMake or wheel error on Android
-* **Cause**: Vosk does not publish official prebuilt aarch64-android wheels on PyPI.
-* **Solution**: `termux-stt-install` automatically extracts `libvosk.so` from the official Android AAR and generates the CFFI bindings.
-
-### Q2: Whisper crashes on 44.1kHz stereo MP3/M4A files
-* **Cause**: Whisper models strictly require single-channel 16,000Hz 16-bit PCM WAV.
-* **Solution**: `termux-stt` automatically runs `ffmpeg` normalization on any audio format (`mp3`, `m4a`, `flac`, `ogg`, `opus`, `webm`).
-
-### Q3: Process killed after 10 minutes in background
-* **Cause**: Android Phantom Process Killer terminates background tasks.
-* **Solution**: Enable Termux WakeLock (`termux-wake-lock`) and disable battery optimization for Termux in Android Settings.
-
----
-
-## 7. 🔍 15-Part Empirical Research Blog Series
-
-This framework is built upon the exhaustive 15-part research series published on [Eunho Kim's Technical Engineering Blog](https://uno-kim.tistory.com/):
-
-1. [[Whisper.cpp] #1. Edge Agent AI: Whisper.cpp Speech Processing (Base vs Tiny)](https://uno-kim.tistory.com/467)
-2. [[Audio Extraction] #2. Extracting Specific Audio Segments on Android](https://uno-kim.tistory.com/468)
-3. [[Whisper.cpp] #3. Korean STT Conversion Comparison (4 Models)](https://uno-kim.tistory.com/469)
-4. [[Comparison-1] #4. STT + Speaker Diarization: 3 Lightweight Engines + Pyannote](https://uno-kim.tistory.com/472)
-5. [[Comparison-2] #5. Sherpa-ONNX Execution, Diarization, and Troubleshooting](https://uno-kim.tistory.com/473)
-6. [[Comparison-3] #6. Speaker Diarization using Pyannote Model](https://uno-kim.tistory.com/471)
-7. [[Pyannote] Troubleshooting Diarization in Mobile/Termux/ARM Environments](https://uno-kim.tistory.com/470)
-8. [[Comparison-4] #7. Vosk Execution, Speaker Diarization, and Troubleshooting](https://uno-kim.tistory.com/475)
-9. [[Vosk] Troubleshooting Vosk in Mobile/Termux/ARM Environments](https://uno-kim.tistory.com/474)
-10. [[Comparison-5] #8. Vosk / Pyannote / Sherpa-ONNX / Whisper.cpp Comprehensive Comparison](https://uno-kim.tistory.com/476)
-11. [[Comparison-6] #9. Vosk + Whisper.cpp Hybrid Pipeline & X-Vector Diarization](https://uno-kim.tistory.com/477)
-12. [[Development-1] #10. Large-Scale Batch Automation & Task Management Architecture](https://uno-kim.tistory.com/478)
-13. [[Comparison-7] #11. STT + Diarization Final: Small vs Turbo & Optimization Magic (4-Model Benchmark)](https://uno-kim.tistory.com/479)
-14. [[Development-2] #12. Domain-Specific STT Training: Whisper Tiny Fine-Tuning on CPU](https://uno-kim.tistory.com/480)
-15. [[Comparison-8] #13. Vanilla Model vs Custom Fine-Tuned Model (Economics/News Domain)](https://uno-kim.tistory.com/481)
-
----
-
-## ⚖️ Disclaimer
-
-> **Disclaimer:**  
-> *termux-stt is an independent open-source project developed for the Android Termux environment and is not officially affiliated with, endorsed by, or sponsored by the Termux project, OpenAI, or any other third party.*  
-> 
-> *This project is an independent open-source library engineered for Android Termux and is not officially affiliated with or endorsed by the Termux project, OpenAI, or Google LLC.*
-
----
-
-## 📄 License
-
-Released under the **MIT License**. Maintained by **AMEVA Foundation & uno-km / Eunho Kim**.
-
-
----
-
-## 💖 Sponsorship & Community Backing
-
-AMEVA is an independent open-source public good governed under the **AMEVA Open-Source Foundation (AOSF)**. All sponsorship funds are 100% publicly audited and dedicated to physical ARM64 testbeds and CI/CD GPU runners.
+## 3. License
 
-- **Open Collective (Non-Profit 501(c)(6))**: [https://opencollective.com/ameva-fund](https://opencollective.com/ameva-fund)
-- **GitHub Sponsors**: [https://github.com/sponsors/uno-km](https://github.com/sponsors/uno-km)
-- **Official Foundation Portal**: [https://uno-km.vercel.app/docs/foundation/sponsorship.html](https://uno-km.vercel.app/docs/foundation/sponsorship.html)
-=======
-Apache License 2.0. Copyright (c) 2026 uno-km (AMEVA Foundation).
->>>>>>> Stashed changes
+Apache License 2.0. Copyright (c) 2026 uno-km (AMEVA Foundation).\n

package/index.js

@@ -21,21 +21,7 @@ function createEngine(engineName = 'whisper', options = {}) {
   }
 }
 
-class TermuxSTT {
-  constructor(options = {}) {
-    const engineName = options.engine || 'whisper';
-    this.engine = createEngine(engineName, options);
-  }
-  transcribe(filePath, options = {}) {
-    return this.engine.transcribe(filePath, options);
-  }
-  diarize(filePath, options = {}) {
-    return this.engine.diarize(filePath, options);
-  }
-}
-
 module.exports = {
-  TermuxSTT,
   createEngine,
   Engine,
   TranscriptResult,

package/lib/whisper.js

@@ -12,7 +12,15 @@ class WhisperEngine extends Engine {
     super(config);
     this.model = config.model || 'base';
     this.lang = config.lang || 'ko';
+    this.device = config.device || 'auto';
     this.threads = config.threads || 4;
+
+    try {
+      const avr = require('@ameva/runtime');
+      this.ctx = avr.getOrCreateContext({ device: this.device });
+    } catch (e) {
+      this.ctx = null;
+    }
   }
 
   async transcribe(audioPath, options = {}) {
@@ -24,6 +32,7 @@ class WhisperEngine extends Engine {
         '--engine', 'whisper',
         '--model', this.model,
         '--lang', this.lang,
+        '--device', String(this.device),
         '--format', 'json',
         audioPath
       ];
@@ -54,12 +63,19 @@ class WhisperEngine extends Engine {
   }
 
   getInfo() {
-    return {
+    const info = {
       name: 'whisper.cpp (Node.js)',
       model: this.model,
       language: this.lang,
+      device: this.device,
       threads: this.threads
     };
+    if (this.ctx) {
+      info.backendType = this.ctx.backendType;
+      info.isGpu = this.ctx.isGpu;
+      info.deviceName = this.ctx.deviceName;
+    }
+    return info;
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termux-stt",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "On-device Speech-to-Text & speaker diarization framework utilizing device resources for Android Termux",
   "main": "index.js",
   "types": "index.d.ts",
@@ -46,9 +46,6 @@
     "url": "https://github.com/uno-km/termux-stt/issues"
   },
   "homepage": "https://uno-km.github.io/termux-stt/",
-  "dependencies": {
-    "ameva-vulkan-runtime": ">=1.0.0"
-  },
   "engines": {
     "node": ">=16.0.0"
   }

package/README.pypi.md

@@ -1,34 +0,0 @@
-# termux-stt
-
-> **On-Device Hybrid Speech-to-Text & Speaker Diarization Engine for Android Termux**  
-> *Whisper.cpp · Vosk · Sherpa-ONNX · Non-Root ARM64 Execution · 128d Vector Diarization*
-
----
-
-## ⚡ 5-Minute Quickstart
-
-### Python Installation
-
-`ash
-# In Android Termux:
-pkg update && pkg install -y python ffmpeg git
-pip install termux-stt
-`
-
-### Python SDK Usage
-
-`python
-from termux_stt import STTEngine
-
-engine = STTEngine(backend="whisper")
-result = engine.transcribe("sample.wav")
-print("Transcription:", result.text)
-`
-
----
-
-## 📚 Official Documentation
-
-- **Official Web Documentation**: [https://uno-km.vercel.app/lib/stt/](https://uno-km.vercel.app/lib/stt/)
-- **GitHub Repository**: [https://github.com/uno-km/termux-stt](https://github.com/uno-km/termux-stt)
-- **License**: Apache-2.0