Update README.md

README.md

@@ -1,3 +1,339 @@
----
-license: cc-by-4.0
----
+---
+license: cc-by-4.0
+datasets:
+- mozilla-foundation/common_voice_11_0
+- openslr/librispeech_asr
+- Europarl-ASR-EN
+- fisher_corpus
+- VoxPopuli-EN
+- National-Singapore-Corpus-Part-1
+- kensho/spgispeech-1000hours
+- Multilingual-LibriSpeech-2000hours
+language:
+- en
+pipeline_tag: automatic-speech-recognition
+library_name: NeMo
+metrics:
+- WER
+- CER
+tags:
+- speech-recognition
+- ASR
+- English
+- Conformer
+- Transducer
+- CTC
+- NeMo
+- speech
+- audio
+model-index:
+- name: stt_en_fastconformer_hybrid_medium_streaming_80ms_pc
+  results:
+  - task:
+      name: Automatic Speech Recognition
+      type: automatic-speech-recognition
+    dataset:
+      name: VoxPopuli
+      split: test
+      type: VoxPopuli
+      args:
+        language: en
+    metrics:
+    - name: Test WER
+      type: wer
+      value: 8.29
+  - task:
+      name: Automatic Speech Recognition
+      type: automatic-speech-recognition
+    dataset:
+      name: librispeech
+      type: openslr/librispeech_asr
+      split: test
+      args:
+        language: en
+    metrics:
+    - name: Test WER
+      type: wer
+      value: 6.96
+  - task:
+      type: Automatic Speech Recognition
+      name: automatic-speech-recognition
+    dataset:
+      name: MLS
+      type: Multilingual-LibriSpeech-2000hours
+      split: test
+      args:
+        language: en
+    metrics:
+    - name: Test WER
+      type: wer
+      value: 11.76
+---
+
+# NVIDIA FastConformer-Hybrid medium streaming (en)
+<style>
+img {
+  display: inline-table;
+  vertical-align: small;
+  margin: 0;
+  padding: 0;
+}
+</style>
+| [![Model architecture](https://img.shields.io/badge/Model_Arch-FastConformer--Transducer_CTC-lightgrey#model-badge)](#model-architecture) 
+| [![Model size](https://img.shields.io/badge/Params-32M-lightgrey#model-badge)](#model-architecture)
+| [![Language](https://img.shields.io/badge/Language-en-lightgrey#model-badge)](#datasets)|
+
+This collection contains medium size versions of cache-aware FastConformer-Hybrid (around 32M parameters) trained on a English speech. The model is trained for streaming ASR with look-ahead of 80ms which be used for very low-latency streaming applications and has two losses: Transducer (default) and CTC.
+See the  section [Model Architecture](#Model-Architecture) and [NeMo documentation](https://docs.nvidia.com/nemo-framework/user-guide/latest/nemotoolkit/asr/models.html#fast-conformer) for complete architecture details.
+
+
+This model is ready for commercial and non-commercial use.
+
+## License
+
+License to use this model is covered by the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/). By downloading the public and release version of the model, you accept the terms and conditions of the [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/) license.
+
+## References
+
+[1] [Fast Conformer with Linearly Scalable Attention for Efficient Speech Recognition](https://arxiv.org/abs/2305.05084)
+
+[2] [Google Sentencepiece Tokenizer](https://github.com/google/sentencepiece)
+
+[3] [NVIDIA NeMo Toolkit](https://github.com/NVIDIA/NeMo)
+
+[4] [HuggingFace ASR Leaderboard](https://huggingface.co/spaces/hf-audio/open_asr_leaderboard)
+
+<!-- ## NVIDIA NeMo: Training
+
+To train, fine-tune or play with the model you will need to install [NVIDIA NeMo](https://github.com/NVIDIA/NeMo).
+We recommend you install it after you've installed latest Pytorch version.
+```
+pip install nemo_toolkit['all']
+``` 
+ -->
+## Model Architecture
+
+
+The model is cache-aware versions of Hybrid FastConfomer which are trained for streaming ASR. You may find more info on cache-aware models here: [Cache-aware Streaming Conformer](https://docs.nvidia.com/deeplearning/nemo/user-guide/docs/en/main/asr/models.html#cache-aware-streaming-conformer) [5].
+FastConformer [1] is an optimized version of the Conformer model with 8x depthwise-separable convolutional downsampling.
+The model is trained in a multitask setup with hybrid Transducer decoder (RNNT) and Connectionist Temporal Classification (CTC) loss.
+You may find more information on the details of FastConformer here: [Fast-Conformer Model](https://docs.nvidia.com/deeplearning/nemo/user-guide/docs/en/main/asr/models.html#fast-conformer).
+
+Model utilizes a [Google Sentencepiece Tokenizer](https://github.com/google/sentencepiece) [2] tokenizer with a vocabulary size of 1024.
+
+### Input
+  - **Input Type:** Audio
+  - **Input Format(s):** .wav files
+  - **Other Properties Related to Input:** 16000 Hz Mono-channel Audio, Pre-Processing Not Needed
+
+### Output
+
+This model provides transcribed speech as a string for a given audio sample.
+  - **Output Type**: Text 
+  - **Output Format:** String
+  - **Output Parameters:** One Dimensional (1D)
+  - **Other Properties Related to Output:** May Need Inverse Text Normalization; Does Not Handle Special Characters; Outputs text in English with punctuation and capitalization.
+
+## Limitations
+
+The model is streaming and can output the speech as a string with punctuation and capitalization.
+Since this model was trained on publicly available speech datasets, the performance of this model might degrade for speech which includes technical terms, or vernacular that the model has not been trained on.
+
+## How to Use this Model
+
+The model is available for use in the NeMo toolkit [3], and can be used as a pre-trained checkpoint for inference or for fine-tuning on another dataset.
+
+### Automatically instantiate the model
+
+```python
+import nemo.collections.asr as nemo_asr
+asr_model = nemo_asr.models.EncDecHybridRNNTCTCBPEModel.from_pretrained(model_name="nvidia/stt_en_fastconformer_hybrid_medium_streaming_80ms_pc")
+```
+### Transcribing using Python
+First, let's get a sample
+```
+wget https://dldata-public.s3.us-east-2.amazonaws.com/2086-149220-0033.wav
+```
+Then simply do:
+```
+asr_model.transcribe(['2086-149220-0033.wav'])
+```
+
+### Transcribing many audio files
+
+Using Transducer mode inference:
+```shell
+python [NEMO_GIT_FOLDER]/examples/asr/transcribe_speech.py 
+ pretrained_name="nvidia/stt_en_fastconformer_hybrid_medium_streaming_80ms_pc" 
+ audio_dir="<DIRECTORY CONTAINING AUDIO FILES>"
+```
+
+Using CTC mode inference:
+```shell
+python [NEMO_GIT_FOLDER]/examples/asr/transcribe_speech.py 
+ pretrained_name="nvidia/stt_en_fastconformer_hybrid_medium_streaming_80ms_pc" 
+ audio_dir="<DIRECTORY CONTAINING AUDIO FILES>"
+ decoder_type="ctc"
+``` 
+
+## Training
+
+The [NVIDIA NeMo Toolkit] [3] was used for training the model for two hundred epochs.
+Model is trained with this [example script](https://github.com/NVIDIA/NeMo/blob/main/examples/asr/asr_hybrid_transducer_ctc/speech_to_text_hybrid_rnnt_ctc_bpe.py).
+
+The tokenizer for these model was built using the text transcripts of the train set with this [script](https://github.com/NVIDIA/NeMo/blob/main/scripts/tokenizers/process_asr_text_tokenizer.py).
+
+## Training, Testing, and Evaluation Datasets
+### Training Datasets
+The model is trained on composite dataset comprising of around 8500 hours of English speech:
+
+- [Librispeech](https://www.openslr.org/12)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Mozilla Common Voice 11.0 English](https://commonvoice.mozilla.org/en/datasets)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Europarl](https://www.statmt.org/europarl/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Fisher](https://catalog.ldc.upenn.edu/LDC2004S13)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [MLS](https://www.openslr.org/94/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Voxpopuli](https://github.com/facebookresearch/voxpopuli)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [SPGI-1000hours](https://datasets.kensho.com/datasets/spgispeech)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+
+### Evaluation Datasets
+- [Librispeech](https://www.openslr.org/12)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Mozilla Common Voice 11.0 English](https://commonvoice.mozilla.org/en/datasets)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Europarl](https://www.statmt.org/europarl/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Fisher](https://catalog.ldc.upenn.edu/LDC2004S13)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [MLS](https://www.openslr.org/94/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Voxpopuli](https://github.com/facebookresearch/voxpopuli)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [SPGI-1000hours](https://datasets.kensho.com/datasets/spgispeech)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+### Test Datasets
+- [Europarl](https://www.statmt.org/europarl/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [MLS](https://www.openslr.org/94/)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Voxpopuli](https://github.com/facebookresearch/voxpopuli)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+- [Librispeech](https://www.openslr.org/12)
+    - Data Collection Method: by Human
+    - Labeling Method: by Human
+## Software Integration
+
+### Supported Hardware Microarchitecture Compatibility:
+- NVIDIA Ampere
+- NVIDIA Blackwell
+- NVIDIA Jetson
+- NVIDIA Hopper
+- NVIDIA Lovelace
+- NVIDIA Pascal
+- NVIDIA Turing
+- NVIDIA Volta
+
+### Runtime Engine
+- Nemo 2.0.0
+  
+### Preferred Operating System
+- Linux
+
+## Ethical Considerations
+NVIDIA believes Trustworthy AI is a shared responsibility and we have established policies and practices to enable development for a wide array of AI applications.
+When downloaded or used in accordance with our terms of service, developers should work with their internal model team to ensure this model meets requirements for the relevant industry and use case and addresses unforeseen product misuse.
+
+<!-- For more detailed information on ethical considerations for this model, please see the [Model Card++](https://docs.google.com/document/d/1cFbfEnlbBG_I5hTRiYuZAI1PgdPYRfsmXpE5-zJDdXU/edit?tab=t.0#heading=h.7jylogfmrbiw) Explainability, Bias, Safety & Security, and Privacy Subcards. -->
+
+Please report security vulnerabilities or NVIDIA AI Concerns [here](https://www.nvidia.com/en-us/support/submit-security-vulnerability/).
+
+## Explainability
+
+- High-Level Application and Domain: Automatic Speech Recognition
+-   - Describe how this model works: The model transcribes audio input into text for the English language
+- Verified to have met prescribed quality standards: Yes
+- Performance Metrics: Word Error Rate (WER), Character Error Rate (CER), Real-Time Factor
+- Potential Known Risks: Transcripts may not be 100% accurate. Accuracy varies based on the characteristics of input audio (Domain, Use Case, Accent, Noise, Speech Type, Context of speech, etcetera).
+  
+### Performance
+
+**Test Hardware:** A100 GPU
+
+The performance of Automatic Speech Recognition models is measured using Word Error Rate (WER) and Char Error Rate (CER).
+Since this dataset is trained on multiple domains, it will generally perform well at transcribing audio in general.
+
+The following tables summarize the performance of the available models in this collection with the Transducer decoder.
+Performances of the ASR models are reported in terms of Word Error Rate (WER%) and Inverse Real-Time Factor (RTFx) with greedy decoding on test sets. 
+
+- Transducer
+|**Version**|**Tokenizer**|**Vocabulary Size**|**Librispeech Test WER**|**Librispeech Test RTFx**|**Europarl test WER**|**Europarl test RTFx**|**Voxpopuli test WER**|**Voxpopuli test RTFx**|**MLS test WER**|**MLS test RTFx**
+|----------|-------------|-------------------|----------------|----------------|----------------|----------------|----------------|----------------|----------------|----------------|
+| 2.0.0  | SentencePiece Unigram | 1024 | 6.96 | ~1600 | 11.85| ~1100 | 8.29 | 1780 | 11.76 | ~2050 |
+
+
+
+These results is of a model trained with punctuation and capitalization and evaluated without punctuation and capitalization
+## Bias
+- Was the model trained with a specific accent? No
+- Have any special measures been taken to mitigate unwanted bias? No
+- Participation considerations from adversely impacted groups [protected classes]
+(https://www.senate.ca.gov/content/protected-classes) in model design and testing: No
+
+## Privacy 
+- Generatable or reverse engineerable personal data? No
+- If applicable, was a notice provided to the individuals prior to the collection of any personal data used? Not applicable
+- If personal data was collected for the development of the model, was it collected directly by NVIDIA? Not applicable
+- Is there dataset provenance? Yes
+- If data is labeled, was it reviewed to comply with privacy laws? Yes
+- Is data compliant with data subject requests for data correction or removal, if such a request was made? No, not possible with externally-sourced data
+- Is a mechanism in place to honor data subject rights of access or deletion of personal data? No 
+- How often is the training dataset reviewed?: Before Release
+
+## Safety & Security
+### Use Case Restrictions:
+
+- Streaming ASR model
+- Model outputs text in English
+- Output text requires Inverse Text Normalization
+- Model is noise-sensitive
+ 
+
+Model is not applicable for life-critical applications.
+
+### Access Reactions:
+The Principle of Least Privilege (PoLP) is applied limiting access for dataset generation and model development. Restrictions enforce dataset access during training and dataset license constraints adhered to.
+
+## NVIDIA Riva: Deployment
+
+[NVIDIA Riva](https://developer.nvidia.com/riva) is an accelerated speech AI SDK deployable on-prem, in all clouds, multi-cloud, hybrid, on edge, and embedded.
+Additionally, Riva provides: 
+
+* World-class out-of-the-box accuracy for the most common languages with model checkpoints trained on proprietary data with hundreds of thousands of GPU-compute hours 
+* Best in class accuracy with run-time word boosting (e.g., brand and product names) and customization of acoustic model, language model, and inverse text normalization 
+* Streaming speech recognition, Kubernetes compatible scaling, and enterprise-grade support 
+
+Although this model isn’t supported yet by Riva, the [list of supported models is here](https://huggingface.co/models?other=Riva).  
+Check out [Riva live demo](https://developer.nvidia.com/riva#demos).