Skip to content
fast python port of arc90's readability tool, updated to match latest readability.js!
HTML Python Makefile
Branch: master
Clone or download
Pull request Compare This branch is 2 commits ahead, 29 commits behind buriy:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.



Given a html document, it pulls out the main body text and cleans it up.

This is a python port of a ruby port of arc90's readability project.


It's easy using pip, just run:

$ pip install readability-lxml


>>> import requests
>>> from readability import Document

>>> response = requests.get('')
>>> doc = Document(response.text)
>>> doc.title()
'Example Domain'

>>> doc.summary()
u'<html><body><div><body id="readabilityBody">\n<div>\n    <h1>Example Domain</h1>\n
<p>This domain is established to be used for illustrative examples in documents. You may
use this\n    domain in examples without prior coordination or asking for permission.</p>
\n    <p><a href="">More information...</a></p>\n</div>

Change Log

  • 0.7.1 Support for Python 3.7 . Fixed a slowdown when processing documents with lots of spaces.
  • 0.7 Improved HTML5 tags handling. Fixed stripping unwanted HTML nodes (only first matching node was removed before).
  • 0.6 Finally a release which supports Python versions 2.6, 2.7, 3.3 - 3.6
  • 0.5 Preparing a release to support Python versions 2.6, 2.7, 3.3 and 3.4
  • 0.4 Added Videos loading and allowed more images per paragraph
  • 0.3 Added Document.encoding, positive_keywords and negative_keywords


This code is under the Apache License 2.0 license.

Thanks to

You can’t perform that action at this time.