NVIDIA/NeMo-text-processing

NVIDIA/NeMo-text-processing

Description: NeMo text processing for ASR and TTS

Language: Python

License: Apache-2.0

Stars: 472

Forks: 170

Open issues: 6

Created: 2022-11-04T20:38:24Z

Pushed: 2026-06-09T22:21:47Z

Default branch: main

Fork: no

Archived: no

README: NeMo Text Processing ==========================

Introduction ------------

nemo-text-processing is a Python package for text normalization and inverse text normalization.

Documentation -------------

NeMo-text-processing (text normalization and inverse text normalization).

Tutorials -----------------

| Google Collab Notebook | Description | | ----------- | ----------- | | Text_(Inverse)_Normalization.ipynb_Normalization.ipynb) | Quick-start guide | | WFST_Tutorial | In-depth tutorial on grammar customization |

Getting help -------------- If you have a question which is not answered in the Github discussions, encounter a bug or have a feature request, please create a Github issue. We also welcome you to directly open a pull request to fix a bug or add a feature.

Installation ------------

Conda virtual environment

We recommend setting up a fresh Conda environment to install NeMo-text-processing.

conda create --name nemo_tn python==3.10
conda activate nemo_tn

(Optional) To use [hybrid text normalization](nemo_text_processing/hybrid/README.md) install PyTorch using their configurator.

conda install pytorch torchvision torchaudio cudatoolkit=11.3 -c pytorch

_NOTE:_ The command used to install PyTorch may depend on your system.

Pip

Use this installation mode if you want the latest released version.

pip install nemo_text_processing

_NOTE:_ This should work on any Linux OS with x86_64. Pip installation on MacOS and Windows are not supported due to the dependency Pynini. On a platform other than Linux x86_64, installing from Pip tries to compile Pynini from scratch, and requires OpenFst headers and libraries to be in the expected place. So if it's working for you, it's because you happen to have installed OpenFst in the right way in the right place. So if you want to Pip install Pynini on MacOS, you have to have pre-compiled and pre-installed OpenFst. The Pynini README for that version should tell you which version it needs and what --enable-foo flags to use. Instead, we recommend you to use conda-forge to install Pynini on MacOS or Windows: conda install -c conda-forge pynini=2.1.6.post1.

Pip from source

Use this installation mode if you want the a version from particular GitHub branch (e.g main).

pip install Cython
python -m pip install git+https://github.com/NVIDIA/NeMo-text-processing.git@{BRANCH}#egg=nemo_text_processing

From source

Use this installation mode if you are contributing to NeMo-text-processing.

git clone https://github.com/NVIDIA/NeMo-text-processing
cd NeMo-text-processing
./reinstall.sh

_NOTE:_ If you only want the toolkit without additional conda-based dependencies, you may replace `reinstall.sh with pip install -e .` with the NeMo-text-processing root directory as your current working director.

Contributing ------------ We welcome community contributions! Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

Citation --------

@inproceedings{zhang21ja_interspeech,
author={Yang Zhang and Evelina Bakhturina and Boris Ginsburg},
title={{NeMo (Inverse) Text Normalization: From Development to Production}},
year=2021,
booktitle={Proc. Interspeech 2021},
pages={4857--4859}
}

@inproceedings{bakhturina22_interspeech,
author={Evelina Bakhturina and Yang Zhang and Boris Ginsburg},
title={{Shallow Fusion of Weighted Finite-State Transducer and Language Model for
Text Normalization}},
year=2022,
booktitle={Proc. Interspeech 2022}
}

License ------- NeMo-text-processing is under [Apache 2.0 license](LICENSE).