Add SAM Audio Small, Base, and Large GGUF models

.gitattributes

@@ -33,3 +33,12 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+sam-audio-base-bf16.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-base-f32.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-base-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-large-bf16.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-large-f32.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-large-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-small-bf16.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-small-f32.gguf filter=lfs diff=lfs merge=lfs -text
+sam-audio-small-q8_0.gguf filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,61 @@
+SAM License
+Last Updated: November 19, 2025
+
+“Agreement” means the terms and conditions for use, reproduction, distribution and modification of the SAM Materials set forth herein.
+
+
+“SAM Materials” means, collectively, Documentation and the models, software and algorithms, including machine-learning model code, trained model weights, inference-enabling code, training-enabling code, fine-tuning enabling code, and other elements of the foregoing distributed by Meta and made available under this Agreement.
+
+“Documentation” means the specifications, manuals and documentation accompanying
+SAM Materials distributed by Meta.
+
+
+“Licensee” or “you” means you, or your employer or any other person or entity (if you are entering into this Agreement on such person or entity’s behalf), of the age required under applicable laws, rules or regulations to provide legal consent and that has legal authority to bind your employer or such other person or entity if you are entering in this Agreement on their behalf.
+
+
+“Meta” or “we” means Meta Platforms Ireland Limited (if you are located in or, if you are an entity, your principal place of business is in the EEA or Switzerland) or Meta Platforms, Inc. (if you are located outside of the EEA or Switzerland).
+
+
+“Sanctions” means any economic or trade sanctions or restrictions administered or enforced by the United States (including the Office of Foreign Assets Control of the U.S. Department of the Treasury (“OFAC”), the U.S. Department of State and the U.S. Department of Commerce), the United Nations, the European Union, or the United Kingdom.
+
+
+“Trade Controls” means any of the following: Sanctions and applicable export and import controls.
+
+By using or distributing any portion or element of the SAM Materials, you agree to be bound by this Agreement.
+
+
+1. License Rights and Redistribution.
+
+
+a. Grant of Rights. You are granted a non-exclusive, worldwide, non-transferable and royalty-free limited license under Meta’s intellectual property or other rights owned by Meta embodied in the SAM Materials to use, reproduce, distribute, copy, create derivative works of, and make modifications to the SAM Materials.
+
+b. Redistribution and Use.
+i. Distribution of SAM Materials, and any derivative works thereof, are subject to the terms of this Agreement. If you distribute or make the SAM Materials, or any derivative works thereof, available to a third party, you may only do so under the terms of this Agreement and you shall provide a copy of this Agreement with any such SAM Materials.
+
+
+ii.  If you submit for publication the results of research you perform on, using, or otherwise in connection with SAM Materials, you must acknowledge the use of SAM Materials in your publication.
+
+
+iii. Your use of the SAM Materials must comply with applicable laws and regulations, including Trade Control Laws and applicable privacy and data protection laws.
+iv. Your use of the SAM Materials will not involve or encourage others to reverse engineer, decompile or discover the underlying components of the SAM Materials.
+v. You are not the target of Trade Controls and your use of SAM Materials must comply with Trade Controls. You agree not to use, or permit others to use, SAM Materials for any activities subject to the International Traffic in Arms Regulations (ITAR) or end uses prohibited by Trade Controls, including those related to military or warfare purposes, nuclear industries or applications, espionage, or the development or use of guns or illegal weapons.
+2. User Support. Your use of the SAM Materials is done at your own discretion; Meta does not process any information nor provide any service in relation to such use.  Meta is under no obligation to provide any support services for the SAM Materials. Any support provided is “as is”, “with all faults”, and without warranty of any kind.
+
+
+3. Disclaimer of Warranty. UNLESS REQUIRED BY APPLICABLE LAW, THE SAM MATERIALS AND ANY OUTPUT AND RESULTS THEREFROM ARE PROVIDED ON AN “AS IS” BASIS, WITHOUT WARRANTIES OF ANY KIND, AND META DISCLAIMS ALL WARRANTIES OF ANY KIND, BOTH EXPRESS AND IMPLIED, INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. YOU ARE SOLELY RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USING OR REDISTRIBUTING THE SAM MATERIALS AND ASSUME ANY RISKS ASSOCIATED WITH YOUR USE OF THE SAM MATERIALS AND ANY OUTPUT AND RESULTS.
+
+4. Limitation of Liability. IN NO EVENT WILL META OR ITS AFFILIATES BE LIABLE UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, TORT, NEGLIGENCE, PRODUCTS LIABILITY, OR OTHERWISE, ARISING OUT OF THIS AGREEMENT, FOR ANY LOST PROFITS OR ANY DIRECT OR INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY OR PUNITIVE DAMAGES, EVEN IF META OR ITS AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF ANY OF THE FOREGOING.
+
+5. Intellectual Property.
+
+
+a. Subject to Meta’s ownership of SAM Materials and derivatives made by or for Meta, with respect to any derivative works and modifications of the SAM Materials that are made by you, as between you and Meta, you are and will be the owner of such derivative works and modifications.
+
+b. If you institute litigation or other proceedings against Meta or any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the SAM Materials, outputs or results, or any portion of any of the foregoing, constitutes infringement of intellectual property or other rights owned or licensable by you, then any licenses granted to you under this Agreement shall terminate as of the date such litigation or claim is filed or instituted. You will indemnify and hold harmless Meta from and against any claim by any third party arising out of or related to your use or distribution of the SAM Materials.
+
+6. Term and Termination. The term of this Agreement will commence upon your acceptance of this Agreement or access to the SAM Materials and will continue in full force and effect until terminated in accordance with the terms and conditions herein. Meta may terminate this Agreement if you are in breach of any term or condition of this Agreement. Upon termination of this Agreement, you shall delete and cease use of the SAM Materials. Sections 3, 4 and 7 shall survive the termination of this Agreement.
+
+7. Governing Law and Jurisdiction. This Agreement will be governed and construed under the laws of the State of California without regard to choice of law principles, and the UN Convention on Contracts for the International Sale of Goods does not apply to this Agreement. The courts of California shall have exclusive jurisdiction of any dispute arising out of this Agreement.
+
+
+8. Modifications and Amendments. Meta may modify this Agreement from time to time; provided that they are similar in spirit to the current version of the Agreement, but may differ in detail to address new problems or concerns. All such changes will be effective immediately. Your continued use of the SAM Materials after any modification to this Agreement constitutes your agreement to such modification. Except as provided in this Agreement, no modification or addition to any provision of this Agreement will be binding unless it is in writing and signed by an authorized representative of both you and Meta.

LICENSE-T5

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -0,0 +1,203 @@
+---
+license: other
+license_name: sam-license
+license_link: LICENSE
+base_model: facebook/sam-audio-large
+library_name: audio.cpp
+pipeline_tag: audio-to-audio
+tags:
+  - audio.cpp
+  - gguf
+  - audio-separation
+---
+
+# SAM Audio GGUF
+
+GGUF weights for native inference with
+[audio.cpp](https://github.com/0xShug0/audio.cpp). SAM Audio separates a sound
+described by text, a masked image or video, or positive and negative time spans
+from an input recording.
+
+## Upstream
+
+These packages use the original Meta checkpoints, not the separate `-tv` variants.
+
+| Variant | GGUF | Pinned checkpoint |
+|---|---|---|
+| Small | `sam-audio-small-f32.gguf` | [facebook/sam-audio-small](https://huggingface.co/facebook/sam-audio-small/tree/20b65f56888142eebe7c37448c6f6b3b32600e9b) |
+| Base | `sam-audio-base-f32.gguf` | [facebook/sam-audio-base](https://huggingface.co/facebook/sam-audio-base/tree/81f64008f9f957c2b57a45923fb5299c66e9d186) |
+| Large | `sam-audio-large-f32.gguf` | [facebook/sam-audio-large](https://huggingface.co/facebook/sam-audio-large/tree/5f2cd3a9471a08c7282c06036be6893e18de8b70) |
+
+The [official SAM Audio implementation](https://github.com/facebookresearch/sam-audio) is pinned to
+[bb4c699](https://github.com/facebookresearch/sam-audio/tree/bb4c6999d2677c7402360e426afc01ddfad6dce0).
+
+Each GGUF contains SAM weights, T5 text encoder, tokenizer, configuration, and
+audio.cpp model spec. No separate text encoder is needed. F32 packages retain
+the original weights, checked byte-for-byte against the source tensors.
+BF16 and Q8_0 packages are also available for each variant; both were converted
+directly from the source safetensors. Biases, normalization vectors, and
+scale/shift tables remain F32. Q8_0 denotes mixed quantized storage, not that
+every tensor is quantized.
+
+## Usage
+
+```bash
+audiocpp_cli --task s2s --family sam_audio \
+  --model /path/to/SAM-Audio-GGUF/sam-audio-small-f32.gguf --backend cuda \
+  --audio input.wav --text "man speaking" --seed -1 \
+  --out-dir outputs/separation --log
+```
+
+Outputs are `target.wav` and `residual.wav`, mono 48 kHz. Optional temporal
+prompts use `--request-option 'anchors=[["+",0.5,2.0],["-",3.0,4.0]]'`.
+The runtime also accepts a masked static image with
+`--request-option reference_image_path=masked.png`, or a masked video with
+`--request-option reference_video_path=masked.mp4`. Video decoding requires
+FFmpeg/libav runtime libraries. Use one visual option at a time and keep the
+video and input audio time origins aligned. Automatic span prediction and
+candidate ranking are not included.
+
+See the [model usage guide](https://github.com/0xShug0/audio.cpp/blob/main/docs/models/sam_audio.md)
+for all request options.
+
+> [!WARNING]
+> All parity, performance, and VRAM results below were measured with watermarking enabled to match the official Python implementation, which adds a watermark to its output. The final audio.cpp version will return audio WITHOUT the added watermark, so these results do not describe the final implementation.
+
+## Controlled Parity With Python
+
+Parity was tested separately from performance on CUDA with F32 weights and
+TF32 disabled in both implementations (`NVIDIA_TF32_OVERRIDE=0`). Python used
+seed 42; C++ replayed its exact diffusion noise and watermark bits. Both used
+the same 14.975-second office recording, `man speaking` prompt, and 16 midpoint
+steps. C++ computed its own encoder features, diffusion, and decoded audio.
+
+Each row compares the final C++ waveforms directly against official Python,
+including bounded-memory mode. Higher cosine similarity is better; 1 is exact
+directional agreement, not a claim of byte-identical waveforms.
+
+| Variant | C++ mode | Target cosine | Residual cosine |
+|---|---|---:|---:|
+| Small F32 | Normal | 0.99999945 | 0.99999864 |
+| Small F32 | Bounded memory | 0.99999968 | 0.99999896 |
+| Base F32 | Normal | 0.99999956 | 0.99999558 |
+| Base F32 | Bounded memory | 0.99999950 | 0.99999753 |
+| Large F32 | Normal | 0.99999980 | 0.99999888 |
+| Large F32 | Bounded memory | 0.99999984 | 0.99999936 |
+
+All rows exceeded 0.9999 for both outputs. Repeating each controlled C++ run
+within the same session produced byte-identical outputs. 
+
+## Ordinary CUDA Performance With Python
+
+Measured on an NVIDIA RTX 5090 (32 GB), using a 14.975-second recording from the
+[official office example](https://github.com/facebookresearch/sam-audio/blob/bb4c6999d2677c7402360e426afc01ddfad6dce0/examples/assets/office.mp4)
+and the text prompt `man speaking`.
+
+- Both implementations use the original weights, 16 midpoint steps, one
+  candidate, and no visual or span prompts. Optional ranking and span-prediction
+  models are not loaded in Python.
+- Ordinary inference: no fixed or replayed random noise, no TF32 override, and
+  no forced precision/autocast changes. C++ uses `--seed -1`; Python does not
+  set a seed. Python uses PyTorch 2.11.0+cu128; C++ uses a debug build and 8 threads.
+- Warm inference time is the median of the last three of five sequential
+  requests in one session. It excludes model loading and file I/O. RTF is
+  inference time divided by input duration; lower is faster.
+- Peak VRAM is process memory sampled with `nvidia-smi` every 50 ms across
+  loading and all five requests, using the same method for Python and C++.
+
+| Variant | C++ warm time | C++ RTF | C++ peak VRAM | Python warm time | Python RTF | Python peak VRAM |
+|---|---:|---:|---:|---:|---:|---:|
+| Small F32 | 684 ms | 0.0456 | 8,500 MiB | 746 ms | 0.0498 | 10,972 MiB |
+| Base F32 | 918 ms | 0.0613 | 11,010 MiB | 1,105 ms | 0.0738 | 13,414 MiB |
+| Large F32 | 1,542 ms | 0.1030 | 17,826 MiB | 2,103 ms | 0.1405 | 20,568 MiB |
+
+These are text-conditioned, single-recording measurements, not a benchmark of
+visual prompting, automatic span prediction, or candidate ranking.
+
+**Outputs from these independent-randomness performance runs are not used for
+parity comparisons.**
+
+## BF16 and Q8 Compared With C++ F32
+
+The following are a separate C++-only comparison on the same RTX 5090 and
+14.975-second input. Ordinary performance uses the five-request methodology
+above, `--seed -1`, and no TF32 or precision overrides. F32 was remeasured for
+this comparison; no Python model was run.
+
+| Variant | Storage | Warm time | RTF | Peak VRAM |
+|---|---|---:|---:|---:|
+| Small | F32 | 700 ms | 0.04673 | 8,500 MiB |
+| Small | BF16 | 674 ms | 0.04501 | 7,366 MiB |
+| Small | Q8_0 | 673 ms | 0.04493 | 6,834 MiB |
+| Base | F32 | 960 ms | 0.06408 | 11,010 MiB |
+| Base | BF16 | 785 ms | 0.05241 | 8,644 MiB |
+| Base | Q8_0 | 794 ms | 0.05302 | 7,524 MiB |
+| Large | F32 | 1,566 ms | 0.10457 | 17,826 MiB |
+| Large | BF16 | 1,146 ms | 0.07652 | 12,092 MiB |
+| Large | Q8_0 | 1,051 ms | 0.07018 | 9,378 MiB |
+
+Output drift was measured in **separate controlled C++ runs**, using seed 42
+and `NVIDIA_TF32_OVERRIDE=0` for every dtype. Each output is compared against
+that variant's C++ F32 waveform, not Python. These runs supply no performance
+or VRAM figures.
+
+| Variant | Storage | Target cosine vs F32 | Residual cosine vs F32 |
+|---|---|---:|---:|
+| Small | BF16 | 0.999940 | 0.999763 |
+| Small | Q8_0 | 0.999476 | 0.999095 |
+| Base | BF16 | 0.999918 | 0.999788 |
+| Base | Q8_0 | 0.999623 | 0.999069 |
+| Large | BF16 | 0.999743 | 0.999712 |
+| Large | Q8_0 | 0.999590 | 0.999273 |
+
+BF16 reduced peak VRAM by 13-32%; Q8_0 reduced it by 20-47% in this workload.
+Drift is expected. These short text-conditioned checks do not establish equal
+quality for every recording or validate reduced-precision visual prompting
+and bounded-memory long-form execution. F32 remains available as the reference.
+
+## Bounded-Memory Mode
+
+Enable the experimental session option to reduce long-recording GPU workspace:
+
+```bash
+--session-option sam_audio.memory_bounded=true
+```
+
+The option defaults to `false`, and its name is provisional. The existing Small
+GGUF predates this option; add `--model-spec-override model_specs/sam_audio.json`
+from a checkout that includes bounded-memory support. The Base and Large GGUFs
+include the option in their embedded specs.
+
+The mode retains full-recording diffusion and attention. Codec convolutions
+use tiles with receptive-field context, and watermark LSTM state carries
+between tiles. It does not separate independent audio chunks and crossfade
+them. Intermediate sequences reside in host RAM, which still grows with input
+length. Transfers and overlap computation can make it slower on short inputs;
+small numerical differences are possible. The configured model context limit
+remains 400 seconds.
+
+The following CUDA tests used a **180-second input** made by repeating the same
+example to 180 seconds, with the same prompt and inference settings as above.
+Each C++ result is the first inference in a fresh session, including graph
+setup but excluding model loading and file I/O. Peak VRAM includes loading
+and inference. These are not warm medians.
+
+| Variant | C++ bounded time | C++ RTF | C++ peak VRAM | Official Python, same input |
+|---|---:|---:|---:|---|
+| Small F32 | 8.768 s | 0.0487 | 6,550 MiB | CUDA out of memory |
+| Base F32 | 11.109 s | 0.0617 | 9,212 MiB | CUDA out of memory |
+| Large F32 | 17.038 s | 0.0947 | 16,244 MiB | CUDA out of memory |
+
+All three C++ runs produced the complete target and residual recordings.
+Python ran out of memory in its audio encoder on the same 32 GB GPU, using
+its default precision and allocator settings. This demonstrates completion
+and memory usage for this workload, **not 180-second parity against Python**:
+Python did not produce a full-length reference. Other hardware or Python
+memory-saving configurations may behave differently.
+
+## License
+
+SAM Audio weights are distributed under the [SAM License](LICENSE), dated
+November 19, 2025. The included T5 encoder is from
+[Google T5 Base](https://huggingface.co/google-t5/t5-base) and retains its
+[Apache-2.0 license](LICENSE-T5). Conversion does not replace the upstream license terms.

sam-audio-base-bf16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:90f658f0043859e195ef08a298dd61d1747bc65245c0768f2d0863f3e42849b2
+size 4136791712

sam-audio-base-f32.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:34b1fec64c1e07027e7b30feb744f59cd00bc10a02daa8f86140f0fe054242cc
+size 8265738720

sam-audio-base-q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e5529e940218981b67be2c58904ffca7b7eecba20b65e2e99e7d23eb5eb7bd9b
+size 3095951072

sam-audio-large-bf16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d3582311e5a43ae1e067b3a36c2c85a5dea946757114c611892a0fdb3e67b3ee
+size 7705276160

sam-audio-large-f32.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:bdfe2614aca0a85eebf2304959f9783125655ecb9475e56cd180f4551d32043a
+size 15401675328

sam-audio-large-q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2ff2d4599da19353105156582f995aa433899450c27e0274f0e45cc51369abf3
+size 5029984064

sam-audio-small-bf16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:48e51ad99e08eb976cbcbf65e1dd725b0e76b00618fd857a05dc7b7dadceb46b
+size 2824105568

sam-audio-small-f32.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ec80610e076c7408dcc14ba8c7bc6c321f8d691bcf093e94882898a9dbaf34f1
+size 5640890208

sam-audio-small-q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:82e7aaf7b8c458f67183a4924950dbb10ad1979a9c057f1a906c79752a4ba243
+size 2379290272