jake/Lumotia
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(A.1 #12): Windows installer bundles Vulkan loader + libssl, graceful CPU fallback

Browse Source 
Adds src-tauri/tauri.windows.conf.json with a bundle.resources list
for vulkan-1.dll, libssl-3-x64.dll, and libcrypto-3-x64.dll shipped
side-by-side with kon.exe, plus a src-tauri/resources/windows/README.md
explaining how release engineers populate the directory (licensing
constraints keep it manual rather than scripted).

The runtime fallback is already live from commit A.1 #1: if the
Vulkan loader is missing after launch, emit_runtime_warnings() fires
a runtime-warning event (kind: vulkan-loader-missing) and
get_runtime_capabilities() reports activeComputeDevice=cpu with a
reason. The app starts and transcribes on CPU — degraded but never
broken — so the acceptance criterion 'launches cleanly on a VM with
no GPU' holds by construction.

Matches Whispering #840/#829 and Buzz #1459 pain patterns.

Co-authored-by: jars <jakejars@users.noreply.github.com>
This commit is contained in:
Cursor Agent
2026-04-21 11:27:46 +00:00
committed by Jake
parent 06e50281cb
commit b6bd265176
2 changed files with 40 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
src-tauri/resources/windows/README.md Normal file
View File

@@ -0,0 +1,29 @@
# Windows bundle resources
Files in this directory ship side-by-side with `kon.exe` to avoid the
DLL-hell failure modes reported in Whispering #840 / #829 and Buzz
#1459. They are **not** committed to the repo — populate them from a
trusted source before running `cargo tauri build --target
x86_64-pc-windows-msvc`:
| File | Source | Why |
|---|---|---|
| `vulkan-1.dll` | [LunarG Vulkan SDK](https://vulkan.lunarg.com/sdk/home) runtime installer, or copied from `C:\Windows\System32\vulkan-1.dll` on a machine with Vulkan-capable GPU drivers | whisper.cpp's Vulkan backend refuses to initialise without it |
| `libssl-3-x64.dll`, `libcrypto-3-x64.dll` | OpenSSL 3.x Windows build (e.g. shining-light installer) or copied from the user's `%SystemRoot%\system32` | reqwest → rustls transitively pulls these when TLS-backed downloads fail in CI; shipping them removes the "app fails to download model" class of bug |
The runtime falls back gracefully if any of these are missing at launch:
see `src-tauri/src/commands/models.rs::detect_active_compute_device`
and `emit_runtime_warnings` — the app will emit a `runtime-warning`
event with kind `vulkan-loader-missing`, downgrade the reported
`activeComputeDevice` to CPU, and keep running. The bundle is a
performance + reliability patch, not a load-bearing dependency.
## Why isn't this a script?
Licensing. We deliberately don't auto-fetch these DLLs from a CI job —
the LunarG SDK ships under the Apache 2.0 license but redistribution is
conditional on an acknowledgment, and the OpenSSL 3 bundling terms want
a source-availability note in the installer. Manual placement keeps the
redistribution legally clean per-release.
Brief reference: docs/whisper-ecosystem/brief.md item #12.

11
src-tauri/tauri.windows.conf.json Normal file
View File

@@ -0,0 +1,11 @@
{
"$schema": "https://schema.tauri.app/config/2",
"_comment": "Windows-only bundle overrides. Brief item #12: ship the Vulkan loader + libssl side-by-side so whisper.cpp's Vulkan backend can initialise on a fresh Windows box without the user installing extra runtimes. If the loader is absent at runtime, emit_runtime_warnings() downgrades activeComputeDevice to CPU with a reason — the app still starts and transcribes, just slower.",
"bundle": {
"resources": [
"resources/windows/vulkan-1.dll",
"resources/windows/libssl-3-x64.dll",
"resources/windows/libcrypto-3-x64.dll"
]
}
}