From 270fa60c01866c4431d540be960b6cd2bc2b9c44 Mon Sep 17 00:00:00 2001 From: historia Date: Fri, 28 Aug 2026 16:52:14 -0400 Subject: feat: run auto-build audio.cpp scripts for macos and windows --- app/docs/backend-audiocpp.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) (limited to 'app/docs/backend-audiocpp.md') 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/.json` found relative to the working directory). The macOS script takes the same flag; the Windows PowerShell scripts take `-DeploymentBuild`. ### Install models -- cgit v1.2.3