aboutsummaryrefslogtreecommitdiff
path: root/app/docs
diff options
context:
space:
mode:
Diffstat (limited to 'app/docs')
-rw-r--r--app/docs/backend-audiocpp.md15
1 files changed, 14 insertions, 1 deletions
diff --git a/app/docs/backend-audiocpp.md b/app/docs/backend-audiocpp.md
index 03e781e..32c234e 100644
--- a/app/docs/backend-audiocpp.md
+++ b/app/docs/backend-audiocpp.md
@@ -10,14 +10,27 @@ If you prefer to install the backend yourself (in your own environment, not the
### Download and build audiocpp_server
-Download and build `audiocpp_server` for your platform and backend `(cuda, vulkan, hip, cpu)`. Check [audio.cpp's readme](https://github.com/0xShug0/audio.cpp) for details. I'm using one of the helper scripts:
+Download and build `audiocpp_server` for your platform and backend `(cuda, vulkan, hip, cpu)`. Check [audio.cpp's readme](https://github.com/0xShug0/audio.cpp) for details. audio.cpp ships one helper script per platform, and the hub runs the one matching your OS:
```bash
+# Linux
git clone https://github.com/0xShug0/audio.cpp
cd audio.cpp
scripts/build_linux.sh --backend cuda --target audiocpp_server --deployment-build
```
+```bash
+# macOS (Metal is the only buildable backend there; the hub records it as "cpu")
+scripts/build_metal.sh --target audiocpp_server --deployment-build
+```
+
+```powershell
+# Windows (needs VS Build Tools with the C++ workload; CUDA preset also needs
+# the CUDA Toolkit, Vulkan preset the Vulkan SDK — the script names what's missing)
+powershell -NoProfile -ExecutionPolicy Bypass -File scripts\build_windows.ps1 -Preset windows-cuda-release -Target audiocpp_server -DeploymentBuild
+# presets: windows-cpu-release, windows-vulkan-release, windows-cuda-release (HIP: scripts\build_windows_hip.ps1)
+```
+
`--deployment-build` compiles the `model_specs/` catalog into the binary so every family resolves its model contract even when the server is started outside the checkout (GGUF packages whose embedded spec is legacy, such as today's Qwen3-TTS ones, otherwise need `model_specs/<family>.json` found relative to the working directory). The macOS script takes the same flag; the Windows PowerShell scripts take `-DeploymentBuild`.
### Install models