# 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/8e/f5/069369117de29392ba398e0a28c9444ad39246f2c81394c293b926b6ccc8/montreal_forced_aligner-3.2.0.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.2.0",
"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": "ba003ad878dfd569452bd06a21348c3c051aae24e64e116bd5c9441175b71d3b",
"md5": "6b4479bfd66eb7c59f2d81c491e2571f",
"sha256": "91bed9ad34fd24e667d49f3fcad16c7b0c164fc84b1a3f64a90166ef522974b5"
},
"downloads": -1,
"filename": "Montreal_Forced_Aligner-3.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b4479bfd66eb7c59f2d81c491e2571f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 406548,
"upload_time": "2024-10-01T01:31:27",
"upload_time_iso_8601": "2024-10-01T01:31:27.129215Z",
"url": "https://files.pythonhosted.org/packages/ba/00/3ad878dfd569452bd06a21348c3c051aae24e64e116bd5c9441175b71d3b/Montreal_Forced_Aligner-3.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8ef5069369117de29392ba398e0a28c9444ad39246f2c81394c293b926b6ccc8",
"md5": "c33d74e1886de217d69a83a0570116d9",
"sha256": "1cfff274cbdb7bf29070a9f3b4e322704623bf0e76dfe85d58e3655501a6e5af"
},
"downloads": -1,
"filename": "montreal_forced_aligner-3.2.0.tar.gz",
"has_sig": false,
"md5_digest": "c33d74e1886de217d69a83a0570116d9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 25620416,
"upload_time": "2024-10-01T01:31:29",
"upload_time_iso_8601": "2024-10-01T01:31:29.390267Z",
"url": "https://files.pythonhosted.org/packages/8e/f5/069369117de29392ba398e0a28c9444ad39246f2c81394c293b926b6ccc8/montreal_forced_aligner-3.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-01 01:31:29",
"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
