Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A little word cloud generator in Python
Python Shell

Merge pull request #68 from amueller/refactor

factor out computational part
latest commit 6ebeab0606
@amueller authored

Build Status licence


A little word cloud generator in Python. Read more about it on the blog post or the website


Fast install:

sudo pip install git+git://

Otherwise, get this package:

cd word_cloud-master

Install the requirements:

sudo pip install -r requirements.txt

Install the package:

sudo python install

Note that if you are not on Ubuntu, you need to pass a font_path to the WordCloud object (docs) to point to some existing font.


Check out examples/ for a short intro. A sample output is:


Or run examples/ to see more options. A sample output is:

Alice in Wonderland

Getting fancy with some colors: Parrot with rainbow colors

Used in

Reddit Cloud

Reddit Cloud is a Reddit bot which generates word clouds for comments in submissions and user histories. You can see it being operated on /u/WordCloudBot2 (top posting).

A Reddit Cloud sample

Chat Stats (

Chat Stats is a visualization program for Twitch streams, which generates word clouds for comments made by Twitch users in the chat. It also creates various charts and graphs pertaining to concurrent viewership and chat rate over time.

Chat Stats Sample

Twitter Word Cloud Bot

Twitter Word Cloud Bot is a twitter bot which generates word clouds for twitter users when it is mentioned with a particular hashtag. Here you can see it in action, while here you can see all the word clouds generated so far.


Send a pull request to add yours here.


Using Pillow instead of PIL might might get you the TypeError: 'int' object is not iterable problem also showcased on the blog.

Something went wrong with that request. Please try again.