termux-stt 1.1.2 → 1.1.4

package/README.md

@@ -118,18 +118,21 @@ chmod 755 ~/.local/bin/whisper-cli
 
 ### 🎙️ Try with the Included Sample Audio! (JFK 1-Minute Speech)
 
-`termux-stt` includes John F. Kennedy's 1961 Inaugural Address (60.00s 16kHz Mono PCM) in `samples/jfk_1min.wav` for instant out-of-the-box testing.
+`termux-stt` provides John F. Kennedy's 1961 Inaugural Address (60.00s 16kHz Mono PCM) for instant out-of-the-box testing.
 
 #### Option A: CLI One-Liner (Python / npm)
 ```bash
-# 1. Transcribe the 60s sample speech with Whisper (auto-generates SRT subtitles)
-termux-stt transcribe samples/jfk_1min.wav --engine whisper --model tiny --format srt
+# 1. Download official 60s sample speech
+curl -sLO https://raw.githubusercontent.com/uno-km/termux-stt/main/samples/jfk_1min.wav
 
-# 2. Transcribe and separate speakers (128d X-Vector Diarization)
-termux-stt diarize samples/jfk_1min.wav --speakers 2 --format text
+# 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. Benchmark on-device latency & RTF
-termux-stt benchmark --audio samples/jfk_1min.wav --model tiny
+# 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
 ```
 
 #### Option B: Python SDK

package/README.pypi.md

@@ -0,0 +1,34 @@
+# 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

package/index.js

@@ -21,7 +21,21 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termux-stt",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Production-Grade On-Device Speech-to-Text & Speaker Diarization Framework for Android Termux & Samsung Galaxy",
   "main": "index.js",
   "types": "index.d.ts",
@@ -46,6 +46,9 @@
     "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"
   }