Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

textstat

github.com

  • Free plan
  • Linux
  • Self-hosted
7.4 Club score Visit github.com

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.

textstat

Free

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.