audio-cpp commited on
Commit
ef2ff9d
·
verified ·
1 Parent(s): 8d23da5

Add Audio Flamingo 3 and Next GGUF models

Browse files
.gitattributes CHANGED
@@ -33,3 +33,9 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ audio-flamingo-3-bf16.gguf filter=lfs diff=lfs merge=lfs -text
37
+ audio-flamingo-3-q4_k.gguf filter=lfs diff=lfs merge=lfs -text
38
+ audio-flamingo-3-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
39
+ audio-flamingo-next-bf16.gguf filter=lfs diff=lfs merge=lfs -text
40
+ audio-flamingo-next-q4_k.gguf filter=lfs diff=lfs merge=lfs -text
41
+ audio-flamingo-next-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
NVIDIA-OneWay-Noncommercial-License_22Mar2022-academic.docx ADDED
Binary file (20.7 kB). View file
 
README.md ADDED
@@ -0,0 +1,92 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: other
3
+ license_name: nvidia-oneway-noncommercial
4
+ license_link: https://huggingface.co/nvidia/audio-flamingo-next-hf/blob/5634886e2615c2f587dcf8b93c6edfe9907930ca/static/NVIDIA-OneWay-Noncommercial-License_22Mar2022-academic.docx
5
+ base_model:
6
+ - nvidia/audio-flamingo-3-hf
7
+ - nvidia/audio-flamingo-next-hf
8
+ tags:
9
+ - audio.cpp
10
+ - gguf
11
+ - audio-text-to-text
12
+ - automatic-speech-recognition
13
+ language:
14
+ - en
15
+ ---
16
+
17
+ # Audio Flamingo 3 and Next GGUF
18
+
19
+ For use with [audio.cpp](https://github.com/0xShug0/audio.cpp).
20
+
21
+ These self-contained GGUFs package the model tensors, tokenizer, configuration,
22
+ and audio.cpp model spec for Audio Flamingo 3 and Audio Flamingo Next. Both
23
+ models support transcription, captioning, and questions about speech, music,
24
+ and environmental sounds.
25
+
26
+ | File | Upstream checkpoint | Size | Maximum audio |
27
+ | --- | --- | ---: | ---: |
28
+ | `audio-flamingo-3-bf16.gguf` | [Audio Flamingo 3](https://huggingface.co/nvidia/audio-flamingo-3-hf) | 15.4 GiB | 10 minutes |
29
+ | `audio-flamingo-3-q8_0.gguf` | Audio Flamingo 3 | 8.7 GiB | 10 minutes |
30
+ | `audio-flamingo-3-q4_k.gguf` | Audio Flamingo 3 | 5.1 GiB | 10 minutes |
31
+ | `audio-flamingo-next-bf16.gguf` | [Audio Flamingo Next](https://huggingface.co/nvidia/audio-flamingo-next-hf) | 15.4 GiB | 30 minutes |
32
+ | `audio-flamingo-next-q8_0.gguf` | Audio Flamingo Next | 8.7 GiB | 30 minutes |
33
+ | `audio-flamingo-next-q4_k.gguf` | Audio Flamingo Next | 5.1 GiB | 30 minutes |
34
+
35
+ ## Usage
36
+
37
+ ```bash
38
+ audiocpp_cli --task asr --family audio_flamingo \
39
+ --model /path/to/audio-flamingo-3-bf16.gguf --backend cuda \
40
+ --audio input.wav \
41
+ --request-option "instruct=Transcribe the input speech." \
42
+ --text-out response.txt --log
43
+ ```
44
+
45
+ Select either GGUF with `--model`. Use a question such as
46
+ `Describe the instruments and tempo.` for general audio understanding. Requested
47
+ timestamps or speaker descriptions are generated text, not structured alignment
48
+ or diarization results.
49
+
50
+ For server use, configure family `audio_flamingo`, task `asr`, and mode `offline`,
51
+ then submit audio to `/v1/audio/transcriptions` with the instruction in `prompt`.
52
+
53
+ ## CUDA Performance and Quantization
54
+
55
+ The following results use an RTX 5090, the CUDA backend, 8 CPU threads, and the
56
+ same decoded 10-second, 16-kHz mono speech input. Wall time and RTF are from the
57
+ second request in an already-loaded session. Peak VRAM covers the complete
58
+ three-request session and was sampled every 100 ms.
59
+
60
+ | Model | Weight type | Warm wall time | RTF | Peak VRAM | Transcript compared with BF16 |
61
+ | --- | --- | ---: | ---: | ---: | --- |
62
+ | Audio Flamingo 3 | BF16 | 283.3 ms | 0.0283 | 16,854 MiB | Reference |
63
+ | Audio Flamingo 3 | Q8_0 | 184.9 ms | 0.0185 | 9,956 MiB | Exact |
64
+ | Audio Flamingo 3 | Q4_K | 151.7 ms | 0.0152 | 6,280 MiB | Same words; wrapper and punctuation changed |
65
+ | Audio Flamingo Next | BF16 | 246.3 ms | 0.0246 | 16,890 MiB | Reference |
66
+ | Audio Flamingo Next | Q8_0 | 160.9 ms | 0.0161 | 9,992 MiB | Same words; one comma omitted |
67
+ | Audio Flamingo Next | Q4_K | 129.9 ms | 0.0130 | 6,314 MiB | Exact |
68
+
69
+ The BF16 Audio Flamingo 3 transcription and music-answer outputs were
70
+ byte-identical to the official Transformers implementation. Audio Flamingo Next
71
+ was also byte-identical on transcription. On a separate three-minute timestamped
72
+ request, its words and line boundaries matched Python after timestamps were
73
+ removed, while generated timestamps drifted.
74
+
75
+ Quantized outputs remained coherent on the transcription and music-understanding
76
+ requests. Q8_0 is the balanced default for lower VRAM and faster inference. Q4_K
77
+ offers the lowest tested VRAM, but quantization can change wording, punctuation,
78
+ or factual details in open-ended answers and should not be treated as exact
79
+ parity with BF16.
80
+
81
+ ## Audio Preprocessing
82
+
83
+ For comparisons with Python, supply the same decoded 16-kHz mono WAV to both
84
+ implementations. Python's optional TorchCodec loader and librosa fallback use
85
+ different downmixing and resampling paths. audio.cpp averages channels and uses
86
+ SOXR when resampling is needed.
87
+
88
+ Both checkpoints use the NVIDIA OneWay Noncommercial License. The upstream
89
+ license is included in this directory. Review its terms before use or redistribution.
90
+
91
+ See the [audio.cpp model documentation](https://github.com/0xShug0/audio.cpp/blob/main/docs/models/audio_flamingo.md)
92
+ for request options, conversion, and additional usage details.
audio-flamingo-3-bf16.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:a970e1fa32a8904e37150bac57a1b198667bd69ecb5eeb1b28fdc93d0c4579f9
3
+ size 16550564800
audio-flamingo-3-q4_k.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:87b85d1093be30d45571c7664f531aaa4872d9fd09ef0e1c989f61007e42fc11
3
+ size 5459592448
audio-flamingo-3-q8_0.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:5325029ad5b955fb9db3d8f3fd06b4de567693c5990635c05486369d3414b464
3
+ size 9317321984
audio-flamingo-next-bf16.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:8c983ebb563ac41dc6b84ba800479a47cd2588aa9392dccb69371102543aa770
3
+ size 16546111968
audio-flamingo-next-q4_k.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:f285a520fff439c249a61a2a2535b2e962c0df02697a4cc54b19385ab3be7ce8
3
+ size 5455139584
audio-flamingo-next-q8_0.gguf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:124969625d2bd14af1a732de58ca53c2711fdb68e02f5504d408ccf637f1eb0a
3
+ size 9312869120