textstat
github.com
- Free plan
- Linux
- Self-hosted
What textstat is
textstat is a free, open-source Python library for measuring readability, text complexity, and grade level. It calculates scores such as Flesch Reading Ease, Flesch-Kincaid Grade, SMOG, Coleman-Liau, ARI, Dale-Chall, and Gunning Fog. The text_standard function combines multiple readability tests to estimate the school grade level needed to understand a passage. Other functions count words, sentences, characters, letters, syllables, polysyllabic words, and monosyllabic words, and estimate reading time. English is the default language; the project also lists language variants for some formulas and specific measures for Spanish, Arabic, Italian, and German. Installation options include pip, Poetry, Pipenv, pipx, or GitHub source, and pipx can install it as a standalone command-line tool. The package uses the MIT license and requires Python >=3.6. Its documentation notes that SMOG is statistically invalid for texts under 30 sentences even though the library returns a result from three sentences. For Spanish, Gutiérrez de Polini scores are unreliable for complex text, while Crawford is valid only for elementary-school-level texts.
Who it suits
textstat suits developers, educators, and science or research users who want to calculate readability and text statistics in Python. It accepts text input and can also be installed as a command-line tool through pipx.
Good to know, and what to watch
- Free Python package distributed under the MIT license.
- Provides several readability formulas and a combined grade estimate.
- Counts words, sentences, characters, letters, and syllables.
- Includes specific measures for Spanish, Arabic, Italian, and German.
- Can be installed as a standalone command-line tool.
- Requires Python >=3.6.
- SMOG is statistically invalid for texts under 30 sentences.
- Two Spanish formulas have stated reliability or scope limits.
Plans
Every plan and pricetextstat
Open source
The verdict
textstat offers a broad set of readability scores and text counts for Python users, with installation options including a standalone command-line setup. Its documented formula limits matter when interpreting results, particularly for short texts and certain Spanish measures.
What the maker publishes
- Command line
- The documentation says Textstat can be installed standalone as a command-line tool with pipx. source
- Consensus score
- Its text_standard function estimates the school grade level needed to understand text based on multiple readability tests. source
- Formula limitations
- The documentation says the Spanish Gutiérrez de Polini scores are unreliable for more complex text and the Crawford formula is valid only for elementary-school-level texts. source
- Installation
- The project documents installation through pip, Poetry, Pipenv, pipx, or directly from GitHub source. source
- Installation
- The project documents installation with pip or easy_install, from GitHub source, or from PyPI. source
- Integrations
- For syllable calculation, it uses Pyphen in most languages and defaults to nltk.corpus.cmudict for en_US. source
- Language coverage
- English is the default, with listed language variants for some formulas and specific measures for Spanish, Arabic, Italian, and German. source
- Language coverage
- English is the default, and the documentation lists language variants for some formulas, including German, Spanish, French, Italian, Dutch, Polish, and Russian. source
- Language-specific formulas
- The library includes Spanish-specific formulas, an Arabic Osman score, an Italian Gulpease index, and the German Wiener Sachtextformel. source
- License
- The package is distributed under the MIT license. source
- License
- The repository identifies its license as MIT. source
- Other metrics
- Its functions include reading time, syllable, word, sentence, character, letter, polysyllable, and monosyllable counts. source
- Purpose
- Textstat is a Python library that calculates text statistics to help determine readability, complexity, and grade level. source
- Purpose
- Textstat is a Python library for calculating text statistics to assess readability, complexity, and grade level. source
- Readability formulas
- It provides readability measures including Flesch Reading Ease, Flesch-Kincaid Grade, SMOG, Coleman-Liau, ARI, Dale-Chall, and Gunning Fog. source
- Readability formulas
- It includes measures such as Flesch Reading Ease, Flesch-Kincaid Grade Level, SMOG, Coleman-Liau, ARI, Dale-Chall, and Gunning Fog. source
- Reading time
- It estimates reading time using a default assumption of 14.69 milliseconds per character. source
- Runtime requirement
- PyPI lists Python >=3.6 as a requirement. source
- Security reporting
- The security policy asks people to report vulnerabilities by email and says Textstat does not offer a paid bug bounty programme. source
- SMOG limitation
- The documentation says SMOG is statistically invalid for texts under 30 sentences, although Textstat returns a result from at least three sentences. source
- SMOG limitation
- The documentation says SMOG is statistically invalid for texts under 30 sentences, although textstat requires at least 3 sentences to return a result. source
- Spanish formula limits
- The project says Gutiérrez de Polini scores for complex text are unreliable and Crawford is valid only for elementary-school-level texts. source
- Support
- The project asks users to report problems by opening a GitHub issue. source
- Support and contributions
- The project directs users to open GitHub issues for problems and pull requests for fixes or contributions. source
Checked against the maker's pages on 8 Oct 2026.