Files
WhispAssist/packaging/npu-runtime/README.md
T

40 lines
1.5 KiB
Markdown

# NPU runtime bundle
`whispassist-npu-runtime-win-x64.zip` is the on-demand OpenVINO runtime for the
NPU transcription path (T3.4). It is **not committed to git** (it's a ~40 MB
binary) — it's hosted as a Gitea generic package and downloaded by the app on
demand when an NPU is detected.
## Contents
The 22 flat DLLs of the validated, version-pinned runtime:
- **ONNX Runtime 1.24.1** with the OpenVINO execution provider
(`onnxruntime.dll`, `onnxruntime_providers_openvino.dll`,
`onnxruntime_providers_shared.dll`)
- **OpenVINO 2025.4.1** runtime + NPU plugin + TBB (`openvino.dll`,
`openvino_intel_npu_plugin.dll`, `tbb12.dll`, …)
> ⚠️ The ORT↔OpenVINO versions are pinned. A mismatch makes ORT silently fall
> back to CPU. Regenerate the bundle from a matched pip install
> (`onnxruntime-openvino==1.24.1` + `openvino==2025.4.1`) if you bump either.
## Current bundle
- **SHA-256:** `c60de07b5b1ddc2fd1e966d8275d9f55ec261efc81355ea814d6dac897adbdc5`
This hash is pinned in `src-tauri/src/commands.rs` (`NPU_RUNTIME_SHA256`); the
app verifies the download against it. If you regenerate the zip, update that
constant.
## Hosting
Upload this zip as a Gitea generic package, e.g.:
```
PUT https://git.dou.bet/api/packages/iamdoubz/generic/npu-runtime/2025.4.1/whispassist-npu-runtime-win-x64.zip
```
Then set the resulting download URL in `NPU_RUNTIME_URL`
(`src-tauri/src/commands.rs`). It's also overridable at runtime without a
rebuild via the `WA_NPU_RUNTIME_URL` environment variable.