Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


travis licence Quay

Automatic Web Article Summarizer



What is it?

ExplainToMe is a automatic text summarizer, that utilizes TextRank, a graph based algorithm to scans through the contents of a website to extract a concise machine generated summary. The methodology is similar to the way search engines return the most relevant web pages from a users search query.


Here’s a list of Python platforms that are officially supported.

  • Python 2.7
  • Python 3.4
  • Python 3.5
  • pypy 2.5.0 -> 2.7.9

We are working on Python 3.6



Clone Repository

$ git clone

Create a virtualenv

$ virtualenv -p python venv

Source Virtualenv

$ source venv/bin/activate

Install Python Dependencies

$ pip install --upgrade pip setuptools wheel
$ pip install -r requirements.txt

Run Server

$ python runserver
Running on (Press CTRL+C to quit)

Now go to your browser and point it towards


Running ExplainToMe via the official Docker image is an easy way to start a server if you don't want to install python.

We assume here you have already installed Docker for your system.

If you are getting started on OS X, the Docker toolbox is the first thing to checkout.

$ docker run -it -p 5000:5000 jjangsangy/ExplainToMe:latest

Once the server is running, navigate to either localhost:5000 (on Linux) or hostname:5000 (on Mac OS X), where hostname is the IP addresses of your virtual machine, obtained using

$ docker-machine ip my-vm-name

Now access your docker machine ip at port docker-machine-ip:5000


You might also want to try Kitematic on OS X which provides a GUI for running Docker images. Running ExplainToMe through Kitematic is easy, just search for the jjangsangy/ExplainToMe image, start it, and you should see it running


Things to look forward to:

  • Summaries of documents in other languages than English!

ExplainToMe API

Check out our Swagger API Documentation