gruut
A tokenizer, text cleaner, and phonemizer for many human languages.
Decision gist · record as of 2026-08-14
Yes, if you need multilingual IPA phonemization and text normalization for a speech pipeline and can tolerate an archived codebase. The high install friction (12 dependencies) and abandoned maintenance status mean it is best suited for stable, non-evolving use cases. Not recommended for new projects requiring active support or ongoing language additions.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.6 or higher; language support beyond English requires additional language packages or manual language file installation in $XDG_CONFIG_HOME/gruut/.
- High install friction due to 12 runtime dependencies including numpy, python-crfsuite, and language-specific packages.
- The project is archived and abandoned as of the latest commit; no active maintenance.
License · maintenance · safety
permissive license (permissive) — MIT license permits commercial and private use with minimal restrictions, typical for permissive open-source projects.
last release 2024-07-03 (772 days) · last repo commit 2024-11-15 · 331 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 101,860 downloads/mo, #12,909 on PyPI
Alternatives
Verify before relying
pip install gruut
from gruut import sentences
text = 'He wound it around the wound.'
for sent in sentences(text, lang="en-us"):
for word in sent:
if word.phonemes:
print(word.text, *word.phonemes)- Whether the archived repository will receive security updates or bug fixes if issues arise.
- Performance characteristics with large text volumes or real-time processing demands.
- Compatibility with Python versions beyond 3.9 (classifiers list stops at 3.9).
- How many languages are currently supported and whether that list is maintained.
What it is and what it does
Gruut is a multilingual text processing pipeline that breaks text into sentences and words, assigns part-of-speech tags, and generates IPA phoneme sequences for each word. It handles context-dependent pronunciation (e.g., 'read' as past vs. present tense) and supports SSML markup for mixed-language input. The package also automatically expands abbreviations, numbers, dates, currency, and times into spoken forms, respecting locale conventions—so "1/1/2020" is parsed as month-first or day-first depending on the text's declared language.
Gruut is primarily designed for speech synthesis pipelines and voice applications that need clean, phonetically annotated text. It bundles language-specific models for part-of-speech tagging and grapheme-to-phoneme conversion, and relies on external libraries like Babel, num2words, and python-crfsuite for linguistic analysis. The project is archived and no longer actively maintained, though it remains functional for its supported languages.
Use it for
- Preprocessing text for text-to-speech systems that require phoneme-level control and multilingual support.
- Extracting structured phonetic data from raw text for linguistic research or speech recognition training.
- Normalizing and cleaning user input in voice assistant pipelines before synthesis.
- Converting mixed-language SSML documents into phonetically annotated word sequences.
- Expanding numeric and temporal expressions into natural language for audio output.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need multilingual IPA phonemization and text normalization for a speech pipeline and can tolerate an archived codebase.
The high install friction (12 dependencies) and abandoned maintenance status mean it is best suited for stable, non-evolving use cases. Not recommended for new projects requiring active support or ongoing language additions.
Install
gruut on PyPI
Before you install
High install friction due to 12 runtime dependencies including numpy, python-crfsuite, and language-specific packages. The project is archived and abandoned as of the latest commit; no active maintenance.
Requires Python 3.6 or higher; language support beyond English requires additional language packages or manual language file installation in $XDG_CONFIG_HOME/gruut/.
License in practice
MIT license permits commercial and private use with minimal restrictions, typical for permissive open-source projects.
Quickstart
pip install gruut
from gruut import sentences
text = 'He wound it around the wound.'
for sent in sentences(text, lang="en-us"):
for word in sent:
if word.phonemes:
print(word.text, *word.phonemes)Verify before relying
- Whether the archived repository will receive security updates or bug fixes if issues arise.
- Performance characteristics with large text volumes or real-time processing demands.
- Compatibility with Python versions beyond 3.9 (classifiers list stops at 3.9).
- How many languages are currently supported and whether that list is maintained.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | High. Source build required |
| Runtime dependencies | 12 packagesBabeldateparsergruut-ipagruut_lang_enjsonlinesnetworkxnum2wordsnumpypython-crfsuitedataclassestypes-dataclassesimportlib_resources |
| Maintenance | Abandoned 772 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 101,860 / month, #12,909 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: gruut-2.4.0.tar.gz
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “text tokenization and phonemization”
- gruutGruut tokenizes, cleans, and converts text to IPA phonemes for…
- misakiConverts written text to phonetic representations…
- phonemizer-forkConverts text to phonetic representations (phones) in multiple…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also gruut-lang-en · gruut-ipa · phonemizer-fork · phonemizer · misaki · sea-g2p · tokenizer · g2p-en · orthography2ipa · unicode-segmentation-rs