# Montreal Forced Aligner
[](https://codecov.io/gh/MontrealCorpusTools/Montreal-Forced-Aligner)
[](http://montreal-forced-aligner.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/MontrealCorpusTools/montreal-forced-aligner/)
[](https://zenodo.org/badge/latestdoi/44983969)
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](https://groups.google.com/forum/#!forum/mfa-users) for fixes/workarounds or to post a [new issue](https://github.com/MontrealCorpusTools/Montreal-Forced-Aligner/issues).
## Installation
You can install MFA either entirely through [conda](https://docs.conda.io/en/latest/) or a mix of conda for Kaldi and Pynini dependencies and Python packaging for MFA itself
### Conda installation
MFA is hosted on [conda-forge](https://conda-forge.org/) 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 biopython 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
* [Getting started docs](https://montreal-forced-aligner.readthedocs.io/en/latest/getting_started.html)
* [User Guide](https://montreal-forced-aligner.readthedocs.io/en/latest/user_guide/index.html)
* [API Reference](https://montreal-forced-aligner.readthedocs.io/en/latest/reference/index.html)
* [Release notes](https://montreal-forced-aligner.readthedocs.io/en/latest/changelog/index.html)
* [MFA Models](https://github.com/MontrealCorpusTools/mfa-models)
* [Eleanor Chodroff's MFA tutorial](https://lingmethodshub.github.io/content/tools/mfa/mfa-tutorial/)
* [@mmcauliffe's forced alignment blog posts](https://memcauliffe.com/tag/forced-alignment.html)
Raw data
{
"_id": null,
"home_page": "https://github.com/MontrealCorpusTools/Montreal-Forced-Aligner",
"name": "Montreal-Forced-Aligner",
"maintainer": "Michael McAuliffe",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "michael.e.mcauliffe@gmail.com",
"keywords": "phonology, corpus, phonetics, alignment, segmentation, transcription, g2p, language modeling",
"author": "Montreal Corpus Tools",
"author_email": "michael.e.mcauliffe@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/09/2e/d67b0d166dc84004aa856010ed29c170542a6162433d26e9aff06db069d0/montreal_forced_aligner-3.0.7.tar.gz",
"platform": null,
"description": "# Montreal Forced Aligner\n\n\n[](https://codecov.io/gh/MontrealCorpusTools/Montreal-Forced-Aligner)\n[](http://montreal-forced-aligner.readthedocs.io/en/latest/?badge=latest)\n[](https://github.com/MontrealCorpusTools/montreal-forced-aligner/)\n[](https://zenodo.org/badge/latestdoi/44983969)\n\nThe Montreal Forced Aligner is a command line utility for performing forced alignment of speech datasets using Kaldi (http://kaldi-asr.org/).\n\nPlease see the documentation http://montreal-forced-aligner.readthedocs.io for installation and usage.\n\nIf you run into any issues, please check the [mailing list](https://groups.google.com/forum/#!forum/mfa-users) for fixes/workarounds or to post a [new issue](https://github.com/MontrealCorpusTools/Montreal-Forced-Aligner/issues).\n\n## Installation\n\nYou can install MFA either entirely through [conda](https://docs.conda.io/en/latest/) or a mix of conda for Kaldi and Pynini dependencies and Python packaging for MFA itself\n\n### Conda installation\n\nMFA is hosted on [conda-forge](https://conda-forge.org/) and can be installed via:\n\n```\nconda install -c conda-forge montreal-forced-aligner\n```\n\nin your environment of choice.\n\n### Source installation\n\nIf 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:\n\n```\nconda env create -n mfa-dev -f environment.yml\n```\n\nAlternatively, the dependencies can be installed via:\n\n```\nconda install -c conda-forge python=3.11 kaldi librosa biopython praatio tqdm requests colorama pyyaml pynini openfst baumwelch ngram\n```\n\nMFA can be installed in develop mode via:\n\n```\npip install -e .[dev]\n```\n\nYou should be able to see appropriate output from `mfa version`\n\n#### Development\n\nThe 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`\n\n\n## Quick links\n\n* [Getting started docs](https://montreal-forced-aligner.readthedocs.io/en/latest/getting_started.html)\n* [User Guide](https://montreal-forced-aligner.readthedocs.io/en/latest/user_guide/index.html)\n* [API Reference](https://montreal-forced-aligner.readthedocs.io/en/latest/reference/index.html)\n* [Release notes](https://montreal-forced-aligner.readthedocs.io/en/latest/changelog/index.html)\n* [MFA Models](https://github.com/MontrealCorpusTools/mfa-models)\n* [Eleanor Chodroff's MFA tutorial](https://lingmethodshub.github.io/content/tools/mfa/mfa-tutorial/)\n* [@mmcauliffe's forced alignment blog posts](https://memcauliffe.com/tag/forced-alignment.html)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Montreal Forced Aligner is a package for aligning speech corpora using Kaldi functionality.",
"version": "3.0.7",
"project_urls": {
"Homepage": "https://github.com/MontrealCorpusTools/Montreal-Forced-Aligner"
},
"split_keywords": [
"phonology",
" corpus",
" phonetics",
" alignment",
" segmentation",
" transcription",
" g2p",
" language modeling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "857f8c187d39b6d3fc95bb5079e16465a37c40662672a0c86fa66b41f8111f4b",
"md5": "89941f29187f208d22bee66003178955",
"sha256": "7076bcc59ec43c82ecd54af94377488a7dd13bf8ffc3d5be120f374f5d92927e"
},
"downloads": -1,
"filename": "Montreal_Forced_Aligner-3.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "89941f29187f208d22bee66003178955",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 384904,
"upload_time": "2024-05-03T05:48:13",
"upload_time_iso_8601": "2024-05-03T05:48:13.909325Z",
"url": "https://files.pythonhosted.org/packages/85/7f/8c187d39b6d3fc95bb5079e16465a37c40662672a0c86fa66b41f8111f4b/Montreal_Forced_Aligner-3.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "092ed67b0d166dc84004aa856010ed29c170542a6162433d26e9aff06db069d0",
"md5": "f0d590c5bbd62232807298c704887fc6",
"sha256": "97c5fa30d7a6da72e372d3db540b06c24527d90f093f8ba747387534d518736d"
},
"downloads": -1,
"filename": "montreal_forced_aligner-3.0.7.tar.gz",
"has_sig": false,
"md5_digest": "f0d590c5bbd62232807298c704887fc6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 22217989,
"upload_time": "2024-05-03T05:48:16",
"upload_time_iso_8601": "2024-05-03T05:48:16.590148Z",
"url": "https://files.pythonhosted.org/packages/09/2e/d67b0d166dc84004aa856010ed29c170542a6162433d26e9aff06db069d0/montreal_forced_aligner-3.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-03 05:48:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MontrealCorpusTools",
"github_project": "Montreal-Forced-Aligner",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "praatio",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "tqdm",
"specs": []
},
{
"name": "pyyaml",
"specs": []
},
{
"name": "librosa",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "scikit-learn",
"specs": [
[
"<",
"1.3"
]
]
},
{
"name": "requests",
"specs": []
},
{
"name": "biopython",
"specs": [
[
"==",
"1.79"
]
]
},
{
"name": "dataclassy",
"specs": []
},
{
"name": "sqlalchemy",
"specs": [
[
">=",
"2.0"
]
]
},
{
"name": "click",
"specs": []
},
{
"name": "rich",
"specs": []
},
{
"name": "rich-click",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "pynini",
"specs": []
}
],
"tox": true,
"lcname": "montreal-forced-aligner"
}
JSON
