{"id":21407,"library":"gruut-lang-en","title":"gruut-lang-en","description":"English language data files for the gruut tokenizer/phonemizer. This package provides English-specific lexicons, pronunciations, and grammar rules. It is a companion to the core gruut library. As of version 2.0.1, it contains data extracted from the main gruut package to allow independent updates. The library follows the release cadence of gruut and is maintained under the Rhasspy project.","status":"active","version":"2.0.1","language":"python","source_language":"en","source_url":"https://github.com/rhasspy/gruut","tags":["gruut","english","phonemizer","tokenizer","text-to-speech"],"install":[{"cmd":"pip install gruut-lang-en","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core library required to use the language data","package":"gruut","optional":false}],"imports":[{"note":"Language data is used implicitly; there is no direct import from gruut-lang-en. The package installs resources that gruut discovers automatically.","wrong":"from gruut_lang_en import ...","symbol":"Data loading","correct":"from gruut import sentences"}],"quickstart":{"code":"import os\nfrom gruut import sentences\n\ntext = \"Hello, world!\"\nfor sentence in sentences(text, lang=\"en-us\"):\n    for word in sentence:\n        print(word.text, word.phonemes)","lang":"python","description":"Tokenize and phonemize English text. Ensure gruut-lang-en is installed for English support. The 'lang' parameter must match an installed language package."},"warnings":[{"fix":"Update code to use 'from gruut import sentences' and call 'sentences(text, lang=\"en-us\")'. For SSML, pass lang=None or adjust stdin format.","message":"In gruut v2.0.0, the API changed significantly: the 'gruut.sentences' function replaces the old 'gruut.tokenize' and 'gruut.phonemize' commands. With --ssml, stdin input is treated as a single SSML document by default; use --stdin-format lines to restore per-line behavior.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Always run 'pip install gruut[en]' or 'pip install gruut-lang-en' alongside gruut.","message":"The English data package is separate: installing gruut alone does not include any language data. You must also install at least one language package (e.g., gruut-lang-en) to process text.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"Replace inline pronunciations with SSML elements.","message":"Inline pronunciations and <number>_<format> tokens were removed in gruut v2.0.0. Use SSML <say-as> or <sub> tags instead.","severity":"deprecated","affected_versions":"<2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run 'pip install gruut-lang-en' to install the English language data.","cause":"The gruut-lang-en package is not installed, so gruut cannot find English data.","error":"No language data found for 'en-us'"},{"fix":"Run 'pip install gruut'.","cause":"The core gruut library is not installed.","error":"ModuleNotFoundError: No module named 'gruut'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}