ci: add tag-driven prebuilt release pipeline by drzsdrtfg · Pull Request #286 · 0xShug0/audio.cpp

drzsdrtfg · 2026-08-20T17:38:39Z

Summary

Adds the prebuilt release pipeline: every v* release now ships ready-to-run binaries attached to the GitHub Release. This is the full set of changes this fork adds over upstream 0xShug0/audio.cpp — 2 files.

Changes

File	What it does
`.github/workflows/release.yml`	Tag-driven release build + publish
`docs/RELEASING.md`	Release / dry-run / verification docs

`.github/workflows/release.yml`

Triggers on a v* semver tag push, or manual workflow_dispatch with a publish checkbox (used for build-only dry runs). No release on every main push.
Builds audiocpp_cli, audiocpp_server, audiocpp_gguf with -DAUDIOCPP_DEPLOYMENT_BUILD=ON -DENGINE_ENABLE_LLAMAFILE=ON -DENGINE_ENABLE_CUDA_GRAPHS=ON.
Matrix (fail-fast off): macOS metal (arm64/x64), Ubuntu x64 cpu+vulkan, Windows x64 cpu+vulkan+cuda (12.4/13.3). linux-rocm is commented out (no AMD GPU runner).
Windows CUDA uses GGML_BACKEND_DL: thin shells + a single ggml-cuda.dll; the CUDA runtime ships once in a separate -cudart-...zip. CUDA archs are pinned all-real.
Assets: audio-<tag>-bin-windows-x64-<backend>.zip (+ -cudart-...zip); Linux/macOS as .tar.gz.
Release job: gh release upload to an existing release (--clobber) or gh release create on a new tag (--generate-notes).

`docs/RELEASING.md`

UI-only steps to draft a release, tag, dry-run from the Actions tab, plus the artifact table and the GPU-runtime verification note.

Validation

The prebuilt binaries were downloaded and run to confirm they work out of the box.

Hardware:

GPU: Radeon RX Vega 56 (Vulkan device: "Radeon RX Vega"; fp16:1, bf16:0, int dot:0, matrix cores:none, warp:64, 32 KB smem), 8 GB VRAM
CPU: Intel Core i5-10400 (6c/12t), Windows, AMD proprietary driver

Config: audiocpp_cli --task tts --family supertonic --model supertonic-3-f16.gguf --voice-id M1 --num-inference-steps 8 --seed 1234

Vulkan binary (Radeon RX Vega 56):

Sample	Audio (s)	Gen wall (s)	RTF	x real-time
Short	5.02	1.80	0.359	2.79x
Medium	27.26	1.70	0.062	16.06x
Long	76.09	5.08	0.067	14.97x

CPU binary (i5-10400):

Threads	Audio (s)	Gen wall (s)	RTF	x real-time
1	13.57	18.98	1.398	0.72x
4	27.28	10.67	0.391	2.56x
10	74.25	21.74	0.293	3.42x

These runs only confirm the shipped binaries enumerate the device and synthesize correctly; see the README for reference performance figures.

Notes

release.yml references macos-26 / macos-15-intel runner labels; adjust to this repo's runner pool if different.
ROCm is disabled by default (no AMD runner); enable via self-hosted HIP runners.
Optional follow-up: add a CI check job that runs the shipped Windows binaries.
No runtime/model changes; CI and docs only.
This PR's code and description were written and assisted by DeepSeek-V4-Flash-0731 through Cline.

…o release]

…elease]

…Vulkan SDK fix, OpenMP-off CUDA build) [no release]

…no release]

…PU/Vulkan preset bins) [no release]

… runtime DLLs in CUDA release

… as ggml-cuda.dll instead of 3 monoliths

…g-name, GGML_BACKEND_DL CUDA, robust cudart bundling)

… in the matrix

…dle cufft64 runtime

…LEASING.md)

…g docs

…n input + publish gate

…release

…ases publish

drzsdrtfg · 2026-08-20T17:44:49Z

btw I dont know whether the other binaries work pls test them out on my fork before you merge this

0xShug0 · 2026-08-20T17:54:28Z

@drzsdrtfg Thank you for the PR! It may require some time to test...Stay tuned.

drzsdrtfg · 2026-08-20T18:17:43Z

Ok. Just let me know when issues appear. @0xShug0

0xShug0 · 2026-08-22T15:34:53Z

@drzsdrtfg Tested the Metal and Linux releases so far, and they work correctly. One thing I noticed during testing: The current prebuilts don’t pass the flags to the server to enable the native model manager (AUDIOCPP_BUILD_NATIVE_MODEL_MANAGER) , so the UI still relies on external Python. I also missed updating the build scripts to accept the new options. I’ve just pushed a fix.

Could you update the release scripts so the prebuilts include the self-contained native UI?

More about the new flags:
https://github.com/0xShug0/audio.cpp/blob/main/app/server/README.md

drzsdrtfg · 2026-08-22T15:37:31Z

Ok, I will.

Add -DAUDIOCPP_BUILD_NATIVE_MODEL_MANAGER=ON to the CMAKE_ARGS so the prebuilt binaries ship with the self-contained native UI (model downloads, dynamic model management, etc.) instead of relying on external Python. Addresses: 0xShug0#286 (comment)

The env.CMAKE_ARGS is consumed only by the Linux and macOS jobs which call cmake directly. Windows CPU and Vulkan jobs use build_windows.ps1 which has its own CLI parameters (-DeploymentBuild, -NativeModelManager) and ignores CMAKE_ARGS. Windows CUDA jobs also hardcode cmake flags. This fix: - Adds -DeploymentBuild -NativeModelManager to all build_windows.ps1 calls - Adds -DAUDIOCPP_BUILD_NATIVE_MODEL_MANAGER=ON to the CUDA cmake command

Port the upstream fix (0xShug0/audio.cpp@e9e8f14) to the fork: - Add --native-model-manager, --system-openssl, --boringssl-archive CLI flags - Add -DAUDIOCPP_BUILD_NATIVE_MODEL_MANAGER to cmake invocations - Print native model manager status in build output This completes the owner's request: the release CI now builds the self-contained native UI on all platforms.

drzsdrtfg · 2026-08-23T23:15:32Z

@0xShug0 Should be done by now. Can you take a look?

drzsdrtfg · 2026-08-23T23:26:24Z

Found some mistakes. Will fix them and come back.

The server's model installer invokes tools/model_manager_v2.py for package downloads. Without it in the prebuilt zip, model download from the WebUI fails with 'model preparation helper was not found'. Include tools/ and model_specs/ at the archive root so the server can resolve its repository_root (traverses upward from the exe).

0xShug0 · 2026-08-23T23:44:33Z

@0xShug0 Should be done by now. Can you take a look?

Thanks! AFK tonight. I will check tomorrow.

…lease - Build jobs now upload the unpacked bundle (binaries + tools/ + model_specs/) instead of a zip-wrapped-in-an-artifact, so downloading an Actions artifact yields a ready-to-run folder. - CUDA jobs upload bin and cudart as two separate artifacts (the old wildcard path merged both into one ~1 GB blob). - The release job downloads per-artifact folders, creates the final zip/tar.gz archives there, and uploads those to the Release -- asset layout stays identical to v0.6.0.

drzsdrtfg · 2026-08-24T10:54:05Z

You can test it now.

0xShug0 · 2026-08-25T00:43:45Z

@drzsdrtfg The prebuilts work correctly on Linux, Metal, and Windows based on my tests. My concern is that the Windows CPU/CUDA/Vulkan staged artifacts do not include MSVC/OpenMP runtime DLLs such as vcomp140.dll, vcruntime140.dll, and msvcp140.dll. They pass validation on my machine because those DLLs already exist globally in C:\Windows\System32 / other installed toolchain paths.

Should the Windows prebuilts include those DLLs as well?

drzsdrtfg added 22 commits August 17, 2026 18:37

ci: add GitHub Actions release workflow [no release]

097c649

ci: fix release jobs (explicit win targets, install libomp on mac) [n…

dbf589e

…o release]

ci: only publish release when all backend jobs succeed [no release]

c44b090

ci: provision mac OpenMP off, Windows Vulkan SDK + CUDA toolkit [no r…

407af39

…elease]

ci: adopt llama.cpp release patterns (7z packing, CUDA 12/13 matrix, …

c8d66f6

…Vulkan SDK fix, OpenMP-off CUDA build) [no release]

ci: use valid Vulkan SDK 1.4.357.0 and full CUDA versions in matrix […

22ded67

…no release]

ci: bump cuda-toolkit to v0.2.36, CUDA 12.4/13.2 [no release]

200068a

ci: source vcvarsall before CUDA cmake so nvcc finds cl.exe [no release]

9d4c568

ci: fix robocopy exit-code mapping in CUDA bundle step [no release]

7c8e944

ci: fix CUDA artifact zip path (build/bin is 1 level shallower than C…

06356eb

…PU/Vulkan preset bins) [no release]

ci: bundle CUDA runtime from bin/lib/bin-x64 and stop double-shipping…

2ba3acf

… runtime DLLs in CUDA release

ci(win-cuda): build with GGML_BACKEND_DL like llama.cpp so CUDA ships…

2afbd1c

… as ggml-cuda.dll instead of 3 monoliths

ci: port llama.cpp release pipeline for CPU/Vulkan/CUDA/Metal (get-ta…

8f3bd1e

…g-name, GGML_BACKEND_DL CUDA, robust cudart bundling)

ci(win-cuda): pin CMAKE_CUDA_ARCHITECTURES per toolkit; use CUDA 13.3…

63f9268

… in the matrix

ci(win-cuda): use ggml-style virtual/real CUDA archs (faster) and bun…

7834fa6

…dle cufft64 runtime

ci: one-command releases (publish toggle, scripts/release.sh, docs/RE…

a8f0344

…LEASING.md)

ci: one-click GUI releases (publish defaults on) + GUI-first releasin…

4e03548

…g docs

ci: remove CLI release helper; GUI-only releasing docs

348d7a0

ci: semver tag-driven releases (remove b<N>/auto-push); manual versio…

b5eefce

…n input + publish gate

ci: preserve pre-release flag and notes when attaching binaries to a …

5465c17

…release

ci: upload only real package files (.zip/.tar.gz) to the release

29b6b72

ci: fix boolean publish gate (inputs.publish) so manual dispatch rele…

8b2a092

…ases publish

drzsdrtfg added 3 commits August 23, 2026 19:21

drzsdrtfg and others added 2 commits August 24, 2026 01:32

Merge branch '0xShug0:main' into main

d0c8be3

Navigation Menu

ci: add tag-driven prebuilt release pipeline - #286

ci: add tag-driven prebuilt release pipeline#286
drzsdrtfg wants to merge 28 commits into
0xShug0:mainfrom
drzsdrtfg:main

drzsdrtfg commented Aug 20, 2026

Uh oh!

drzsdrtfg commented Aug 20, 2026

Uh oh!

0xShug0 commented Aug 20, 2026

Uh oh!

drzsdrtfg commented Aug 20, 2026

Uh oh!

0xShug0 commented Aug 22, 2026

Uh oh!

drzsdrtfg commented Aug 22, 2026

Uh oh!

drzsdrtfg commented Aug 23, 2026

Uh oh!

drzsdrtfg commented Aug 23, 2026

Uh oh!

0xShug0 commented Aug 23, 2026

Uh oh!

drzsdrtfg commented Aug 24, 2026

Uh oh!

0xShug0 commented Aug 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

drzsdrtfg commented Aug 20, 2026

Summary

Changes

.github/workflows/release.yml

docs/RELEASING.md

Validation

Notes

Uh oh!

drzsdrtfg commented Aug 20, 2026

Uh oh!

0xShug0 commented Aug 20, 2026

Uh oh!

drzsdrtfg commented Aug 20, 2026

Uh oh!

0xShug0 commented Aug 22, 2026

Uh oh!

drzsdrtfg commented Aug 22, 2026

Uh oh!

drzsdrtfg commented Aug 23, 2026

Uh oh!

drzsdrtfg commented Aug 23, 2026

Uh oh!

0xShug0 commented Aug 23, 2026

Uh oh!

drzsdrtfg commented Aug 24, 2026

Uh oh!

0xShug0 commented Aug 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

`.github/workflows/release.yml`

`docs/RELEASING.md`