Introduction
How to clone this repo
sudo apt-get install git-lfs
git clone https://huggingface.co/csukuangfj/icefall-asr-librispeech-transducer-stateless-bpe-500-2022-01-10
cd icefall-asr-librispeech-transducer-stateless-bpe-500-2022-01-10
git lfs pull
Catuion: You have to run git lfs pull
. Otherwise, you will be SAD later.
The model in this repo is trained using the commit 4c1b3665ee6efb935f4dd93a80ff0e154b13efb6
.
You can use
git clone https://github.com/k2-fsa/icefall
cd icefall
git checkout 4c1b3665ee6efb935f4dd93a80ff0e154b13efb6
to download icefall
.
You can find the model information by visiting https://github.com/k2-fsa/icefall/blob/273e5fb2f3ac2620bafdffe2689b8b3ee10173d3/egs/librispeech/ASR/transducer_stateless/train.py#L198.
In short, the encoder is a Conformer model with 8 heads, 12 encoder layers, 512-dim attention, 2048-dim feedforward; the decoder contains a 1024-dim embedding layer and a Conv1d with kernel size 2.
The decoder architecture is modified from Rnn-Transducer with Stateless Prediction Network. A Conv1d layer is placed right after the input embedding layer.
Description
This repo provides pre-trained transducer Conformer model for the LibriSpeech dataset using icefall. There are no RNNs in the decoder. The decoder is stateless and contains only an embedding layer and a Conv1d.
The commands for training are:
cd egs/librispeech/ASR/
./prepare.sh
export CUDA_VISIBLE_DEVICES="0,1,2,3"
./transducer_stateless/train.py \
--world-size 4 \
--num-epochs 76 \
--start-epoch 0 \
--exp-dir transducer_stateless/exp-full \
--full-libri 1 \
--max-duration 250 \
--lr-factor 3
The tensorboard training log can be found at https://tensorboard.dev/experiment/qGdqzHnxS0WJ695OXfZDzA/
The command for decoding is:
epoch=71
avg=15
## greedy search
./transducer_stateless/decode.py \
--epoch $epoch \
--avg $avg \
--exp-dir transducer_stateless/exp-full \
--bpe-model ./data/lang_bpe_500/bpe.model \
--max-duration 100
## beam search
./transducer_stateless/decode.py \
--epoch $epoch \
--avg $avg \
--exp-dir transducer_stateless/exp-full \
--bpe-model ./data/lang_bpe_500/bpe.model \
--max-duration 100 \
--decoding-method beam_search \
--beam-size 4
You can find the decoding log for the above command in this
repo (in the folder log
).
The WERs for the test datasets are
test-clean | test-other | comment | |
---|---|---|---|
greedy search | 2.69 | 6.81 | --epoch 71, --avg 15, --max-duration 100 |
beam search (beam size 4) | 2.68 | 6.72 | --epoch 71, --avg 15, --max-duration 100 |
File description
- log, this directory contains the decoding log and decoding results
- test_wavs, this directory contains wave files for testing the pre-trained model
- data, this directory contains files generated by prepare.sh
- exp, this directory contains only one file:
preprained.pt
exp/pretrained.pt
is generated by the following command:
./transducer_stateless/export.py \
--epoch 71 \
--avg 15 \
--bpe-model data/lang_bpe_500/bpe.model \
--exp-dir transducer_stateless/exp-full
HINT: To use pre-trained.pt
to compute the WER for test-clean and test-other,
just do the following:
cp icefall-asr-librispeech-transducer-stateless-bpe-500-2022-01-10/exp/pretrained.pt \
/path/to/icefall/egs/librispeech/ASR/transducer_stateless/exp/epoch-999.pt
and pass --epoch 999 --avg 1
to transducer_stateless/decode.py
.