Update README.md

README.md

@@ -121,12 +121,11 @@ pipeline_tag: text-to-speech
 
 # Higgs Audio v3 Studio Runtime Files
 
-This repository hosts the downloadable runtime files for **Higgs Audio v3 Studio**, a Windows desktop app for local Higgs Audio v3 TTS, voice cloning, continuation, and multi-speaker generation.
+This repository hosts the downloadable runtime files for **Higgs Audio v3 Studio**, a Windows desktop app for local Higgs Audio v3 TTS, voice cloning, speech continuation, and multi-speaker generation.
 
 GitHub app repository: https://github.com/Saganaki22/Higgs-Audio-v3-Studio
 
-This repository is not the original upstream model release. It provides GGUF model builds, a Windows CUDA engine DLL, checksums, and a manifest used by the desktop app downloader.
-
+This repository is not the original upstream model release. It provides GGUF model builds, the Windows CUDA engine DLL package, checksums, and a manifest used by the desktop app downloader.
 
 ## What This Is
 
@@ -145,6 +144,7 @@ The app provides:
 - Whisper-assisted reference transcript workflow
 - Model/engine download UI
 - Hardware telemetry and VRAM diagnostics
+- Engine dependency diagnostics for missing CUDA/MSVC runtime DLLs
 
 ## App Download
 
@@ -166,7 +166,13 @@ The app expects this Hugging Face repository layout:
 ├─ checksums/
 │  └─ SHA256SUMS.txt
 ├─ engines/
-│  └─ audiocpp_engine.dll
+│  ├─ audiocpp_engine.dll
+│  ├─ cublas64_13.dll
+│  ├─ cublasLt64_13.dll
+│  ├─ MSVCP140.dll
+│  ├─ VCOMP140.DLL
+│  ├─ VCRUNTIME140.dll
+│  └─ VCRUNTIME140_1.dll
 └─ models/
    ├─ higgs-q4_k_m/
    │  └─ q4_k_m.gguf
@@ -185,8 +191,14 @@ The app expects this Hugging Face repository layout:
 | File | Purpose |
 |---|---|
 | `manifest.json` | App downloader manifest with file names, sizes, hashes, and recommended model metadata |
-| `checksums/SHA256SUMS.txt` | SHA256 checksums for engine and model files |
+| `checksums/SHA256SUMS.txt` | SHA256 checksums for engine package and model files |
 | `engines/audiocpp_engine.dll` | Windows CUDA engine DLL used by the Tauri desktop app |
+| `engines/cublas64_13.dll` | NVIDIA CUDA 13 cuBLAS runtime DLL required by the engine |
+| `engines/cublasLt64_13.dll` | NVIDIA CUDA 13 cuBLASLt runtime DLL required by cuBLAS |
+| `engines/MSVCP140.dll` | Microsoft C++ runtime DLL |
+| `engines/VCOMP140.DLL` | Microsoft OpenMP runtime DLL |
+| `engines/VCRUNTIME140.dll` | Microsoft Visual C++ runtime DLL |
+| `engines/VCRUNTIME140_1.dll` | Microsoft Visual C++ runtime DLL |
 | `models/higgs-q4_k_m/q4_k_m.gguf` | Smaller quantized model |
 | `models/higgs-q5_k/q5_k.gguf` | Balanced K-quant model |
 | `models/higgs-q6_k/q6_k.gguf` | Higher-quality K-quant model |
@@ -205,13 +217,44 @@ The app expects this Hugging Face repository layout:
 
 ## Engine Requirements
 
-The prebuilt engine DLL is intended for:
+The prebuilt engine package is intended for:
 
 - Windows x64
 - NVIDIA RTX 30xx, 40xx, or 50xx GPU
-- CUDA 13 compatible NVIDIA driver/runtime support
+- CUDA 13 compatible NVIDIA driver
+- Higgs Audio v3 Studio `0.2.31` or newer recommended
+
+The `engines/` folder contains the app engine DLL plus the CUDA/MSVC runtime DLLs the current Windows engine build needs.
+
+Important:
+
+- `nvcuda.dll` is **not** included and should not be uploaded here.
+- `nvcuda.dll` comes from the NVIDIA display driver.
+- Users still need a working NVIDIA driver installed.
+- Users should not need the full CUDA Toolkit installed if they use the app's `Download Engine DLLs` button.
+
+The app can use either:
+
+1. DLLs already installed on the user's system, such as CUDA/MSVC runtime DLLs found through system paths.
+2. DLLs downloaded from this repository into the app's writable engine folder.
+
+## Engine Dependency Diagnostics
 
-The engine DLL is bundled with the GitHub installer/portable builds, but the app can also download it from this repository if missing.
+Higgs Audio v3 Studio checks the Windows loader dependencies before loading the engine.
+
+The current validator checks for:
+
+- `nvcuda.dll`
+- `cublas64_13.dll`
+- `cublasLt64_13.dll`
+- `MSVCP140.dll`
+- `VCOMP140.DLL`
+- `VCRUNTIME140.dll`
+- `VCRUNTIME140_1.dll`
+
+If a runtime DLL is missing, users can press `Download Engine DLLs` in the app to download the files from this repository.
+
+If `nvcuda.dll` is missing, users need to install or update their NVIDIA driver.
 
 ## C++ Port Overview
 
@@ -258,6 +301,7 @@ The current app and engine include several production-focused improvements:
 - Saved speaker reference cache support through `.hspkcache`
 - Speaker ZIP import/export for reusable speaker identities
 - Manifest/checksum-based model and engine downloads
+- Engine dependency preflight for clearer Windows DLL loading errors
 
 ## Quantization Notes
 
@@ -269,7 +313,7 @@ The GGUF builds in this repository are provided so users can choose a quality/VR
 - `q8_0`: recommended default for most users with enough VRAM
 - `bf16`: highest-fidelity build, largest VRAM requirement
 
-The app keeps the model assets/config files bundled with the installer/portable package where possible, while the large GGUF weights are downloaded separately from this Hugging Face repository.
+The app keeps the small model assets/config files bundled with the installer/portable package where possible, while the large GGUF weights are downloaded separately from this Hugging Face repository.
 
 ## API Support
 
@@ -296,7 +340,7 @@ Recommended path:
 
 1. Download the latest installer or portable build from GitHub releases.
 2. Open Higgs Audio v3 Studio.
-3. Download or select an engine DLL if needed.
+3. If the engine or runtime DLLs are missing, click `Download Engine DLLs`.
 4. Download or select a Higgs GGUF model.
 5. Load engine.
 6. Load model.
@@ -306,6 +350,33 @@ GitHub releases:
 
 https://github.com/Saganaki22/Higgs-Audio-v3-Studio/releases
 
+## Manual Engine Folder
+
+If placing files manually, keep the engine package together:
+
+```text
+engines/
+├─ audiocpp_engine.dll
+├─ cublas64_13.dll
+├─ cublasLt64_13.dll
+├─ MSVCP140.dll
+├─ VCOMP140.DLL
+├─ VCRUNTIME140.dll
+└─ VCRUNTIME140_1.dll
+```
+
+Do not upload or redistribute `nvcuda.dll`. It belongs to the NVIDIA driver.
+
+## Checksums
+
+Checksums are provided in:
+
+```text
+checksums/SHA256SUMS.txt
+```
+
+The desktop app and users can use this file to verify downloaded runtime/model files.
+
 ## Safety And Responsible Use
 
 Do not use Higgs Audio v3 Studio, Higgs Audio v3, or any voice cloning workflow to impersonate people without consent, create deceptive or malicious voices, defraud people, bypass identity checks, harass others, or cause harm.
@@ -324,10 +395,14 @@ Desktop app and ported runtime repository:
 
 https://github.com/Saganaki22/Higgs-Audio-v3-Studio
 
-Whisper.cpp
+Whisper.cpp:
 
 https://github.com/ggml-org/whisper.cpp
 
+NVIDIA CUDA runtime components are provided under NVIDIA's CUDA Toolkit license terms.
+
+Microsoft Visual C++ runtime components are provided under Microsoft's Visual Studio / Visual C++ Redistributable license terms.
+
 ## Citation
 
 ```bibtex