A little word cloud generator

Project description

	Linux	macOS	Windows
PyPI

word_cloud

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

The code is tested against Python 2.7, 3.4, 3.5, 3.6 and 3.7.

Installation

If you are using pip:

pip install wordcloud

If you are using conda, you can install from the conda-forge channel:

conda install -c conda-forge wordcloud

Installation notes

wordcloud depends on numpy and pillow.

To save the wordcloud into a file, matplotlib can also be installed. See examples below.

If there are no wheels available for your version of python, installing the package requires having a C compiler set up. Before installing a compiler, report an issue describing the version of python and operating system being used.

Examples

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

Constitution

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

Alice in Wonderland

Getting fancy with some colors: Parrot with rainbow colors

Command-line usage

The wordcloud_cli tool can be used to generate word clouds directly from the command-line:

$ wordcloud_cli --text mytext.txt --imagefile wordcloud.png

If you're dealing with PDF files, then pdftotext, included by default with many Linux distribution, comes in handy:

$ pdftotext mydocument.pdf - | wordcloud_cli --imagefile wordcloud.png

In the previous example, the - argument orders pdftotext to write the resulting text to stdout, which is then piped to the stdin of wordcloud_cli.py.

Use wordcloud_cli --help so see all available options.

Licensing

The wordcloud library is MIT licenced, but contains DroidSansMono.ttf, a true type font by Google, that is apache licensed. The font is by no means integral, and any other font can be used by setting the font_path variable when creating a WordCloud object.

Project details

Release history Release notifications | RSS feed

1.9.4

Nov 10, 2024

1.9.3

Dec 9, 2023

1.9.2

May 18, 2023

1.9.1.1

Apr 27, 2023

1.8.2.2

Jun 27, 2022

1.8.1

Nov 11, 2020

1.8.0

Aug 14, 2020

This version

1.7.0

May 2, 2020

1.6.0

Nov 22, 2019

1.5.0

Jul 26, 2018

1.4.1

Mar 13, 2018

1.4

Mar 6, 2018

1.3.1

Mar 21, 2017

1.3

Mar 14, 2017

1.2.1

Feb 19, 2016

1.2

Nov 18, 2015

1.1.3

Jul 22, 2015

1.1.2

Jun 19, 2015

1.1.1

Jun 19, 2015

1.1.0

Apr 30, 2015

1.0.0

Mar 20, 2015

Download files

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

Source Distribution

wordcloud-1.7.0.tar.gz (216.8 kB view hashes)

Uploaded May 2, 2020 Source

Built Distributions

wordcloud-1.7.0-cp37-cp37m-win_amd64.whl (157.0 kB view hashes)

Uploaded May 2, 2020 CPython 3.7m Windows x86-64

wordcloud-1.7.0-cp37-cp37m-manylinux1_x86_64.whl (364.2 kB view hashes)

Uploaded May 2, 2020 CPython 3.7m

wordcloud-1.7.0-cp37-cp37m-macosx_10_6_x86_64.whl (160.4 kB view hashes)

Uploaded May 2, 2020 CPython 3.7m macOS 10.6+ x86-64

wordcloud-1.7.0-cp36-cp36m-win_amd64.whl (157.2 kB view hashes)

Uploaded May 2, 2020 CPython 3.6m Windows x86-64

wordcloud-1.7.0-cp36-cp36m-manylinux1_x86_64.whl (364.5 kB view hashes)

Uploaded May 2, 2020 CPython 3.6m

wordcloud-1.7.0-cp36-cp36m-macosx_10_6_x86_64.whl (160.2 kB view hashes)

Uploaded May 2, 2020 CPython 3.6m macOS 10.6+ x86-64

wordcloud-1.7.0-cp35-cp35m-win_amd64.whl (156.7 kB view hashes)

Uploaded May 2, 2020 CPython 3.5m Windows x86-64

wordcloud-1.7.0-cp35-cp35m-manylinux1_x86_64.whl (360.4 kB view hashes)

Uploaded May 2, 2020 CPython 3.5m

wordcloud-1.7.0-cp35-cp35m-macosx_10_6_x86_64.whl (159.1 kB view hashes)

Uploaded May 2, 2020 CPython 3.5m macOS 10.6+ x86-64

wordcloud-1.7.0-cp27-cp27mu-manylinux1_x86_64.whl (348.6 kB view hashes)

Uploaded May 2, 2020 CPython 2.7mu

wordcloud-1.7.0-cp27-cp27m-win_amd64.whl (156.8 kB view hashes)

Uploaded May 2, 2020 CPython 2.7m Windows x86-64

wordcloud-1.7.0-cp27-cp27m-manylinux1_x86_64.whl (348.6 kB view hashes)

Uploaded May 2, 2020 CPython 2.7m

wordcloud-1.7.0-cp27-cp27m-macosx_10_6_x86_64.whl (162.3 kB view hashes)

Uploaded May 2, 2020 CPython 2.7m macOS 10.6+ x86-64

Hashes for wordcloud-1.7.0.tar.gz

Hashes for wordcloud-1.7.0.tar.gz
Algorithm	Hash digest
SHA256	`bad2b990350a869e6e35c05d292784b050da6068109068425961aad4ae4fefb2`
MD5	`04106f09e90f109a0c4c42514500d628`
BLAKE2b-256	`6b9f27cec92eee9f1d4f02f986ad0cc6dfc0797b117be6e968da8f92c6c183aa`

Hashes for wordcloud-1.7.0-cp37-cp37m-win_amd64.whl

Hashes for wordcloud-1.7.0-cp37-cp37m-win_amd64.whl
Algorithm	Hash digest
SHA256	`210437eb5e8dbe26a31b703b38ce64b537dd291a4a5a1a9b172eb0e657eb1840`
MD5	`ffd3ca1f2077b590e9db6e9768caaea6`
BLAKE2b-256	`6541abefdda082c7b211248e412fb2c7a8dc69d474f18ed61a5a784f20f73bb7`

Hashes for wordcloud-1.7.0-cp37-cp37m-manylinux1_x86_64.whl

Hashes for wordcloud-1.7.0-cp37-cp37m-manylinux1_x86_64.whl
Algorithm	Hash digest
SHA256	`2047ca011528cf94c599f585003664cfe2821ebd54c1dd55e67c25b26f4b3c03`
MD5	`5d1db51ce4ee663375bcdd6a42c482f0`
BLAKE2b-256	`ed1dc6d942bc569df4ff1574633b159a68c75f79061fe279975d90f9d2180204`

Hashes for wordcloud-1.7.0-cp37-cp37m-macosx_10_6_x86_64.whl

Hashes for wordcloud-1.7.0-cp37-cp37m-macosx_10_6_x86_64.whl
Algorithm	Hash digest
SHA256	`6334040254e12da4c1f40475f42663d6cc9d00c9159fb8956973fad00a024a61`
MD5	`08be3d3848d821b77570398d88ba246a`
BLAKE2b-256	`7eeae531ac225713af626d1d2d108ec4774ffdde54ac83c5c863b42a72e4a164`

Hashes for wordcloud-1.7.0-cp36-cp36m-win_amd64.whl

Hashes for wordcloud-1.7.0-cp36-cp36m-win_amd64.whl
Algorithm	Hash digest
SHA256	`e06e82246c5ced1b536fe00e8734dcae0f1e8556f79753ecc07dfaffe527b8b3`
MD5	`857dd45d07c1c5ae2be7d56f64842faa`
BLAKE2b-256	`2c1209efb38f079da846e16d81b6a65467bc359effe0e48ce3f869bbe768b085`

Hashes for wordcloud-1.7.0-cp36-cp36m-manylinux1_x86_64.whl

Hashes for wordcloud-1.7.0-cp36-cp36m-manylinux1_x86_64.whl
Algorithm	Hash digest
SHA256	`b868e669f94ade050963cbaaa2147fc80d1db18d072140d3640b217d99b95b59`
MD5	`2218e3e35088488588f95e567532be15`
BLAKE2b-256	`f6e7f4ed7fac1993615b4ba92f473a77e27a3d210c5d23a000c2c98846963f9a`

Hashes for wordcloud-1.7.0-cp36-cp36m-macosx_10_6_x86_64.whl

Hashes for wordcloud-1.7.0-cp36-cp36m-macosx_10_6_x86_64.whl
Algorithm	Hash digest
SHA256	`debe5c4b38b7d475ba148a1888f3a74d7c6160cac9c3f9e5ffe7be79ba2564c2`
MD5	`0b46700d1061e648d251c3289add2341`
BLAKE2b-256	`cddbf838feff70073a49aeb5ab765728c68ad84d0e3a9c12e9f203753d69ee86`

Hashes for wordcloud-1.7.0-cp35-cp35m-win_amd64.whl

Hashes for wordcloud-1.7.0-cp35-cp35m-win_amd64.whl
Algorithm	Hash digest
SHA256	`02be5eec60c1612407b9efa21f6dd41499fe59198ec776d070bc938fa13d6707`
MD5	`4a7484b0bdd0d76bbaf366a17bf7efea`
BLAKE2b-256	`4131580671a3fa26c57285a25f14329afbea447416dbbec557559988377af373`

Hashes for wordcloud-1.7.0-cp35-cp35m-manylinux1_x86_64.whl

Hashes for wordcloud-1.7.0-cp35-cp35m-manylinux1_x86_64.whl
Algorithm	Hash digest
SHA256	`d9f7063a9616b6b39af26a896c29cfeda6c7c68e3c7da1286f070c3e4e692033`
MD5	`ff696eb87ff93290e31f7fe347e5c921`
BLAKE2b-256	`fd0a44536be61066a514642696f7f3142a93f53c0664c566e75d88c675a32cbb`

Hashes for wordcloud-1.7.0-cp35-cp35m-macosx_10_6_x86_64.whl

Hashes for wordcloud-1.7.0-cp35-cp35m-macosx_10_6_x86_64.whl
Algorithm	Hash digest
SHA256	`9a1a25ff2d3c0f3d5e763346a390075c0729d6667dc7c0db264ee22ec862d99b`
MD5	`89169acb41f0e728c24751c2ed0a72d1`
BLAKE2b-256	`726eb481ff0878638280f886f9ba6eb2caa059d01b92325b9abfee92e908fcde`

Hashes for wordcloud-1.7.0-cp27-cp27mu-manylinux1_x86_64.whl

Hashes for wordcloud-1.7.0-cp27-cp27mu-manylinux1_x86_64.whl
Algorithm	Hash digest
SHA256	`396b358746a110eb4a48a3c6a93dad2d056351d28f165801112e258c8b3f6d16`
MD5	`6801008e256d0a6025c565b1f231ce16`
BLAKE2b-256	`d565ef561435609c345efdf2fb9038979db3dd29eb10f081514c5a0ada21eaed`

Hashes for wordcloud-1.7.0-cp27-cp27m-win_amd64.whl

Hashes for wordcloud-1.7.0-cp27-cp27m-win_amd64.whl
Algorithm	Hash digest
SHA256	`e74ef79f1084b8312e4b03f732e33c7f83cee99ceb9792501ab7a43ab2e6a350`
MD5	`0edb4f5c49bd8b510e1c84924de5db6d`
BLAKE2b-256	`9cf0d66306ab6f17e5612e3c3ad18f1aa99ff5c8813729ac5a451bd120edc643`

Hashes for wordcloud-1.7.0-cp27-cp27m-manylinux1_x86_64.whl

Hashes for wordcloud-1.7.0-cp27-cp27m-manylinux1_x86_64.whl
Algorithm	Hash digest
SHA256	`ebb8c58397096e11da56961d54b2eaa3ed2a96691f10d88251241dbab34576a6`
MD5	`1b3a6ba5ff59a829778f8e5672d08d29`
BLAKE2b-256	`7d5a6ee2b687db9806b2588c48ef56487aa030e8e53bedcbf3b150b59c4206e5`

Hashes for wordcloud-1.7.0-cp27-cp27m-macosx_10_6_x86_64.whl

Hashes for wordcloud-1.7.0-cp27-cp27m-macosx_10_6_x86_64.whl
Algorithm	Hash digest
SHA256	`ab5fb33419bfd995ecda6b3c9ea81f945e0490a65f8e841854f728eeb41ddc7f`
MD5	`3c023ae9b21cf28cf836938331c7d0c6`
BLAKE2b-256	`cb1f9c36ccd684ffc834866d5b5682147841f5b36eaaa5908a9008e165280629`