Skip to main content

fast html to text parser (article readability tool) with python3 support

Project description

.. image::


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'

Change Log

- 0.7 Improved HTML5 tags handling. Heuristics were changed for a lot of sites: Fixed an important
bug with 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
and 3.4
- 0.5 Preparing a release to support Python versions 2.6, 2.7, 3.3 and
- 0.4 Added Videos loading and allowed more images per paragraph
- 0.3 Added Document.encoding, positive\_keywords and


This code is under `the Apache License
2.0 <>`__ license.

Thanks to

- Latest
`readability.js <>`__
- Ruby port by starrhorne and iterationlabs
- `Python port <>`__ by
- `Decruft
effort <>`__
to move to lxml
- "BR to P" fix from readability.js which improves quality for smaller
- Github users contributions.

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
readability-lxml-0.7.tar.gz (14.8 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page