add files

README.md

@@ -0,0 +1,120 @@
+---
+language:
+- fr
+- en
+datasets:
+- covost2
+tags:
+- audio
+- speech-translation
+- automatic-speech-recognition
+license: MIT
+---
+
+
+# S2T-SMALL-COVOST2-FR-EN-ST
+
+`s2t-small-covost2-fr-en-st` is a Speech to Text Transformer (S2T) model trained for end-to-end Speech Translation (ST).
+The S2T model was proposed in [this paper](https://arxiv.org/abs/2010.05171) and released in
+[this repository](https://github.com/pytorch/fairseq/tree/master/examples/speech_to_text)
+
+
+## Model description
+
+S2T is a transformer-based seq2seq (encoder-decoder) model designed for end-to-end Automatic Speech Recognition (ASR) and Speech
+Translation (ST). It uses a convolutional downsampler to reduce the length of speech inputs by 3/4th before they are
+fed into the encoder. The model is trained with standard autoregressive cross-entropy loss and generates the
+transcripts/translations autoregressively.
+
+## Intended uses & limitations
+
+This model can be used for end-to-end French speech to English text translation.
+See the [model hub](https://huggingface.co/models?filter=speech_to_text) to look for other S2T checkpoints.
+
+
+### How to use
+
+As this a standard sequence to sequence transformer model, you can use the `generate` method to generate the
+transcripts by passing the speech features to the model.
+
+*Note: The `Speech2TextProcessor` object uses [torchaudio](https://github.com/pytorch/audio)  to extract the
+filter bank features. Make sure to install the `torchaudio` package before running this example.*
+
+You could either install those as extra speech dependancies with
+`pip install transformers"[speech, sentencepiece]"` or install the packages seperatly 
+with `pip install torchaudio sentencepiece`.
+
+
+```python
+import torch
+from transformers import Speech2TextProcessor, Speech2TextForConditionalGeneration
+from datasets import load_dataset
+import soundfile as sf
+
+model = Speech2TextForConditionalGeneration.from_pretrained("facebook/s2t-small-covost2-fr-en-st")
+processor = Speech2TextProcessor.from_pretrained("facebook/s2t-small-covost2-fr-en-st")
+
+def map_to_array(batch):
+    speech, _ = sf.read(batch["file"])
+    batch["speech"] = speech
+    return batch
+
+ds = load_dataset(
+    "patrickvonplaten/librispeech_asr_dummy",
+    "clean",
+    split="validation"
+)
+ds = ds.map(map_to_array)
+
+inputs = processor(
+    ds["speech"][0],
+    sampling_rate=48_000,
+    return_tensors="pt"
+)
+generated_ids = model.generate(input_ids=inputs["input_features"], attention_mask=inputs["attention_mask"])
+
+translation = processor.batch_decode(generated_ids, skip_special_tokens=True)
+```
+
+
+## Training data
+
+The s2t-small-covost2-fr-en-st is trained on French-English subset of [CoVoST2](https://github.com/facebookresearch/covost).
+CoVoST is a large-scale multilingual ST corpus based on [Common Voice](https://arxiv.org/abs/1912.06670), created to to foster 
+ST research with the largest ever open dataset
+
+
+## Training procedure
+
+### Preprocessing
+
+The speech data is pre-processed by extracting Kaldi-compliant 80-channel log mel-filter bank features automatically from
+WAV/FLAC audio files via PyKaldi or torchaudio. Further utterance-level CMVN (cepstral mean and variance normalization)
+is applied to each example.
+
+The texts are lowercased and tokenized using character based SentencePiece vocab.
+
+
+### Training
+
+The model is trained with standard autoregressive cross-entropy loss and using [SpecAugment](https://arxiv.org/abs/1904.08779).
+The encoder receives speech features, and the decoder generates the transcripts autoregressively. To accelerate
+model training and for better performance the encoder is pre-trained for English ASR.
+
+## Evaluation results
+
+CoVOST2 test results for fr-en (BLEU score): 26.25
+
+
+
+### BibTeX entry and citation info
+
+```bibtex
+@inproceedings{wang2020fairseqs2t,
+  title = {fairseq S2T: Fast Speech-to-Text Modeling with fairseq},
+  author = {Changhan Wang and Yun Tang and Xutai Ma and Anne Wu and Dmytro Okhonko and Juan Pino},
+  booktitle = {Proceedings of the 2020 Conference of the Asian Chapter of the Association for Computational Linguistics (AACL): System Demonstrations},
+  year = {2020},
+}
+
+```

config.json

@@ -0,0 +1,46 @@
+{
+  "activation_dropout": 0.1,
+  "activation_function": "relu",
+  "architectures": [
+    "Speech2TextForConditionalGeneration"
+  ],
+  "attention_dropout": 0.1,
+  "bos_token_id": 0,
+  "classifier_dropout": 0.0,
+  "conv_channels": 1024,
+  "conv_kernel_sizes": [
+    5,
+    5
+  ],
+  "d_model": 256,
+  "decoder_attention_heads": 4,
+  "decoder_ffn_dim": 2048,
+  "decoder_layerdrop": 0.0,
+  "decoder_layers": 6,
+  "decoder_start_token_id": 2,
+  "dropout": 0.1,
+  "early_stopping": true,
+  "encoder_attention_heads": 4,
+  "encoder_ffn_dim": 2048,
+  "encoder_layerdrop": 0.0,
+  "encoder_layers": 12,
+  "eos_token_id": 2,
+  "gradient_checkpointing": false,
+  "init_std": 0.02,
+  "input_channels": 1,
+  "input_feat_per_channel": 80,
+  "is_encoder_decoder": true,
+  "max_length": 200,
+  "max_source_positions": 6000,
+  "max_target_positions": 1024,
+  "model_type": "speech_to_text",
+  "num_beams": 5,
+  "num_conv_layers": 2,
+  "num_hidden_layers": 12,
+  "pad_token_id": 1,
+  "scale_embedding": true,
+  "tie_word_embeddings": false,
+  "transformers_version": "4.4.0.dev0",
+  "use_cache": true,
+  "vocab_size": 277
+}

preprocessor_config.json

@@ -0,0 +1,11 @@
+{
+  "do_ceptral_normalize": true,
+  "feature_size": 80,
+  "normalize_means": true,
+  "normalize_vars": true,
+  "num_mel_bins": 80,
+  "padding_side": "right",
+  "padding_value": 0.0,
+  "return_attention_mask": true,
+  "sampling_rate": 48000
+}

pytorch_model.bin

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

sentencepiece.bpe.model

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

special_tokens_map.json

@@ -0,0 +1 @@
+{"bos_token": "<s>", "eos_token": "</s>", "unk_token": "<unk>", "pad_token": "<pad>"}

tokenizer_config.json

@@ -0,0 +1 @@
+{"bos_token": "<s>", "eos_token": "</s>", "unk_token": "<unk>", "pad_token": "<pad>", "do_upper_case": false, "do_lower_case": false, "tgt_lang": null, "lang_codes": null, "tokenizer_file": null}

vocab.json

@@ -0,0 +1,279 @@
+{
+  "<s>": 0,
+  "<pad>": 1,
+  "</s>": 2,
+  "<unk>": 3,
+  "\u2581": 4,
+  "e": 5,
+  "t": 6,
+  "a": 7,
+  "o": 8,
+  "i": 9,
+  "n": 10,
+  "r": 11,
+  "s": 12,
+  "h": 13,
+  "l": 14,
+  "d": 15,
+  "u": 16,
+  "c": 17,
+  "m": 18,
+  ".": 19,
+  "f": 20,
+  "y": 21,
+  "g": 22,
+  "p": 23,
+  "w": 24,
+  "b": 25,
+  ",": 26,
+  "v": 27,
+  "T": 28,
+  "k": 29,
+  "I": 30,
+  "-": 31,
+  "S": 32,
+  "A": 33,
+  "H": 34,
+  "M": 35,
+  "\u2019": 36,
+  "C": 37,
+  "x": 38,
+  "B": 39,
+  "P": 40,
+  "W": 41,
+  "z": 42,
+  "L": 43,
+  "F": 44,
+  "D": 45,
+  "G": 46,
+  "R": 47,
+  "?": 48,
+  "!": 49,
+  "N": 50,
+  "E": 51,
+  "\u00e9": 52,
+  "q": 53,
+  "O": 54,
+  "j": 55,
+  "J": 56,
+  "Y": 57,
+  "V": 58,
+  "K": 59,
+  "'": 60,
+  "U": 61,
+  "\u00e8": 62,
+  "0": 63,
+  "\u201d": 64,
+  ":": 65,
+  "Q": 66,
+  "1": 67,
+  "\u201c": 68,
+  ";": 69,
+  "\u00c9": 70,
+  "Z": 71,
+  "\u00e7": 72,
+  "2": 73,
+  "3": 74,
+  "\u00e2": 75,
+  "/": 76,
+  "5": 77,
+  "4": 78,
+  "(": 79,
+  "6": 80,
+  "7": 81,
+  ")": 82,
+  "\u00f4": 83,
+  "8": 84,
+  "9": 85,
+  "\u00eb": 86,
+  "\"": 87,
+  "X": 88,
+  "\u00ef": 89,
+  "\u00e1": 90,
+  "\u00fc": 91,
+  "\u00ea": 92,
+  "\u2014": 93,
+  "\u2018": 94,
+  "\u00ed": 95,
+  "\u00f6": 96,
+  "\u00f3": 97,
+  "\u00ee": 98,
+  "\u014d": 99,
+  "\u00e4": 100,
+  "\u00e0": 101,
+  "\u00ab": 102,
+  "\u00bb": 103,
+  "\u0153": 104,
+  "\u00ce": 105,
+  "\u0161": 106,
+  "\u0107": 107,
+  "&": 108,
+  "_": 109,
+  "\u00f1": 110,
+  "\u0142": 111,
+  "=": 112,
+  "\u010d": 113,
+  "`": 114,
+  "\u00fb": 115,
+  "\u00fa": 116,
+  "[": 117,
+  "]": 118,
+  "\u00f8": 119,
+  "\u0101": 120,
+  "\u016b": 121,
+  "\u00e3": 122,
+  "\u0103": 123,
+  "\u0131": 124,
+  "\u2013": 125,
+  "\u0144": 126,
+  "\u00e5": 127,
+  "\u0160": 128,
+  "\u00d6": 129,
+  "\u00df": 130,
+  "%": 131,
+  "\u00b0": 132,
+  "<": 133,
+  "\u0119": 134,
+  "\u015f": 135,
+  "\u00c1": 136,
+  "\u0219": 137,
+  "|": 138,
+  "\u00fd": 139,
+  "\u00ff": 140,
+  "\u010c": 141,
+  "}": 142,
+  "\u00e6": 143,
+  "{": 144,
+  "\u014c": 145,
+  "\u0159": 146,
+  "$": 147,
+  "\u017e": 148,
+  "\u00c5": 149,
+  "\u00c6": 150,
+  "\u00f0": 151,
+  "\u00f2": 152,
+  "\u0105": 153,
+  "\u011f": 154,
+  "\u0151": 155,
+  "\u0152": 156,
+  "\u015b": 157,
+  "\u021b": 158,
+  "\u00c2": 159,
+  "\u011b": 160,
+  "\u015a": 161,
+  "\u017b": 162,
+  ">": 163,
+  "\u00c4": 164,
+  "\u00f5": 165,
+  "\u00f9": 166,
+  "\u0111": 167,
+  "\u0113": 168,
+  "\u0117": 169,
+  "\u0141": 170,
+  "\u015e": 171,
+  "\u017c": 172,
+  "\u1e63": 173,
+  "\u00c0": 174,
+  "\u00c7": 175,
+  "\u00ca": 176,
+  "\u00d8": 177,
+  "\u00ec": 178,
+  "\u012b": 179,
+  "\u017d": 180,
+  "\u02bb": 181,
+  "\u02bf": 182,
+  "@": 183,
+  "~": 184,
+  "\u00a3": 185,
+  "\u00c8": 186,
+  "\u00cd": 187,
+  "\u00d3": 188,
+  "\u00d4": 189,
+  "\u00da": 190,
+  "\u00dc": 191,
+  "\u0100": 192,
+  "\u0130": 193,
+  "\u0146": 194,
+  "\u0148": 195,
+  "\u014f": 196,
+  "\u017a": 197,
+  "\u02be": 198,
+  "\u043e": 199,
+  "\u20ac": 200,
+  "\u00a7": 201,
+  "\u00b1": 202,
+  "\u00b7": 203,
+  "\u00de": 204,
+  "\u0244": 205,
+  "\u03ba": 206,
+  "\u03c4": 207,
+  "\u1e47": 208,
+  "\u1e6f": 209,
+  "\u661f": 210,
+  "\u00d5": 211,
+  "\u0106": 212,
+  "\u0110": 213,
+  "\u0120": 214,
+  "\u0127": 215,
+  "\u0165": 216,
+  "\u016a": 217,
+  "\u0172": 218,
+  "\u01a1": 219,
+  "\u01b0": 220,
+  "\u01f9": 221,
+  "\u0218": 222,
+  "\u021a": 223,
+  "\u02cb": 224,
+  "\u02d0": 225,
+  "\u0300": 226,
+  "\u0320": 227,
+  "\u0391": 228,
+  "\u0392": 229,
+  "\u0394": 230,
+  "\u03a9": 231,
+  "\u03b1": 232,
+  "\u03b2": 233,
+  "\u03b4": 234,
+  "\u03b6": 235,
+  "\u03c0": 236,
+  "\u03c5": 237,
+  "\u0413": 238,
+  "\u0418": 239,
+  "\u0430": 240,
+  "\u0435": 241,
+  "\u0437": 242,
+  "\u043c": 243,
+  "\u043d": 244,
+  "\u12f0": 245,
+  "\u1e0d": 246,
+  "\u1e45": 247,
+  "\u1e6c": 248,
+  "\u1ea1": 249,
+  "\u1ea3": 250,
+  "\u1ea7": 251,
+  "\u1ead": 252,
+  "\u1ec5": 253,
+  "\u1ec7": 254,
+  "\u1ecb": 255,
+  "\u1ed3": 256,
+  "\u1ed9": 257,
+  "\u1ee3": 258,
+  "\u1eed": 259,
+  "\u1ef3": 260,
+  "\u2039": 261,
+  "\u203a": 262,
+  "\u2205": 263,
+  "\u221e": 264,
+  "\u2609": 265,
+  "\u3044": 266,
+  "\u305f": 267,
+  "\u3064": 268,
+  "\u4e43": 269,
+  "\u4eac": 270,
+  "\u5317": 271,
+  "\u626c": 272,
+  "\u672f": 273,
+  "\u675c": 274,
+  "\u7f8e": 275,
+  "\u9986": 276
+}