Skip to main content

Montreal Forced Aligner is a package for aligning speech corpora.

Project description

Montreal Forced Aligner

Continuous Integration codecov Documentation Status Interrogate Status DOI

The Montreal Forced Aligner is a command line utility for performing forced alignment of speech datasets using Kaldi (http://kaldi-asr.org/).

Please see the documentation http://montreal-forced-aligner.readthedocs.io for installation and usage.

If you run into any issues, please check the mailing list for fixes/workarounds or to post a new issue.

Citation

MFA 3.0

For citing the latest version of MFA and its pretrained models, please use:

McAuliffe, Michael, Kaylynn Gunter, Michael Wagner, and Morgan Sonderegger (2026). Montreal Forced Aligner and the state of speech-to-text alignment in 2026. In Proceedings of Interspeech 2026.

@inproceedings{mcauliffe26_interspeech,
 author={McAuliffe, Michael and Gunter, Kaylynn and Wagner, Michael and Sonderegger, Morgan},
 title={{Montreal Forced Aligner and the state of speech-to-text alignment in 2026}},
 year=2026,
 booktitle={Proc. Interspeech 2026}
}

MFA 1.0

For citing the original software and models (upgrading to the MFA 3.X is recommended!), please use:

McAuliffe, Michael, Michaela Socolof, Sarah Mihuc, Michael Wagner, and Morgan Sonderegger (2017). Montreal Forced Aligner: trainable text-speech alignment using Kaldi. In Proceedings of Interspeech 2017.

@inproceedings{mcauliffe17_interspeech,
 author={McAuliffe, Michael and Socolof, Michaela and Mihuc, Sarah and Wagner, Michael and Sonderegger, Morgan},
 title={{Montreal Forced Aligner: Trainable Text-Speech Alignment Using Kaldi}},
 year=2017,
 booktitle={Proc. Interspeech 2017},
 pages={498--502},
 doi={10.21437/Interspeech.2017-1386}
}

Installation

You can install MFA either entirely through conda or a mix of conda for Kaldi and Pynini dependencies and Python packaging for MFA itself

Conda installation

MFA is hosted on conda-forge and can be installed via:

conda install -c conda-forge montreal-forced-aligner

in your environment of choice.

Source installation

If you'd like to install a local version of MFA or want to use the development set up, the easiest way is first create the dev environment from the yaml in the repo root directory:

conda env create -n mfa-dev -f environment.yml

Alternatively, the dependencies can be installed via:

conda install -c conda-forge python=3.11 kaldi librosa praatio tqdm requests colorama pyyaml pynini openfst baumwelch ngram

MFA can be installed in develop mode via:

pip install -e .[dev]

You should be able to see appropriate output from mfa version

Development

The test suite is run via tox -e py38-win or tox -e py38-unix depending on the OS, and the docs are generated via tox -e docs

Quick links

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

montreal_forced_aligner-3.4.1.tar.gz (27.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

montreal_forced_aligner-3.4.1-py3-none-any.whl (443.3 kB view details)

Uploaded Python 3

File details

Details for the file montreal_forced_aligner-3.4.1.tar.gz.

File metadata

  • Download URL: montreal_forced_aligner-3.4.1.tar.gz
  • Upload date:
  • Size: 27.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for montreal_forced_aligner-3.4.1.tar.gz
Algorithm Hash digest
SHA256 8b6f0ec049452b1e1199fb9e171bf23aeccdc04efa4ebd288c16ce9506ef51cd
MD5 822704988c026859bc9c669955d65d5c
BLAKE2b-256 b088819d0756ecb3a2a134e0951e5186d5af3ff76e2d581445bf881bed104672

See more details on using hashes here.

File details

Details for the file montreal_forced_aligner-3.4.1-py3-none-any.whl.

File metadata

File hashes

Hashes for montreal_forced_aligner-3.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 de2e6cc7d607cf8807e8f8263a32e970a7d4ff4fffbb5fe055a6eb5539587964
MD5 432955733e1b0dfcaa4cc5558af37099
BLAKE2b-256 ffab9a4ff08ebc4803f2946fb247fcc252ac0051ae5ae84a0d82b81e46501bee

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page