| --- |
| language: |
| - th |
| pipeline_tag: other |
| library_name: montreal-forced-aligner |
| tags: |
| - montreal-forced-aligner |
| - forced-alignment |
| license: cc-by-4.0 |
| --- |
| # Model Card for thai_mfa |
| |
| <!-- Provide a quick summary of what the model is/does. --> |
| |
| This MFA model is for aligning Thai speech. |
| |
| - [Model details](#model-details) |
| - [Uses](#uses) |
| - [Performance Factors](#how-to-get-started-with-the-model) |
| - [Dictionary Details](#dictionary-details) |
| - [Training Details](#training-details) |
| - [Evaluation](#evaluation) |
| - [Contact](#contact) |
| |
| ## Model Details |
| |
| ### Model Description |
| |
| <!-- Provide a longer summary of what this model is. --> |
| |
| |
| |
| - **Developed by:** Michael McAuliffe |
| - **Funded by:** N/A |
| - **Model type:** Montreal Forced Aligner model |
| - **Language(s) (NLP):** Thai |
| - **License:** cc-by-4.0 |
| |
| ## Uses |
| |
| <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. --> |
| |
| ### Direct Use |
| |
| <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. --> |
| |
| This model is intended to be used for forced alignment of Thai speech. Please see https://montreal-forced-aligner.readthedocs.io/en/latest/user_guide/troubleshooting.html for details on common fixes. |
|
|
| ### Out-of-Scope Use |
|
|
| <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. --> |
|
|
| This model cannot provide accurate assessments of goodness of pronunciations or provide transcripts as it is trained to be accepting of variation in pronunciation to provide a reasonable alignment for Thai speech. |
|
|
| ## Bias, Risks, and Limitations |
|
|
| <!-- This section is meant to convey both technical and sociotechnical limitations. --> |
|
|
| This model will perform best on the variety of speech that it was trained on. The speakers in the training data are all adult speakers, so child speech alignment may not be accurate. |
|
|
| ### Recommendations |
|
|
| <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. --> |
|
|
| When using this model on a variety that it was not trained on, better results can be attained by adapting the model to the data to be aligned first. See https://montreal-forced-aligner.readthedocs.io/en/latest/user_guide/workflows/adapt_acoustic_model.html and https://github.com/mmcauliffe/mfa-adaptation for example usage and scripts. |
| |
| ## How to Get Started with the Model |
| |
| Use the code below to get started with the model. |
| |
| To get started, follow the instructions for [installing MFA](https://montreal-forced-aligner.readthedocs.io/en/latest/getting_started.html). To align files using this model, use the [mfa align](https://montreal-forced-aligner.readthedocs.io/en/latest/user_guide/workflows/alignment.html) command. |
| |
| ## Dictionary Details |
| |
| #### Details for thai_mfa dictionary and G2P model |
|
|
| - **Source:** wikipron |
| - **Orthography:** Latin |
| - **Phone set:** MFA |
| - **Words:** 53,840 |
| * **Phones:** 45 |
| * **Graphemes:** 107 |
|
|
| ##### IPA chart |
|
|
| ###### Consonants |
|
|
| | Manner | Labial | Labiodental | Alveolar | Palatal | Velar | Glottal | |
| | :----: | :----: | :----: | :----: | :----: | :----: | :----: | |
| | **Nasal** | m | | n | | ŋ | | |
| | **Stop** | p b | | t d | | k | ʔ| |
| | Aspirated | pʰ | | tʰ | | kʰ | | |
| | Unreleased | p̚ | | t̚ | | k̚ | | |
| | **Affricate** | | | | tɕ | | | |
| | Aspirated | | | | tɕʰ | | | |
| | **Sibilant** | | | s | | | | |
| | **Fricative** | | f | | | | h| |
| | **Approximant** | w | | | j | | | |
| | **Trill** | | | r | | | | |
| | **Lateral** | | | l | | | | |
|
|
| ###### Vowels |
|
|
| | | Front | Near-Front | Central | Near-Back | Back | |
| | :----: | :----: | :----: | :----: | :----: | :----: | |
| | **Close** | i iː | | | | ɯ ɯː u uː| |
| | | | | | | | |
| | **Close-Mid** | e eː | | | | ɤ ɤː o oː| |
| | | | | | | | |
| | **Open-Mid** | ɛ ɛː | | | | ɔ ɔː| |
| | | | | | | | |
| | **Open** | | | a aː | | | |
|
|
| ##### Diphthongs |
| * ua |
| * ia |
| * ɯa |
|
|
|
|
| ## Training Details |
|
|
| ### Training Data |
|
|
| <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. --> |
|
|
| #### Common Voice Thai |
|
|
| - **Source:** https://voice.mozilla.org/en/datasets |
| - **License:** [CC-0](https://creativecommons.org/publicdomain/zero/1.0/) |
| - **Dialects:** N/A |
| - **Number of hours:** 167.39 |
| - **Number of utterances:** 139,753 |
| - **Number of speakers:** 6,385 |
| - **Female speakers:** 245 |
| - **Male speakers:** 328 |
| - **Unknown speakers:** 5,812 |
|
|
|
|
| #### GlobalPhone Thai |
|
|
| - **Source:** https://catalogue.elra.info/en-us/repository/browse/ELRA-S0321/ |
| - **License:** [ELRA](https://www.elra.info/en/services-around-lrs/distribution/licensing/) |
| - **Dialects:** N/A |
| - **Number of hours:** 28.17 |
| - **Number of utterances:** 14,039 |
| - **Number of speakers:** 98 |
| - **Female speakers:** 65 |
| - **Male speakers:** 27 |
| - **Unknown speakers:** 6 |
|
|
|
|
| #### Gowajee Corpus |
|
|
| - **Source:** https://github.com/ekapolc/gowajee_corpus?tab=readme-ov-file |
| - **License:** [MIT](https://opensource.org/licenses/MIT) |
| - **Dialects:** N/A |
| - **Number of hours:** 17.19 |
| - **Number of utterances:** 20,307 |
| - **Number of speakers:** 188 |
| - **Female speakers:** 25 |
| - **Male speakers:** 163 |
| - **Unknown speakers:** 0 |
| |
| |
| #### Lotus Corpus |
| |
| - **Source:** https://github.com/korakot/corpus/releases/tag/v1.0 |
| - **License:** [CC BY-SA-NC 3.0](https://creativecommons.org/licenses/by-nc-sa/3.0/) |
| - **Dialects:** N/A |
| - **Number of hours:** 5.92 |
| - **Number of utterances:** 3,360 |
| - **Number of speakers:** 96 |
| - **Female speakers:** 48 |
| - **Male speakers:** 48 |
| - **Unknown speakers:** 0 |
| |
| |
| #### Thai Elderly Speech dataset by Data Wow and VISAI |
| |
| - **Source:** https://github.com/VISAI-DATAWOW/Thai-Elderly-Speech-dataset/releases/tag/v1.0.0 |
| - **License:** [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) |
| - **Dialects:** N/A |
| - **Number of hours:** 26.56 |
| - **Number of utterances:** 19,200 |
| - **Number of speakers:** 32 |
| - **Female speakers:** 22 |
| - **Male speakers:** 10 |
| - **Unknown speakers:** 0 |
| |
| |
| ### Training Procedure |
| |
| <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. --> |
| |
| #### Preprocessing |
| |
| Preprocessing include fixes and orthographic standardization to various corpora. |
| |
| |
| #### Training Hyperparameters |
| |
| - **Training regime:** [Training configuration](config.yaml) |
| |
| ## Evaluation |
| |
| <!-- This section describes the evaluation protocols and provides the results. --> |
| |
| ### Testing Data, Factors & Metrics |
| |
| #### Testing Data |
| |
| <!-- This should link to a Dataset Card if possible. --> |
| |
| N/A |
| |
| #### Factors |
| |
| <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. --> |
| |
| N/A |
| |
| #### Metrics |
| |
| <!-- These are the evaluation metrics being used, ideally with a description of why. --> |
| |
| N/A |
| |
| ### Results |
| |
| N/A |
| |
| #### Summary |
| |
| |
| |
| ## Technical Specifications |
| |
| ### Model Architecture and Objective |
| |
| HMM-GMM model |
| |
| #### Software |
| |
| This model was trained via the [Montreal Forced Aligner](https://montreal-forced-aligner.readthedocs.io/). |
| |
| ## Citation |
| |
| <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. --> |
| |
| **BibTeX:** |
| |
| ``` |
| @techreport{mfa_thai_mfa_acoustic_2026, |
| author={McAuliffe, Michael and Sonderegger, Morgan}, |
| title={Thai MFA acoustic model v3.3.0}, |
| address={\url{https://huggingface.co/MontrealCorpusTools/thai_mfa}}, |
| year={2026}, |
| month={Jun}, |
| } |
| ``` |
| |
| **APA:** |
|
|
| ``` |
| McAuliffe, M. & Sonderegger, M. (2026). Thai MFA acoustic model v3.3.0. Available at https://huggingface.co/MontrealCorpusTools/thai_mfa. |
| ``` |
|
|
| ## Contact |
|
|
| For questions and issues, please file an issue either for this model at https://huggingface.co/MontrealCorpusTools/thai_mfa/discussions or for larger MFA issues at https://github.com/MontrealCorpusTools/Montreal-Forced-Aligner/issues. |
