--- license: other license_name: stability-ai-community license_link: https://huggingface.co/stabilityai/stable-audio-open-1.0/blob/main/LICENSE.md tags: - audio-generation - foundation-1 - stable-audio-open - gguf - sa3.cpp --- # Foundation-1 GGUF GGUF conversions of [RoyalCities/Foundation-1](https://huggingface.co/RoyalCities/Foundation-1) for [sa3.cpp](https://github.com/betweentwomidnights/sa3.cpp)'s optional native stable-audio-tools runtime. Foundation-1 is a full finetune of Stable Audio Open 1.0 and uses the same T5-base and Oobleck architecture. Each encoding is a complete three-file bundle: | Tier | Complete bundle | Guidance | | --- | ---: | --- | | F16 | 2,377 MiB | reference and runtime default | | Q8_0 | 1,296 MiB | conservative high fidelity | | Q5_K_M | 922 MiB | recommended compact tier | | Q4_K_M | 832 MiB | smallest footprint | All quantized tensors passed the per-tensor 0.990 cosine gate. Matched CUDA renders measured envelope/log-magnitude cosine of 0.9967/0.9901 at Q8, 0.9904/0.9550 at Q5, and 0.9643/0.9284 at Q4. All four tiers passed listening tests. ## Musical timing Foundation-1 was trained for 4- or 8-bar clips at 100, 110, 120, 128, 130, 140, or 150 BPM. The prompt should include the selected bar count and BPM. sa3.cpp's Foundation profile calculates the exact sample crop, the whole-second `seconds_total` conditioning value, and the padded Oobleck latent canvas independently to match RoyalCities' inference. Unsupported model BPMs are intentionally rejected by this profile. The native `sat-server` accepts `host_bpm`, maps it to the nearest trained BPM, and pitch-preserves the output at the host tempo. That service-level stretch does not change the GGML model primitives; see [SAT_SERVER.md](https://github.com/betweentwomidnights/sa3.cpp/blob/main/docs/SAT_SERVER.md). RoyalCities' UI profile uses DPM++ 3M SDE, sigma 0.01–100, 100 steps, and CFG 7. The gary4local fallback profile uses DPM++ 2M SDE, sigma 0.5–50, 100 steps, and CFG 7. Build the opt-in SAT CLI, download one complete tier, and generate directly from the Foundation musical grid: ```powershell cmake -S . -B build-sat -DSA3_BUILD_SAT=ON -DSA3_CUDA=ON cmake --build build-sat --config Release --target sat-generate python tools/download_models.py --sat --sat-model foundation-1 $env:SA3_DEVICE="cuda" sat-generate --model foundation-1 --randomize --bars 4 --bpm 128 --seed 42 ` --out foundation.wav ``` `--randomize` uses the RoyalCities M1 structured prompt vocabulary by default, then prints the exact prompt, seed, key, musical geometry, and output path. Use `--randomize-mode mix` for the richer T1 variant, `--family Synth` to lock its anchor, or `--foundation-profile gary` to A/B the gary4local fallback sampler. Run `sat-generate --help` for the complete model-specific option list. Any omitted bars, BPM, key, or family value is randomized; explicitly supplied values act as locks. Without `--randomize`, pass `--prompt` as a manual descriptor override. ## Audio-to-audio `stable-audio-open-oobleck-encoder-v1.0-F16.gguf` is the Oobleck **encoder**, which audio-to-audio uses to turn input audio into the latent that sampling starts from. Generation never loads it, so it is a separate file from the decoder bundle above and comes in one F16 tier for every bundle (149 MiB). Its 146 tensors are identical whether converted from Foundation-1, Stable Audio Open 1.0 or Stable Audio Open Small; the GGML encoder's latent means and scales match PyTorch's with cosine 1.0000. `sat-server`'s `POST /audio2audio` loads it when it is beside the other files; see [SAT_SERVER.md](https://github.com/betweentwomidnights/sa3.cpp/blob/main/docs/SAT_SERVER.md). The published bundles are otherwise unchanged. ## Sources and licensing - Foundation-1 source revision: `d3160956fa13a8f861d3f608ed24075d44e98554`. - Stable Audio Open 1.0 base revision: `f21265c1e2710b3bd2386596943f0007f55f802e`. - T5-base revision: `a9723ea7f1b39c1eae772870f3b547bf6ef7e6c1`. The Stability AI Community License is included as `LICENSE.md`; RoyalCities' source license notice is retained as `LICENSE_FOUNDATION.md`, and T5-base's Apache 2.0 license is included as `LICENSE_T5.md`. See `NOTICE` for conversion details. Powered by Stability AI.