cjpais commited on
Commit
6ad6b90
·
verified ·
1 Parent(s): 5b07828

Upload folder using huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +806 -3
README.md CHANGED
@@ -1,3 +1,806 @@
1
- ---
2
- license: apache-2.0
3
- ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ base_model: CohereLabs/cohere-transcribe-03-2026
4
+ base_model_relation: quantized
5
+ library_name: transcribe.cpp
6
+ pipeline_tag: automatic-speech-recognition
7
+ language:
8
+ - en
9
+ - fr
10
+ - de
11
+ - es
12
+ - it
13
+ - pt
14
+ - nl
15
+ - pl
16
+ - el
17
+ - ar
18
+ - ja
19
+ - zh
20
+ - vi
21
+ - ko
22
+ tags:
23
+ - gguf
24
+ - transcribe.cpp
25
+ - asr
26
+ - speech-to-text
27
+ - cohere
28
+ - conformer
29
+ - encoder-decoder
30
+ - multilingual
31
+ ---
32
+
33
+ # cohere-transcribe-03-2026 — transcribe.cpp GGUF
34
+
35
+ GGUF conversions of [`CohereLabs/cohere-transcribe-03-2026`](https://huggingface.co/CohereLabs/cohere-transcribe-03-2026) for use
36
+ with [transcribe.cpp](https://github.com/handy-computer/transcribe.cpp).
37
+
38
+ Ported from upstream commit
39
+ [`76b8b23`](https://huggingface.co/CohereLabs/cohere-transcribe-03-2026/commit/76b8b23),
40
+ pinned 2026-04-16.
41
+ Validated against the Transformers reference at transcribe.cpp commit
42
+ [`929d922`](https://github.com/handy-computer/transcribe.cpp/tree/929d922)
43
+ on 2026-04-18.
44
+
45
+ Offline multilingual speech-to-text covering 14 languages (English, French,
46
+ German, Spanish, Italian, Portuguese, Dutch, Polish, Greek, Arabic, Japanese,
47
+ Chinese, Vietnamese, Korean). A Conformer encoder with a Transformer
48
+ encoder-decoder head (cross-attention, tied token embedding). Takes a 16 kHz
49
+ mono WAV and produces a transcript. Decoding is autoregressive.
50
+
51
+
52
+ ## Downloads
53
+
54
+ | Quantization | Download | Size | WER (LibriSpeech test-clean) |
55
+ | --- | --- | ---: | ---: |
56
+ | BF16 | [cohere-transcribe-03-2026-BF16.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-BF16.gguf) | 4.10 GB | 1.26% |
57
+ | F16 | [cohere-transcribe-03-2026-F16.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-F16.gguf) | 4.11 GB | 1.26% |
58
+ | Q8_0 | [cohere-transcribe-03-2026-Q8_0.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-Q8_0.gguf) | 2.41 GB | 1.27% |
59
+ | Q6_K | [cohere-transcribe-03-2026-Q6_K.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-Q6_K.gguf) | 1.97 GB | 1.27% |
60
+ | Q5_K_M | [cohere-transcribe-03-2026-Q5_K_M.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-Q5_K_M.gguf) | 1.76 GB | 1.25% |
61
+ | Q4_K_M | [cohere-transcribe-03-2026-Q4_K_M.gguf](https://huggingface.co/handy-computer/cohere-transcribe-03-2026-gguf/resolve/main/cohere-transcribe-03-2026-Q4_K_M.gguf) | 1.55 GB | 1.25% |
62
+
63
+ WER measured on the full LibriSpeech test-clean split (2620 utterances) with
64
+ greedy decoding and no external LM. BF16 reference baseline: 1.26%.
65
+ Cohere's self-reported number on the same split is 1.25%
66
+ (Open ASR Leaderboard, as of 2026-03-26). Both ours and Cohere's numbers
67
+ use the Whisper EnglishTextNormalizer, so the comparison is apples-to-apples
68
+ and our port matches the upstream reference within rounding.
69
+
70
+
71
+ ## Usage
72
+
73
+ Build transcribe.cpp from source:
74
+
75
+ ```bash
76
+ git clone git@github.com:handy-computer/transcribe.cpp.git
77
+ cd transcribe.cpp
78
+ cmake -B build && cmake --build build
79
+ ```
80
+
81
+ Run on a 16 kHz mono WAV:
82
+
83
+ ```bash
84
+ build/bin/transcribe-cli \
85
+ -m cohere-transcribe-03-2026-Q8_0.gguf \
86
+ input.wav
87
+ ```
88
+
89
+ If your audio isn't already 16 kHz mono WAV, convert it first:
90
+
91
+ ```bash
92
+ ffmpeg -i input.mp3 -ar 16000 -ac 1 output.wav
93
+ ```
94
+
95
+ See the [transcribe.cpp model page](https://github.com/handy-computer/transcribe.cpp/blob/main/docs/models/cohere-transcribe-03-2026.md) for performance
96
+ numbers, numerical validation, and reproduction steps.
97
+
98
+ ## License
99
+
100
+ Inherited from the base model: **Apache-2.0**. See the
101
+ [upstream model card](https://huggingface.co/CohereLabs/cohere-transcribe-03-2026) for full terms.
102
+
103
+ ---
104
+
105
+ ## Original Model Card
106
+
107
+ > The section below is reproduced from
108
+ > [`CohereLabs/cohere-transcribe-03-2026`](https://huggingface.co/CohereLabs/cohere-transcribe-03-2026) at commit
109
+ > `76b8b23` for offline reference. The upstream card is the
110
+ > authoritative source.
111
+
112
+ # Cohere Transcribe
113
+
114
+ Cohere Transcribe is an open source release of a 2B parameter dedicated audio-in, text-out automatic speech recognition (ASR) model. The model supports 14 languages.
115
+
116
+ Developed by: [Cohere](https://cohere.com) and [Cohere Labs](https://cohere.com/research). Point of Contact: [Cohere Labs](https://cohere.com/research).
117
+
118
+ <style>
119
+ @scope {
120
+ th, td {
121
+ text-align: left;
122
+ padding: 0.375rem 0.625rem;
123
+ letter-spacing: 0;
124
+ vertical-align: top;
125
+ line-height: 133.3333%;
126
+ border: 1px solid #e0e0e0;
127
+ }
128
+ ul {
129
+ list-style-type: disc;
130
+ margin: 0;
131
+ padding-left: 1em;
132
+
133
+ li {
134
+ margin: 0.25rem 0 0;
135
+ line-height: 133.3333%;
136
+ }
137
+ }
138
+ }
139
+ </style>
140
+ <table>
141
+ <tbody>
142
+ <tr>
143
+ <th>Name</th>
144
+ <td><strong>cohere-transcribe-03-2026</strong></td>
145
+ </tr>
146
+ <tr>
147
+ <th>Architecture</th>
148
+ <td>conformer-based encoder-decoder</td>
149
+ </tr>
150
+ <tr>
151
+ <th>Input</th>
152
+ <td>audio waveform → log-Mel spectrogram. Audio is automatically resampled to 16kHz if necessary during preprocessing. Similarly, multi-channel (stereo) inputs are averaged to produce a single channel signal.</td>
153
+ </tr>
154
+ <tr>
155
+ <th>Output</th>
156
+ <td>transcribed text</td>
157
+ </tr>
158
+ <tr>
159
+ <th>Model size</th>
160
+ <td>2B</td>
161
+ </tr>
162
+ <tr>
163
+ <th>Model</th>
164
+ <td>a large Conformer encoder extracts acoustic representations, followed by a lightweight Transformer decoder for token generation</td>
165
+ </tr>
166
+ <tr>
167
+ <th>Training objective</th>
168
+ <td>supervised cross-entropy on output tokens; trained from scratch</td>
169
+ </tr>
170
+ <tr>
171
+ <th>Languages</th>
172
+ <td>
173
+ Trained on 14 languages:
174
+ <ul>
175
+ <li><strong>European:</strong> English, French, German, Italian, Spanish, Portuguese, Greek,
176
+ Dutch, Polish</li>
177
+ <li><strong>AIPAC:</strong> Chinese (Mandarin), Japanese, Korean, Vietnamese</li>
178
+ <li><strong>MENA:</strong> Arabic</li>
179
+ </ul>
180
+ </td>
181
+ </tr>
182
+ <tr>
183
+ <th>License</th>
184
+ <td>Apache 2.0</td>
185
+ </tr>
186
+ </tbody>
187
+ </table>
188
+
189
+ ✨**Try the Cohere Transcribe** [**demo**](https://huggingface.co/spaces/CohereLabs/cohere-transcribe-03-2026)✨
190
+
191
+ ## Usage
192
+
193
+ Cohere Transcribe is supported natively in `transformers`. This is the recommended way to use the model for
194
+ offline inference. For online inference, see the vLLM integration example below.
195
+
196
+ ```bash
197
+ pip install transformers>=5.4.0 torch huggingface_hub soundfile librosa sentencepiece protobuf
198
+ pip install datasets # only needed for long-form and non-English examples
199
+ ```
200
+
201
+ Testing was carried out with `torch==2.10.0` but it is expected to work with other versions.
202
+
203
+ ### Quick Start 🤗
204
+
205
+ Transcribe any audio file in a few lines:
206
+
207
+ ```python
208
+ from transformers import AutoProcessor, CohereAsrForConditionalGeneration
209
+ from transformers.audio_utils import load_audio
210
+ from huggingface_hub import hf_hub_download
211
+
212
+ processor = AutoProcessor.from_pretrained("CohereLabs/cohere-transcribe-03-2026")
213
+ model = CohereAsrForConditionalGeneration.from_pretrained("CohereLabs/cohere-transcribe-03-2026", device_map="auto")
214
+
215
+ audio_file = hf_hub_download(
216
+ repo_id="CohereLabs/cohere-transcribe-03-2026",
217
+ filename="demo/voxpopuli_test_en_demo.wav",
218
+ )
219
+ audio = load_audio(audio_file, sampling_rate=16000)
220
+
221
+ inputs = processor(audio, sampling_rate=16000, return_tensors="pt", language="en")
222
+ inputs.to(model.device, dtype=model.dtype)
223
+
224
+ outputs = model.generate(**inputs, max_new_tokens=256)
225
+ text = processor.decode(outputs, skip_special_tokens=True)
226
+ print(text)
227
+ ```
228
+
229
+ <details>
230
+ <summary><b>Long-form transcription</b></summary>
231
+
232
+ For audio longer than the feature extractor's `max_audio_clip_s`, the feature extractor automatically splits the waveform into chunks.
233
+ The processor reassembles the per-chunk transcriptions using the returned `audio_chunk_index`.
234
+
235
+ This example transcribes a 55 minute earnings call:
236
+
237
+ ```python
238
+ from transformers import AutoProcessor, CohereAsrForConditionalGeneration
239
+ from datasets import load_dataset
240
+ import time
241
+
242
+ processor = AutoProcessor.from_pretrained("CohereLabs/cohere-transcribe-03-2026")
243
+ model = CohereAsrForConditionalGeneration.from_pretrained("CohereLabs/cohere-transcribe-03-2026", device_map="auto")
244
+
245
+ ds = load_dataset("distil-whisper/earnings22", "full", split="test", streaming=True)
246
+ sample = next(iter(ds))
247
+
248
+ audio_array = sample["audio"]["array"]
249
+ sr = sample["audio"]["sampling_rate"]
250
+ duration_s = len(audio_array) / sr
251
+ print(f"Audio duration: {duration_s / 60:.1f} minutes")
252
+
253
+ inputs = processor(audio=audio_array, sampling_rate=sr, return_tensors="pt", language="en")
254
+ audio_chunk_index = inputs.get("audio_chunk_index")
255
+ inputs.to(model.device, dtype=model.dtype)
256
+
257
+ start = time.time()
258
+ outputs = model.generate(**inputs, max_new_tokens=256)
259
+ text = processor.decode(outputs, skip_special_tokens=True, audio_chunk_index=audio_chunk_index, language="en")[0]
260
+ elapsed = time.time() - start
261
+ rtfx = duration_s / elapsed
262
+ print(f"Transcribed in {elapsed:.1f}s — RTFx: {rtfx:.1f}")
263
+ print(f"Transcription ({len(text.split())} words):")
264
+ print(text[:500] + "...")
265
+ ```
266
+ </details>
267
+
268
+ <details>
269
+ <summary><b>Punctuation control</b></summary>
270
+
271
+ Pass `punctuation=False` to obtain lower-cased output without punctuation marks.
272
+
273
+ ```python
274
+ inputs_pnc = processor(audio, sampling_rate=16000, return_tensors="pt", language="en", punctuation=True)
275
+ inputs_nopnc = processor(audio, sampling_rate=16000, return_tensors="pt", language="en", punctuation=False)
276
+ ```
277
+
278
+ By default, punctuation is enabled.
279
+
280
+ </details>
281
+
282
+ <details>
283
+ <summary><b>Batched inference</b></summary>
284
+
285
+ Multiple audio files can be processed in a single call. When the batch mixes short-form and long-form audio, the
286
+ processor handles chunking and reassembly.
287
+
288
+ ```python
289
+ from transformers import AutoProcessor, CohereAsrForConditionalGeneration
290
+ from transformers.audio_utils import load_audio
291
+
292
+ processor = AutoProcessor.from_pretrained("CohereLabs/cohere-transcribe-03-2026")
293
+ model = CohereAsrForConditionalGeneration.from_pretrained("CohereLabs/cohere-transcribe-03-2026", device_map="auto")
294
+
295
+ audio_short = load_audio(
296
+ "https://huggingface.co/datasets/hf-internal-testing/dummy-audio-samples/resolve/main/bcn_weather.mp3",
297
+ sampling_rate=16000,
298
+ )
299
+ audio_long = load_audio(
300
+ "https://huggingface.co/datasets/hf-internal-testing/dummy-audio-samples/resolve/main/obama_first_45_secs.mp3",
301
+ sampling_rate=16000,
302
+ )
303
+
304
+ inputs = processor([audio_short, audio_long], sampling_rate=16000, return_tensors="pt", language="en")
305
+ audio_chunk_index = inputs.get("audio_chunk_index")
306
+ inputs.to(model.device, dtype=model.dtype)
307
+
308
+ outputs = model.generate(**inputs, max_new_tokens=256)
309
+ text = processor.decode(
310
+ outputs, skip_special_tokens=True, audio_chunk_index=audio_chunk_index, language="en"
311
+ )
312
+ print(text)
313
+ ```
314
+ </details>
315
+
316
+ <details>
317
+ <summary><b>Non-English transcription</b></summary>
318
+
319
+ Specify the language code to transcribe in any of the 14 supported languages. This example transcribes Japanese audio from the FLEURS dataset:
320
+
321
+ ```python
322
+ from transformers import AutoProcessor, CohereAsrForConditionalGeneration
323
+ from datasets import load_dataset
324
+
325
+ processor = AutoProcessor.from_pretrained("CohereLabs/cohere-transcribe-03-2026")
326
+ model = CohereAsrForConditionalGeneration.from_pretrained("CohereLabs/cohere-transcribe-03-2026", device_map="auto")
327
+
328
+ ds = load_dataset("google/fleurs", "ja_jp", split="test", streaming=True)
329
+ ds_iter = iter(ds)
330
+ samples = [next(ds_iter) for _ in range(3)]
331
+
332
+ for sample in samples:
333
+ audio = sample["audio"]["array"]
334
+ sr = sample["audio"]["sampling_rate"]
335
+
336
+ inputs = processor(audio, sampling_rate=sr, return_tensors="pt", language="ja")
337
+ inputs.to(model.device, dtype=model.dtype)
338
+
339
+ outputs = model.generate(**inputs, max_new_tokens=256)
340
+ text = processor.decode(outputs, skip_special_tokens=True)
341
+ print(f"REF: {sample['transcription']}\nHYP: {text}\n")
342
+ ```
343
+ </details>
344
+
345
+ ### Broader dependency support with `trust_remote_code=True`
346
+
347
+ For a wider range of `torch` and `transformers` versions, run with `trust_remote_code=True`.
348
+ You should expect greater stability via the transformers native path above.
349
+ This option will be deprecated in the future.
350
+
351
+ <details>
352
+ <summary><b>Usage with <code>trust_remote_code=True</code></b></summary>
353
+
354
+ `trust_remote_code=True` inference exposes a single `model.transcribe()` method that automatically handles long-form audio chunking and exposes parameters to facilitate efficient inference. It is recommended that you let the transcribe method handle batching for you. This implementation is optimized for offline inference: for online inference, see the vLLM integration example below.
355
+
356
+ #### Installation
357
+
358
+ Recommended:
359
+
360
+ ```bash
361
+ pip install "transformers>=4.56,<5.3,!=5.0.*,!=5.1.*" torch huggingface_hub soundfile librosa sentencepiece protobuf
362
+ pip install datasets # only needed for examples 2 and 3
363
+ ```
364
+
365
+ <details>
366
+ <summary><b>Installation with even broader <code>transformers</code> compatibility</b></summary>
367
+ <br>
368
+
369
+ For broader compatibility run the following install:
370
+ ```bash
371
+ pip install "transformers>=4.52,!=5.0.*,!=5.1.*" torch huggingface_hub soundfile librosa sentencepiece protobuf
372
+ ```
373
+
374
+ This will replace the efficient static-cache with a dynamic-cache fallback on some versions.
375
+
376
+ Transformers 5.0 and 5.1 have a weight-loading issue and are **not compatible**.
377
+ </details>
378
+
379
+ #### Example 1: Quick Start
380
+
381
+ Transcribe any audio file in a few lines. The model accepts file paths directly — no manual preprocessing required.
382
+
383
+ ```python
384
+ import torch
385
+ from transformers import AutoProcessor, AutoModelForSpeechSeq2Seq
386
+ from huggingface_hub import hf_hub_download
387
+
388
+ model_id = "CohereLabs/cohere-transcribe-03-2026"
389
+
390
+ device = "cuda:0" if torch.cuda.is_available() else "cpu"
391
+
392
+ processor = AutoProcessor.from_pretrained(model_id, trust_remote_code=True)
393
+ model = AutoModelForSpeechSeq2Seq.from_pretrained(model_id, trust_remote_code=True).to(device)
394
+ model.eval()
395
+
396
+ audio_file = hf_hub_download(
397
+ repo_id="CohereLabs/cohere-transcribe-03-2026",
398
+ filename="demo/voxpopuli_test_en_demo.wav",
399
+ )
400
+
401
+ texts = model.transcribe(processor=processor, audio_files=[audio_file], language="en")
402
+ print(texts[0])
403
+ ```
404
+
405
+ <details>
406
+ <summary><b>Example 2: Optimized Throughput</b></summary>
407
+
408
+ When audio is already in memory (streaming datasets, microphone input, etc.), pass numpy arrays directly instead of file paths. Enable `compile=True` to torch.compile the encoder for faster throughput, and `pipeline_detokenization=True` to overlap CPU detokenization with GPU inference.
409
+
410
+ > **Note:** `pipeline_detokenization=True` is not supported on Windows.
411
+
412
+ This example transcribes Japanese audio from the FLEURS dataset:
413
+
414
+ ```python
415
+ import torch
416
+ from transformers import AutoProcessor, AutoModelForSpeechSeq2Seq
417
+ from huggingface_hub import hf_hub_download
418
+
419
+
420
+ model_id = "CohereLabs/cohere-transcribe-03-2026"
421
+
422
+ device = "cuda:0" if torch.cuda.is_available() else "cpu"
423
+
424
+ processor = AutoProcessor.from_pretrained(model_id, trust_remote_code=True)
425
+ model = AutoModelForSpeechSeq2Seq.from_pretrained(model_id, trust_remote_code=True).to(device)
426
+ model.eval()
427
+
428
+ from datasets import load_dataset
429
+
430
+ ds = load_dataset("google/fleurs", "ja_jp", split="test", streaming=True)
431
+ ds_iter = iter(ds)
432
+ samples = [next(ds_iter) for _ in range(3)] # take 3 samples
433
+
434
+ audio_arrays = [s["audio"]["array"] for s in samples]
435
+ sample_rates = [s["audio"]["sampling_rate"] for s in samples]
436
+
437
+ # compile=True incurs a one-time warmup cost on the first call; subsequent calls are faster.
438
+ texts = model.transcribe(
439
+ processor=processor,
440
+ audio_arrays=audio_arrays,
441
+ sample_rates=sample_rates,
442
+ language="ja",
443
+ compile=True,
444
+ pipeline_detokenization=True,
445
+ batch_size=16,
446
+ )
447
+ for ref, hyp in zip([s["transcription"] for s in samples], texts):
448
+ print(f"REF: {ref}\nHYP: {hyp}\n")
449
+ ```
450
+ </details>
451
+
452
+ <details>
453
+ <summary><b>Example 3: Long-Form Audio</b></summary>
454
+
455
+ Audio longer than 35 seconds is automatically split into overlapping chunks and reassembled. The API is identical — no special flags or configuration needed. This example transcribes a 55 minute earnings call. This will be slow if you haven't run `compile=True` in the previous example:
456
+
457
+ ```python
458
+ import torch
459
+ from transformers import AutoProcessor, AutoModelForSpeechSeq2Seq
460
+ from huggingface_hub import hf_hub_download
461
+
462
+
463
+ model_id = "CohereLabs/cohere-transcribe-03-2026"
464
+
465
+ device = "cuda:0" if torch.cuda.is_available() else "cpu"
466
+
467
+ processor = AutoProcessor.from_pretrained(model_id, trust_remote_code=True)
468
+ model = AutoModelForSpeechSeq2Seq.from_pretrained(model_id, trust_remote_code=True).to(device)
469
+ model.eval()
470
+
471
+ from datasets import load_dataset
472
+
473
+ ds = load_dataset("distil-whisper/earnings22", "full", split="test", streaming=True)
474
+ sample = next(iter(ds))
475
+
476
+ import time
477
+
478
+ audio_array = sample["audio"]["array"]
479
+ sr = sample["audio"]["sampling_rate"]
480
+ duration_s = len(audio_array) / sr
481
+ print(f"Audio duration: {duration_s / 60:.1f} minutes")
482
+
483
+ start = time.time()
484
+ texts = model.transcribe(
485
+ processor=processor,
486
+ audio_arrays=[audio_array],
487
+ sample_rates=[sr],
488
+ language="en",
489
+ compile=True,
490
+ )
491
+ elapsed = time.time() - start
492
+ rtfx = duration_s / elapsed
493
+ print(f"Transcribed in {elapsed:.1f}s — RTFx: {rtfx:.1f}")
494
+ print(f"Transcription ({len(texts[0].split())} words):")
495
+ print(texts[0][:500] + "...")
496
+ ```
497
+ </details>
498
+
499
+ <details>
500
+ <summary><b><code>transcribe()</code> API Reference</b></summary>
501
+
502
+
503
+ | Argument | Type | Default | Description |
504
+ |---|---|---|---|
505
+ | `processor` | `AutoProcessor` | required | Processor instance for this model |
506
+ | `language` | `str` | required | [ISO 639-1 language code](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes). The model does not perform language detection, so this is always required |
507
+ | `audio_files` | `list[str]` | `None` | List of audio file paths. Mutually exclusive with `audio_arrays` |
508
+ | `audio_arrays` | `list[np.ndarray]` | `None` | List of 1-D numpy float arrays (raw waveforms). Requires `sample_rates` |
509
+ | `sample_rates` | `list[int]` | `None` | Sample rate for each entry in `audio_arrays` |
510
+ | `punctuation` | `bool` | `True` | Include punctuation in output |
511
+ | `batch_size` | `int` | from config | GPU batch size for inference |
512
+ | `compile` | `bool` | `False` | `torch.compile` encoder layers for faster throughput. First call incurs a one-time warmup cost |
513
+ | `pipeline_detokenization` | `bool` | `False` | Overlap CPU detokenization with GPU inference. Beneficial when more audio segments than `batch_size` are passed in a single call |
514
+
515
+
516
+
517
+ **Returns:** `list[str]` — one transcription string per input audio.
518
+
519
+ </details>
520
+
521
+ </details>
522
+
523
+ ### vLLM Integration
524
+
525
+ For production serving we recommend running via vLLM following the instructions below.
526
+
527
+ <details>
528
+ <summary><b>Run cohere-transcribe-03-2026 via vLLM</b></summary>
529
+
530
+ First install vLLM (refer to [vLLM installation instructions](https://docs.vllm.ai/en/latest/getting_started/installation/)):
531
+
532
+ ```bash
533
+ uv pip install -U vllm --torch-backend=auto --extra-index-url https://wheels.vllm.ai/nightly
534
+ uv pip install vllm[audio]
535
+ uv pip install librosa
536
+ ```
537
+
538
+ Start vLLM server
539
+ ```bash
540
+ vllm serve CohereLabs/cohere-transcribe-03-2026 --trust-remote-code
541
+ ```
542
+
543
+ Send request
544
+ ```bash
545
+ curl -v -X POST http://localhost:8000/v1/audio/transcriptions \
546
+ -H "Authorization: Bearer $VLLM_API_KEY" \
547
+ -F "file=@$(realpath ${AUDIO_PATH})" \
548
+ -F "model=CohereLabs/cohere-transcribe-03-2026"
549
+ ```
550
+ </details>
551
+
552
+ ## Results
553
+
554
+ <details>
555
+ <summary><b>English ASR Leaderboard (as of 03.26.2026)</b></summary>
556
+
557
+ <style>
558
+ table.simple {
559
+ border-collapse: collapse;
560
+ }
561
+
562
+ table.simple th,
563
+ table.simple td {
564
+ text-align: left;
565
+ padding: 0.375rem 0.625rem;
566
+ min-width: 5em;
567
+ vertical-align: top;
568
+ line-height: 1.2;
569
+ border-bottom: 1px solid rgba(127,127,127,0.35);
570
+ }
571
+
572
+ table.simple thead th {
573
+ white-space: nowrap;
574
+ }
575
+
576
+ table.simple th:first-child {
577
+ position: sticky;
578
+ left: 0;
579
+ background: inherit;
580
+ z-index: 1;
581
+ }
582
+
583
+ table.simple .num {
584
+ text-align: right;
585
+ }
586
+
587
+ table.simple .highlight-row > th,
588
+ table.simple .highlight-row > td {
589
+ background: rgba(127,127,127,0.12);
590
+ }
591
+
592
+ table.simple .highlight-cell {
593
+ background: rgba(127,127,127,0.18);
594
+ }
595
+ </style>
596
+
597
+ <div style="overflow-x: auto;">
598
+ <table class="simple text-web3-14 font-body">
599
+ <thead>
600
+ <tr>
601
+ <th>Model</th>
602
+ <th class="num">Average WER</th>
603
+ <th class="num">AMI</th>
604
+ <th class="num">Earnings 22</th>
605
+ <th class="num">Gigaspeech</th>
606
+ <th class="num">LS clean</th>
607
+ <th class="num">LS other</th>
608
+ <th class="num">SPGISpeech</th>
609
+ <th class="num">Tedlium</th>
610
+ <th class="num">Voxpopuli</th>
611
+ </tr>
612
+ </thead>
613
+ <tbody>
614
+ <tr class="highlight-row">
615
+ <th><strong style="white-space:nowrap">Cohere Transcribe</strong></th>
616
+ <td class="num highlight-cell"><strong>5.42</strong></td>
617
+ <td class="num"><strong>8.15</strong></td>
618
+ <td class="num">10.84</td>
619
+ <td class="num">9.33</td>
620
+ <td class="num"><strong>1.25</strong></td>
621
+ <td class="num"><strong>2.37</strong></td>
622
+ <td class="num">3.08</td>
623
+ <td class="num">2.49</td>
624
+ <td class="num">5.87</td>
625
+ </tr>
626
+ <tr>
627
+ <th style="font-weight:normal;">Zoom Scribe v1</th>
628
+ <td class="num">5.47</td>
629
+ <td class="num">10.03</td>
630
+ <td class="num">9.53</td>
631
+ <td class="num">9.61</td>
632
+ <td class="num">1.63</td>
633
+ <td class="num">2.81</td>
634
+ <td class="num"><strong>1.59</strong></td>
635
+ <td class="num">3.22</td>
636
+ <td class="num"><strong>5.37</strong></td>
637
+ </tr>
638
+ <tr>
639
+ <th style="font-weight:normal;">IBM Granite 4.0 1B Speech</th>
640
+ <td class="num">5.52</td>
641
+ <td class="num">8.44</td>
642
+ <td class="num"><strong>8.48</strong></td>
643
+ <td class="num">10.14</td>
644
+ <td class="num">1.42</td>
645
+ <td class="num">2.85</td>
646
+ <td class="num">3.89</td>
647
+ <td class="num">3.10</td>
648
+ <td class="num">5.84</td>
649
+ </tr>
650
+ <tr>
651
+ <th style="font-weight:normal;">NVIDIA Canary Qwen 2.5B</th>
652
+ <td class="num">5.63</td>
653
+ <td class="num">10.19</td>
654
+ <td class="num">10.45</td>
655
+ <td class="num">9.43</td>
656
+ <td class="num">1.61</td>
657
+ <td class="num">3.10</td>
658
+ <td class="num">1.90</td>
659
+ <td class="num">2.71</td>
660
+ <td class="num">5.66</td>
661
+ </tr>
662
+ <tr>
663
+ <th style="font-weight:normal;">Qwen3-ASR-1.7B</th>
664
+ <td class="num">5.76</td>
665
+ <td class="num">10.56</td>
666
+ <td class="num">10.25</td>
667
+ <td class="num"><strong>8.74</strong></td>
668
+ <td class="num">1.63</td>
669
+ <td class="num">3.40</td>
670
+ <td class="num">2.84</td>
671
+ <td class="num"><strong>2.28</strong></td>
672
+ <td class="num">6.35</td>
673
+ </tr>
674
+ <tr>
675
+ <th style="font-weight:normal;">ElevenLabs Scribe v2</th>
676
+ <td class="num">5.83</td>
677
+ <td class="num">11.86</td>
678
+ <td class="num">9.43</td>
679
+ <td class="num">9.11</td>
680
+ <td class="num">1.54</td>
681
+ <td class="num">2.83</td>
682
+ <td class="num">2.68</td>
683
+ <td class="num">2.37</td>
684
+ <td class="num">6.80</td>
685
+ </tr>
686
+ <tr>
687
+ <th style="font-weight:normal;">Kyutai STT 2.6B</th>
688
+ <td class="num">6.40</td>
689
+ <td class="num">12.17</td>
690
+ <td class="num">10.99</td>
691
+ <td class="num">9.81</td>
692
+ <td class="num">1.70</td>
693
+ <td class="num">4.32</td>
694
+ <td class="num">2.03</td>
695
+ <td class="num">3.35</td>
696
+ <td class="num">6.79</td>
697
+ </tr>
698
+ <tr>
699
+ <th style="font-weight:normal;">OpenAI Whisper Large v3</th>
700
+ <td class="num">7.44</td>
701
+ <td class="num">15.95</td>
702
+ <td class="num">11.29</td>
703
+ <td class="num">10.02</td>
704
+ <td class="num">2.01</td>
705
+ <td class="num">3.91</td>
706
+ <td class="num">2.94</td>
707
+ <td class="num">3.86</td>
708
+ <td class="num">9.54</td>
709
+ </tr>
710
+ <tr>
711
+ <th style="font-weight:normal;">Voxtral Mini 4B Realtime 2602</th>
712
+ <td class="num">7.68</td>
713
+ <td class="num">17.07</td>
714
+ <td class="num">11.84</td>
715
+ <td class="num">10.38</td>
716
+ <td class="num">2.08</td>
717
+ <td class="num">5.52</td>
718
+ <td class="num">2.42</td>
719
+ <td class="num">3.79</td>
720
+ <td class="num">8.34</td>
721
+ </tr>
722
+ </tbody>
723
+ </table>
724
+ </div>
725
+
726
+ Link to the live leaderboard: [Open ASR Leaderboard](https://huggingface.co/spaces/hf-audio/open_asr_leaderboard).
727
+
728
+ </details>
729
+
730
+
731
+ #### Human-preference results
732
+
733
+ We observe similarly strong performance in human evaluations, where trained annotators assess transcription quality across
734
+ real-world audio for accuracy, coherence and usability.
735
+ The consistency between automated metrics and human judgments suggests that the model’s improvements translate
736
+ beyond controlled benchmarks to practical transcription settings.
737
+
738
+ <img src="./assets/260326_TranscribeLaunch_Plot1.png" alt="Human-preference results" width="100%">
739
+
740
+ _Figure: Human preference evaluation of model transcripts. In a head-to-head comparison,
741
+ annotators were asked to express preferences for generations which primarily preserved meaning -
742
+ but also avoided hallucination, correctly identified named entities,
743
+ and provided verbatim transcripts with appropriate formatting.
744
+ A score of 50% or higher indicates that Cohere Transcribe was preferred on average in the comparison._
745
+
746
+ </details>
747
+ <details>
748
+ <summary><b>per-language WERs</b></summary>
749
+
750
+ <img src="./assets/HF_model_card_per-language-avg-plot.png" alt="per-language WERs" width="100%">
751
+
752
+ _Figure: per-language error rate averaged over FLEURS, Common Voice 17.0, MLS and Wenet tests sets (where relevant for a given language). CER for zh, ja, ko — WER otherwise_
753
+
754
+
755
+ </details>
756
+
757
+ ## Resources
758
+
759
+ For more details and results:
760
+
761
+ * [Technical blog post](https://huggingface.co/blog/CohereLabs/cohere-transcribe-03-2026-release) contains WERs and other quality metrics.
762
+ * [Announcement blog post](https://cohere.com/blog/transcribe) for more information about the model.
763
+ * English, EU and long-form transcription WERs/RTFx are on the [Open ASR Leaderboard](https://huggingface.co/spaces/hf-audio/open_asr_leaderboard).
764
+
765
+ ## Strengths and Limitations
766
+
767
+ Cohere Transcribe is a performant, dedicated ASR model intended for efficient speech transcription.
768
+
769
+ ### Strengths
770
+
771
+ Cohere Transcribe demonstrates best-in-class transcription accuracy in 14 languages. As a dedicated speech recognition model, it is also efficient, benefitting from a real-time factor up to three times faster than that of other, dedicated ASR models in the same size range. The model was trained from scratch, and from the outset, we deliberately focused on maximizing transcription accuracy while keeping production readiness top-of-mind.
772
+
773
+
774
+ ### Limitations
775
+
776
+ * **Single language.** The model performs best when remaining in-distribution of a single, pre-specified language amongst the 14 in the range it supports. It does not feature explicit, automatic language detection and exhibits inconsistent performance on code-switched audio.
777
+
778
+ * **Timestamps/Speaker diarization.** The model does not feature either of these.
779
+
780
+ * **Silence.** Like most AED speech models, Cohere Transcribe is eager to transcribe, even non-speech sounds. The model thus benefits from prepending a noise gate or VAD (voice activity detection) model in order to prevent low-volume, floor noise from turning into hallucinations.
781
+
782
+
783
+ ## Ecosystem support 🚀
784
+
785
+ Cohere Transcribe is supported on the following libraries/platforms:
786
+
787
+ * [`transformers`](https://huggingface.co/docs/transformers/model_doc/cohere_asr) (see [Quick Start](#quick-start) above).
788
+ * [`vLLM`](https://github.com/vllm-project/vllm/pull/38120) (see [vLLM integration](#vllm-integration) above).
789
+ * [`mlx-audio`](https://github.com/Blaizzy/mlx-audio/pull/605) for Apple Silicon.
790
+ * Rust implementation: [`cohere_transcribe_rs`](https://github.com/second-state/cohere_transcribe_rs)
791
+ * In the browser ✨[**demo**](https://huggingface.co/spaces/CohereLabs/Cohere-Transcribe-WebGPU)✨ (via `transformers.js` and WebGPU)
792
+ * Chrome extension: [`cohere_transcribe_extension`](https://github.com/davila7/cohere_transcribe_extension)
793
+ * [Whisper Memos](https://whispermemos.com/kb/features/ai-models#cohere-transcribe) (iOS App).
794
+ * [Whisperian](https://play.google.com/store/apps/details?id=app.whisperian.client) (Android App).
795
+
796
+
797
+ If you have added support for the model somewhere not included above please raise an issue/PR!
798
+
799
+ If you find issues with any of these please raise an issue with the respective library.
800
+
801
+ ## Model Card Contact
802
+ For errors or additional questions about details in this model card, contact [labs@cohere.com](mailto:labs@cohere.com) or raise an issue.
803
+
804
+
805
+ Terms of Use:
806
+ We hope that the release of this model will make community-based research efforts more accessible, by releasing the weights of a highly performant 2 billion parameter model to researchers all over the world. This model is governed by an Apache 2.0 license.