This repo create ASR system by using toolkits PLUS own implementations.
Toolkits used:
TIP : If you want to just use the scripts( text_cleaning / data_collecting/ create final dataset csv files) simply use requirements.txt to install important dependencies.
pip3 install requirements.txt
You need to know about RNNs, Attention mechanism, CTC, a little pandas/numpy, Tensorflow, KERAS and NLP Stuff(e.g. transformers, text cleaning etc. ). Also knowing about Spectrograms, MFCC, Filter Bank will help you to understand preprocess of audios.
if you don't know any of these stuff you can check Wiki page there are many links
| model Name | DataSet | Loss |
|---|---|---|
| our own implementations : (first try) | common_voice_en (400h) | 74 ( So bad results / many models tested. ) |
| Deep Speech 1 : Mozilla (first try) | common_voice + tv programms + radio programs (totally 300h) | 28 |
| Deep Speech 1 : Mozilla (second try) | common_voice + tv programms + radio programs (totally 300h) | 25 |
| Deep Speech 1 : Mozilla + Transfer Learning (third try) | common_voice + tv programms + radio programs (totally 300h) | 24 |
| Deep Speech 1 : Mozilla + Transfer Learning (third try) | common_voice + tv programms + radio programs (totally +1000h) | 22 |
there are many public datasets for English. But for persian there is not enough and free STT dataset.So we created our own data crawler for collecting data.
common voice dataset is a rich free dataset.
in this repo there is 1 folders:
- crawler
crawler : this folder has one script. the script will crawl in radio archive and collect the data we need. you can edit this crawler to download other websites too. [More info Check README file in crawler folder]
Here in Hamtech Company, we decided to open source our ASR dataset. This Dataset is near 200Gb of voice plus CSV file which includes the transcription(some files contain txt file not csv). you can find a column named Confidence_level, this means how much the transcription is reliable, here is the, you can use LM(language models) or any other idea to clean them or any other ideas. . In conclusion :
- You may use some techniques ( like using LMs, using annotator, etc. ) to clean more the transcription
- you can use the confidence_level column in the CSV file to select more accurate rows.
- wav files are nearly 200Gb.
- voices format is : format : Wav / channels : mono/ sample_rate : 16000 Hz/
Note : 9 Gb of data is lost. :(
Links :
Version 1 data content is like : WavFile+TxtFile | Version 2 data content is like : ZipFile+CsvFile
- Dataset_part_1_v1 : https://drive.google.com/drive/folders/1jdR4joj1BsU_LYHXriUW0xT4tgXicaqv?usp=share_link
- Dataset_part_2_v1 : https://drive.google.com/drive/folders/1tVOrcwpxVcfrON5t9rdFSLZ5LNwJuCrV?usp=share_link
- Dataset_part_3_v1 : https://drive.google.com/drive/folders/1FWY3MTrpMF-WrqFbMSM-fNmLn0FiUoNx?usp=share_link
- Dataset_part_4_v1 : Data is lost :( ( this part of data was 9.7 Gb of zipped wav/txt files )
- Dataset_part_1_v2 : https://drive.google.com/drive/folders/1ZsTMb_V-UAXxxi-wRE-g4hXXntonA_P3?usp=share_link
- Dataset_part_2_v2 : https://drive.google.com/drive/folders/1eAPjF_DVU9j4nQ8S0aWQTbCbTI5sBrYp?usp=share_link
- Dataset_part_3_v2 : https://drive.google.com/drive/folders/1rMNYwKtkyz8tprhwErrcDT-TLKtWA0OB?usp=share_link
- Dataset_part_4_v2 : https://drive.google.com/drive/folders/1Lxq8ouA6UWEOkHfNjxJ7Kf5k51D5t2V8?usp=share_link
NOTE : if you need more tips dont hesitate to email me : masoudparpanchi@gmail.com
Here in Hamtech Company, we decided to open source a challenging part of our ASR dataset. This Dataset is near 30 Hours of voice plus CSV file which includes the transcription. you can find a column named Confidence_level, this means how much the transcription is reliable, here is the, you can use LM(language models) or any other idea to clean them or any other ideas. The variety of speakers in this dataset is not so much But the quality of voices is good enough. Check Dataset Folder in this repo. In conclusion :
- Dataset is near 30H
- Transcriptions are not an exact match.
- Variety of speakers in this dataset is not so much
- You may use some techniques ( like using LMs, using annotator, etc. ) to clean more the transcription
- you can use the confidence_level column in the CSV file to select more accurate rows.
- wav files are nearly 2Gb.
- voices format is : format : Wav / channels : mono/ sample_rate : 16000 Hz/
- Google drive dataset URL is https://drive.google.com/drive/folders/1BLOYLBOUSWI50k4RTnpTc7Ni4rYxjVi2?usp=sharing
- to download just the CSV file check Dataset folder in this repo or the google drive link
Last checkpoint of trained Speech to text ( These are not ready to use for commercial usecases. only a finetuned model for you, to use it in your own project :
- Mozzila deepspeech checkpoints ( WARNING : Check experiments log for hyperparametrs when you want to finetune using these checkpoints ) : https://drive.google.com/drive/folders/1FyLFudV_o71WeBQEQIn_-GficBpEMIzM?usp=share_link
- pb format of checkpoint : https://drive.google.com/file/d/1RhISAEUwG9MwkLIFyrb1sIFi4UhNTKL6/view?usp=share_link
To use this toolkit you must first do what this link says or follow short Installation blow.
Currently we are using DeepSpeech V0.9.3
- Clone and create virtual enviroments
git clone --branch v0.9.3 https://github.com/mozilla/DeepSpeech
cd DeepSpeech
pip3 install --upgrade pip==20.2.2 wheel==0.34.2 setuptools==49.6.0
pip3 install --upgrade -e .
pip install tensorflow-gpu==1.15.4
After cloning and install dependecies you need common voice dataset. Download the proper language and then preprocessing. all the steps for preprocess common voice dataset is documented in here too.
- Start training from scratch ( no pretrained model)
python3 DeepSpeech.py --train_files ../data/CV/en/clips/train.csv --dev_files \
../data/CV/en/clips/dev.csv --test_files ../data/CV/en/clips/test.csv
if you want to create your own dataset you need these TIPS :
- all your audio files must be in wav format
- your audios must be in : 16khz / 16bitpersample / mono / no noise ( optional )
- don't use more than 30 minutes of audio files recorded by one person
- at least you must have 300h of data.
- you need a csv file for all the audio files you have. you can see the structure of csv file after you preprocessed the common voice files by import_cv2.py( this python file is in Deepspeech repo. you'll have it after cloning)
- and also you need to clean your transcripts (Some more NLP task :) ).
- (optional) if you want to use my crawler to create dataset you can check crawler.py (in crawler folder ) and parallel.py(in data_collector folder) file.
- (optional) if you want to use my transcription desktop application you can check ciacada repository
- ( optional ) you can use my scripts to clean transcripts and make final csv file. they are available in github
- don't worry about creating spectrogram/FastFourier/MFCC/Filterbank , Mozilla will do it all for you.
- TODO : need to remember more tips.
you need language model for testing the model. the language model is trained on Kenlm
the steps to train language model is here
text file size : 2GB
test file to optimize : 20M
kenlm checkpoint link (This checkpoint is just a toy language model. trained on 2.5 Gb of Persian txt but not deep optimization ): https://drive.google.com/file/d/1IGL_SXNQdYINWEP93JnbAw1NjxtmZ-Hw/view?usp=share_link
txt dataset to train kenlm can be found here ( you can find near 80 Gb of Persian txt there ): https://nlpdataset.ir/farsi/raw_text_corpora.html
after all these steps it means you have your dataset ready and you want to train . if you want to train on English there is no more steps BUT if you are in another language ( like Persian ) you need to check transfer learning part of this link TIP : don't forget to change alphabete.txt
Question : can I use Other languages checkpoints to start transfer learning? Sure, do it. But remember to drop weights of last N layers.
you may need the meaning of flags to use all the abilities of mozilla deep speech. check their Documentation
Tip : if you faced with CUDA/CudNN errors. try to use conda and install proper versions.
Last checkpoint of trained Speech to text ( These are not ready to use for commercial usecases. only a finetuned model for you, to use it in your own project : - Mozzila deepspeech checkpoints ( WARNING : Check experiments log for hyperparametrs when you want to finetune using these checkpoints ) : https://drive.google.com/drive/folders/1FyLFudV_o71WeBQEQIn_-GficBpEMIzM?usp=share_link - pb format of checkpoint : https://drive.google.com/file/d/1RhISAEUwG9MwkLIFyrb1sIFi4UhNTKL6/view?usp=share_link
using TensorSpeech Link to repository their repo is really complete and you can pass their steps to train a model but I will say some tips :
- to change any option you need to change config.yml file
- Remember to change alphabetes. you need to change the vocabulary in config.yml file
- the dataset in this repo is a little different. you must have tsv file. and columns hav different names and values
- (optional) to prepare your own dataset for this approach you can use my script. it is available in github
using facebook fairseq toolkit
this checkpoint of wav2vec2 is trained on 30 Gb of Speech dataset( all data with 90percent and higher confidence ): https://drive.google.com/file/d/1DX4R3wyjDiDyQ6-0EKv_0P3WV_co13H6/view?usp=share_link
Some libraries you need to install. I'll list them here ( These are the most important ) :
- ffmpeg
- pydub
- python_speech_features
- numpy V1.18.1
- pandas V1.0.1
- tensorflow V2.1.0
- sklearn V0.22.2.post1
- librosa V0.7.2
In next line I'll show how to install three of them ( I used these commands to install in Kaggle Notebooks too.)
pip install pydub
pip install python_speech_features
!apt-get install -y ffmpeg
the codes are developed to use commonvoice data. make sure your data are in that format.
All experiments and all hyperparameters : https://drive.google.com/file/d/1h7DhMsS_AGAguKypI_jhjv3JNT2Naemq/view?usp=share_link
Visit our wiki page for more info about Tutorials, useful Links, Hardware Info, Result and other things.
If you want to help us for better models and new approaches, please contact us, we will be happy
Email : masoudparpanchi@gmail.com
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}