Muavic
MuAViC: A Multilingual Audio-Visual Corpus for Robust Speech Recognition and Robust Speech-to-Text Translation
Install / Use
/learn @facebookresearch/MuavicREADME
MuAViC
A Multilingual Audio-Visual Corpus for Robust Speech Recognition and Robust Speech-to-Text Translation.
Overview
MuAViC provides
- 1200 hours of transcribed audio-visual speech for 9 languages (English, Arabic, German, Greek, Spanish, French, Italian, Portuguese and Russian)
- text translations for 6 English-to-X directions and 6 X-to-English directions (X = Greek, Spanish, French, Italian, Portuguese or Russian)
The raw data is collected from TED/TEDx talk recordings.
Detailed statistics
<details><summary>Audio-Visual Speech Recognition</summary><p>| Language | Code | Train Hours (H+P) | Train Speakers | |:---:|:---:|:---:|:---:| | English | En | 436 + 0 | 4.7K | | Arabic | Ar | 16 + 0 | 95 | | German | De | 10 + 0 | 53 | | Greek | El | 25 + 0 | 113 | | Spanish | Es | 178 + 0 | 987 | | French | Fr | 176 + 0 | 948 | | Italian | It | 101 + 0 | 487 | | Portuguese | Pt | 153 + 0 | 810 | | Russian | Ru | 49 + 0 | 238 |
</p></details> <details><summary>Audio-Visual En-X Speech-to-Text Translation</summary><p>| Direction | Code | Train Hours (H+P) | Train Speakers | |:---:|:---:|:---:|:---:| | English-Greek | En-El | 17 + 420 | 4.7K | | English-Spanish | En-Es | 21 + 416 | 4.7K | | English-French | En-Fr | 21 + 416 | 4.7K | | English-Italian | En-It | 20 + 417 | 4.7K | | English-Portuguese | En-Pt | 18 + 419 | 4.7K | | English-Russian | En-Ru | 20 + 417 | 4.7K |
</p></details> <details><summary>Audio-Visual X-En Speech-to-Text Translation</summary><p>| Direction | Code | Train Hours (H+P) | Train Speakers | |:---:|:---:|:---:|:---:| | Greek-English | El-En | 8 + 17 | 113 | | Spanish-English | Es-En | 64 + 114 | 987 | | French-English | Fr-En | 45 + 131 | 948 | | Italian-English | It-En | 48 + 53 | 487 | | Portuguese-English | Pt-En | 53 + 100 | 810 | | Russian-English | Ru-En | 8 + 41 | 238 |
</p></details>Getting Data
We provide scripts to generate the audio/video data and AV-HuBERT training manifests for MuAViC.
First, clone this repo for the scripts
git clone https://github.com/facebookresearch/muavic.git
Install required packages:
conda install -c conda-forge ffmpeg==4.2.2
conda install -c conda-forge sox
pip install -r requirements.txt
Then get audio-visual speech recognition and translation data via
python get_data.py --root-path ${ROOT} --src-lang ${SRC_LANG}
where the speech language ${SRC_LANG} is one of en, ar, de, el, es, fr, it, pt and ru.
Generated data will be saved to ${ROOT}/muavic:
${ROOT}/muavic/${SRC_LANG}/audiofor processed audio files${ROOT}/muavic/${SRC_LANG}/videofor processed video files${ROOT}/muavic/${SRC_LANG}/*.tsvfor AV-HuBERT AVSR training manifests${ROOT}/muavic/${SRC_LANG}/${TGT_LANG}/*.tsvfor AV-HuBERT AVST training manifests
Models
In the following table, we provide all end-to-end trained models mentioned in our paper:
<table align="center"> <tr> <th>Task</th> <th>Languages</th> <th>Best Checkpoint</th> <th>Dictionary</th> <th>Tokenizer</th> </tr> <tr> <td rowspan="10">AVSR</td> <th>ar</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ar_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ar_avsr/dict.ar.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ar_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>de</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/de_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/de_avsr/dict.de.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/de_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>el</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el_avsr/dict.el.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en_avsr/dict.en.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>es</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/es_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/es_avsr/dict.es.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/es_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>fr</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/fr_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/fr_avsr/dict.fr.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/fr_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>it</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/it_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/it_avsr/dict.it.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/it_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>pt</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/pt_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/pt_avsr/dict.pt.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/pt_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>ru</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ru_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ru_avsr/dict.ru.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/ru_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>ar,de,el,es,fr,it,pt,ru</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/x_avsr/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/x_avsr/dict.x.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/x_avsr/tokenizer.model">tokenizer</a></th> </tr> <tr> <td rowspan="13">AVST</td> <th>en-el</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-el_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-el_avst/dict.el.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-el_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en-es</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-es_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-es_avst/dict.es.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-es_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en-fr</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-fr_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-fr_avst/dict.fr.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-fr_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en-it</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-it_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-it_avst/dict.it.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-it_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en-pt</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-pt_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-pt_avst/dict.pt.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-pt_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>en-ru</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-ru_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-ru_avst/dict.ru.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/en-ru_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>el-en</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el-en_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el-en_avst/dict.en.txt">dict</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/el-en_avst/tokenizer.model">tokenizer</a></th> </tr> <tr> <th>es-en</th> <th><a href="https://dl.fbaipublicfiles.com/muavic/models/es-en_avst/checkpoint_best.pt">best_ckpt.pt</a></th> <th><a href="https://dl.fbaipublicfiles.com/muavic