Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python version of arc90's *older* readability.js (unmaintained)
Python JavaScript



A Python implementation of the algorithm used in arc90's readability bookmarklet:

>>> import urllib
>>> import readability
>>> url = ''
>>> html = urllib.urlopen(url).read()
>>> print readability.readable(url, html)[0]


The above API may change before release.

To directly open the readable version of a URL in the web browser:

$ readability -b is not released yet. To install the development version:

$ pip install -e git://

Old algorithm

Unfortunately this project, like others, uses an older version of the readability algorithm, Viz.

Matt: [...] the readability.js file that can be downloaded from the "downloads" section of the Google Code project is a year and a half old and only 8.9KB (about 250 loc), while the trunk version (presumably similar to what's used in the bookmarklet) has expanded to a whopping 73.5KB and 1825 loc.

Ideally, we should port this project to use the same algorithm as the bookmarklet.

Credits adds several bug fixes and features to in the Readable Feeds project that adapted the original by Nirmal Patel. retains the original license (GPL3) chosen by its predecessors.

Something went wrong with that request. Please try again.