@qvac/transcription-whispercpp 0.6.2 → 0.6.3

package/README.md

@@ -128,16 +128,16 @@ $env:VCPKG_ROOT = "C:\path\to\vcpkg"
 
 **Linux:**
 ```bash
-# Ubuntu/Debian
+# Ubuntu/Debian — includes Clang and libc++ required by the native addon
 sudo apt update
-sudo apt install build-essential cmake git pkg-config
+sudo apt install clang libc++-dev libc++abi-dev build-essential cmake git pkg-config
 
 # CentOS/RHEL/Fedora
 sudo yum groupinstall "Development Tools"
-sudo yum install cmake git pkgconfig
+sudo yum install cmake git pkgconfig clang
 # or for newer versions:
 sudo dnf groupinstall "Development Tools"
-sudo dnf install cmake git pkgconfig
+sudo dnf install cmake git pkgconfig clang
 ```
 
 **macOS:**
@@ -206,6 +206,18 @@ This command runs the complete build sequence:
 2. `bare-make build` - Compiles the native C++ addon
 3. `bare-make install` - Installs the built addon
 
+#### Building with Vulkan GPU Acceleration
+
+On Linux, Android, and Windows, Vulkan support can be enabled at build time. Ensure the [Vulkan SDK](#gpu-acceleration-optional) is installed, then pass `-D ENABLE_VULKAN=ON` during the generate step:
+
+```bash
+bare-make generate -D ENABLE_VULKAN=ON
+bare-make build
+bare-make install
+```
+
+CI prebuilds for Linux, Android, and Windows include Vulkan by default. macOS and iOS use Metal instead.
+
 #### Running Tests
 
 After building, you can run the test suite:
@@ -261,6 +273,20 @@ Most users interact with the addon exclusively through `index.js`. From that ent
 | `whisperConfig` | *(any `whisper_full_params` key)* | Forwarded untouched. We surface convenience defaults in `index.js`, but every whisper.cpp flag is accepted—see [Advanced configuration](#advanced-configuration). |
 | `miscConfig` | `caption_enabled` | Formats segments with `<\|start\|>..<\|end\|>` markers |
 
+#### GPU acceleration is opt-in
+
+`use_gpu` defaults to `false`. To enable Vulkan (Linux/Windows/Android) or Metal (macOS/iOS) acceleration, set `use_gpu: true` explicitly in `contextParams`:
+
+```javascript
+const config = {
+  contextParams: {
+    model: './models/ggml-tiny.bin',
+    use_gpu: true,   // opt-in to GPU
+    gpu_device: 0
+  }
+}
+```
+
 #### Context keys that force a full reload
 
 Internally `WhisperModel::configContextIsChanged()` watches `model`, `use_gpu`, `flash_attn` and `gpu_device`. If any of these change we must:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/transcription-whispercpp",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "transcription addon for qvac",
   "addon": true,
   "engines": {
@@ -12,6 +12,7 @@
     "build": "bare-make generate && bare-make build && bare-make install",
     "test:unit": "brittle-bare test/unit/**/*.test.js",
     "test:integration": "brittle-bare test/integration/addon.test.js",
+    "test:benchmark:rtf": "brittle-bare test/benchmark/rtf-benchmark.test.js",
     "test:integration:long": "brittle-bare test/integration/**/longES.test.js",
     "test:cpp:build": "bare-make generate -D BUILD_TESTING=ON && bare-make build --target test-whisper-core && bare-make install",
     "test:cpp:run": "cd build/addon/tests/ && LLVM_PROFILE_FILE=default.profraw ./test-whisper-core --gtest_output=xml:cpp-test-results.xml",

package/prebuilds/darwin-arm64/qvac__transcription-whispercpp.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.6.2"
+        "version": "0.6.3"
       }
     ],
     "exported_symbols": [

package/prebuilds/darwin-x64/qvac__transcription-whispercpp.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.6.2"
+        "version": "0.6.3"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-arm64/qvac__transcription-whispercpp.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.6.2"
+        "version": "0.6.3"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-arm64-simulator/qvac__transcription-whispercpp.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.6.2"
+        "version": "0.6.3"
       }
     ],
     "exported_symbols": [

package/prebuilds/ios-x64-simulator/qvac__transcription-whispercpp.bare.exports

@@ -7,7 +7,7 @@
     ],
     "current_versions": [
       {
-        "version": "0.6.2"
+        "version": "0.6.3"
       }
     ],
     "exported_symbols": [