Skip to main content

Flesch Kincaid readability scoring algorithm

Project description


Flesch Kincaid readability score for text

A Python module implementation of the Flesch Kincaid readability score algorithm.

The source code is released under the MIT License.


pip3 install fkscore


For text in python represented as a string.

Takes text as string datatype. Words can be on same or different lines. Current version is English language only. Email for support.

import fkscore
text = '...blah blah blah...'
f = fkscore.fkscore(text)


from fkscore import fkscore
text = '...blah blah blah...'
f = fkscore(text)


Output includes 2 dictionaries of information as follows:

  • stats:
    • stats['num_words']
    • stats['num_syllables']
    • stats['num_sentences']
  • score:
    • score['readability'] # Calculated F-K Readability Score
    • score['grade'] # Permuted F-K Grade Reading Level


Releases and additions will push to PyPi periodically, but if there is a feature in master not built/pushed and you want it to be, just ping me.


This is a maintained as an implementation of the Flesch-Kincaid readability algorithm which was initially developed in 1948 by Rudolph Flesch and later revised by the U.S. Navy in 1975. This module is pure python and works with 3.5+.


Feel free to ping for questions, comments, concerns or interact directly via the GitHub repository.

Randall Shane, PhD
Thank you!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fkscore, version 1.1.6
Filename, size File type Python version Upload date Hashes
Filename, size fkscore-1.1.6-py3-none-any.whl (4.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size fkscore-1.1.6.tar.gz (3.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page