	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

Generating wordclouds for Arabic:

Arabic wordlcloud

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.

Metadata

Release files for wordcloud 1.8.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wordcloud 1.8.1
File	Size	Uploaded	Provenance	Actions
wordcloud-1.8.1.tar.gz	220.7 kB	Nov 11, 2020	Without provenance	Details for wordcloud-1.8.1.tar.gz

Built distributions (wheels)

Total release size: 3.8 MB

Release files / wordcloud-1.8.1.tar.gz

Download URL	wordcloud-1.8.1.tar.gz
Size	220.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`e6ef771aac17c1cf8558c8d5ef025796184066d7b78f8118aefe011fb0d22952`
BLAKE2b-256 checksum How to use checksums	`be335bdd39587f0e8ede3fe12d9d16d6f1fb5e7a43f29621604a949ee362d013`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp39-cp39-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp39-cp39-manylinux1_x86_64.whl
Size	363.6 kB
Tags	CPython 3.9 Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`90e9cff2c6939b5e1fa87d2a2c5d79c8ac2eafc4c9b9bc1bcb865ca5fde7e758`
BLAKE2b-256 checksum How to use checksums	`08838b69c31668f62a8b4714294d4feaff906fac93c175a74fa5025fe483547c`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp38-cp38-win_amd64.whl

Download URL	wordcloud-1.8.1-cp38-cp38-win_amd64.whl
Size	155.9 kB
Tags	CPython 3.8 Windows x86-64
SHA-256 checksum How to use checksums	`f190eb3efcc17765a4ed9d78001fdb713988886b93e54b2758fcf4f6c519ad51`
BLAKE2b-256 checksum How to use checksums	`fc7e5848c211b1f141ffae41f0f05d72c0bfdb4816f9bf9d80f02962d019b8fe`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.0`

Release files / wordcloud-1.8.1-cp38-cp38-win32.whl

Download URL	wordcloud-1.8.1-cp38-cp38-win32.whl
Size	145.9 kB
Tags	CPython 3.8 Windows x86-32
SHA-256 checksum How to use checksums	`a4a626df47eacec207988e1ffdb5bd16b2b62ac83ea2442a0043080c0c5103ac`
BLAKE2b-256 checksum How to use checksums	`93051f17541135c5bb75c1415d4bda1ab80a80b5b1e7ab673d73f74f230d15db`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.0`

Release files / wordcloud-1.8.1-cp38-cp38-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp38-cp38-manylinux1_x86_64.whl
Size	372.0 kB
Tags	CPython 3.8 Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`daa7d72f0004fcfea5f649f1683dbe47c4a9c5f721aabeb41278a4ee33f21424`
BLAKE2b-256 checksum How to use checksums	`505bf588bbd1a7805a742e8d8316740383822b160c4e36b6c14793b57ebe7360`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp37-cp37m-win_amd64.whl

Download URL	wordcloud-1.8.1-cp37-cp37m-win_amd64.whl
Size	154.6 kB
Tags	CPython 3.7 CPython 3.7 pymalloc Windows x86-64
SHA-256 checksum How to use checksums	`2e1fc5991f52a0e191873025f5d8cf852eb1c39f2579d43e6d2589dc04d620d9`
BLAKE2b-256 checksum How to use checksums	`a7f0f7384c323c1fc7149573455f9633ef063c7b4d85c64d419b711bbca9ed29`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.5`

Release files / wordcloud-1.8.1-cp37-cp37m-win32.whl

Download URL	wordcloud-1.8.1-cp37-cp37m-win32.whl
Size	144.6 kB
Tags	CPython 3.7 CPython 3.7 pymalloc Windows x86-32
SHA-256 checksum How to use checksums	`9ed09d2d2916514845e42b0cc5dd86f65d4f0f89ab4bf164cc9a628d9db5a76b`
BLAKE2b-256 checksum How to use checksums	`a5307fa93aa322d0ea910e5f87752921b4006d01dd664049f6fc1032447d6c77`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.5`

Release files / wordcloud-1.8.1-cp37-cp37m-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp37-cp37m-manylinux1_x86_64.whl
Size	366.1 kB
Tags	CPython 3.7 CPython 3.7 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`6ff0ca777c801cd2a38deef30019f02fe35df1be9c31f6c301a34bd45006e26b`
BLAKE2b-256 checksum How to use checksums	`1b060516bdba2ebdc0d5bd476aa66f94666dd0ad6b9abda723fdf28e451db919`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp36-cp36m-win_amd64.whl

Download URL	wordcloud-1.8.1-cp36-cp36m-win_amd64.whl
Size	154.5 kB
Tags	CPython 3.6 CPython 3.6 pymalloc Windows x86-64
SHA-256 checksum How to use checksums	`2d5f63cf1f65126d6d1b8d55acae15961c5bd55e6ef8978bf269831dafcd1408`
BLAKE2b-256 checksum How to use checksums	`a4fd0be730526bae8355cadbea1c9e1cfbbfe5a92347f6937ea4474c467c04d1`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.6.8`

Release files / wordcloud-1.8.1-cp36-cp36m-win32.whl

Download URL	wordcloud-1.8.1-cp36-cp36m-win32.whl
Size	144.6 kB
Tags	CPython 3.6 CPython 3.6 pymalloc Windows x86-32
SHA-256 checksum How to use checksums	`cd8c44a21a3207da813c7b7e486ed41fe517eb7b8535deef945437f4cea2b245`
BLAKE2b-256 checksum How to use checksums	`925277c1ee2759fc5ff509c199aff3bd3228d01ecc46bfc21a7ce3bbea5a98c9`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.6.8`

Release files / wordcloud-1.8.1-cp36-cp36m-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp36-cp36m-manylinux1_x86_64.whl
Size	366.4 kB
Tags	CPython 3.6 CPython 3.6 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`41dafafe3768675ba8285d21ac68bd53191b50da85aba2a7fb35964d1649156f`
BLAKE2b-256 checksum How to use checksums	`05e752e4bef8e2e3499f6e96cc8ff7e0902a40b95014143b062acde4ff8b9fc8`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp27-cp27mu-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp27-cp27mu-manylinux1_x86_64.whl
Size	350.9 kB
Tags	CPython 2.7 CPython 2.7 pymalloc wide-unicode Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`f49f5213e978fb5d8ff8f6e6067de657e81ca863cab549b198579f58e1430e7c`
BLAKE2b-256 checksum How to use checksums	`56ff2b242a0e40036a310f2cf4310cff5e8d3df92656f1ab1f450fbb76b74237`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp27-cp27m-win_amd64.whl

Download URL	wordcloud-1.8.1-cp27-cp27m-win_amd64.whl
Size	153.6 kB
Tags	CPython 2.7 CPython 2.7 pymalloc Windows x86-64
SHA-256 checksum How to use checksums	`6450f67c207f2ab4513c4aac803226427b39f7fc8d3498c0b41a03834b2fc426`
BLAKE2b-256 checksum How to use checksums	`86c9581b28693812d8f3f38bc8e755eb40f25fd84885186bdcdd1d90aec4855e`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.6.1 requests/2.25.0 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/2.7.17`

Release files / wordcloud-1.8.1-cp27-cp27m-win32.whl

Download URL	wordcloud-1.8.1-cp27-cp27m-win32.whl
Size	144.3 kB
Tags	CPython 2.7 CPython 2.7 pymalloc Windows x86-32
SHA-256 checksum How to use checksums	`a02b27400bc4b2e4efdd8377e8cd138496b6b6e15a082d9c7b7c7b74a9ee8a55`
BLAKE2b-256 checksum How to use checksums	`739c650edda8f534cf73eda026ef3f7e83dabc469ee58efa86cae944accbcc42`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.6.1 requests/2.25.0 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/2.7.17`

Release files / wordcloud-1.8.1-cp27-cp27m-manylinux1_x86_64.whl

Download URL	wordcloud-1.8.1-cp27-cp27m-manylinux1_x86_64.whl
Size	350.8 kB
Tags	CPython 2.7 CPython 2.7 pymalloc Linux glibc 2.5+ x86-64
SHA-256 checksum How to use checksums	`e0d3f03e4f27faf543859b4bcd229d320361d065cf4786f149081adea4ee68e8`
BLAKE2b-256 checksum How to use checksums	`d8f293f40e5e64a1a6b654b5c637116ac4bee1e8b78a3e98fe6f5adf46a4fc32`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.7.0`

Release files / wordcloud-1.8.1-cp27-cp27m-macosx_10_6_x86_64.whl

Download URL	wordcloud-1.8.1-cp27-cp27m-macosx_10_6_x86_64.whl
Size	161.9 kB
Tags	CPython 2.7 CPython 2.7 pymalloc macOS 10.6+ x86-64
SHA-256 checksum How to use checksums	`2e85b1a6b8211436d47f902837c866c682c5d00046706f1d8e72cc0cd9210d64`
BLAKE2b-256 checksum How to use checksums	`8cfee8fcf3369cd2a4c118915d9f3ecca377aaf96691c9393996d94fd516546f`
Upload date	Nov 11, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.15.0 pkginfo/1.6.1 requests/2.25.0 setuptools/44.1.1 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/2.7.15`

Security for wordcloud 1.8.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

1.8.1 This release

Nov 11, 2020 16 release files No provenance

File	Interpreter	ABI	Platform	Actions Reset
wordcloud-1.8.1-cp39-cp39-manylinux1_x86_64.whl 363.6 kB Nov 11, 2020 Without provenance	CPython 3.9	CPython 3.9	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp39-cp39-manylinux1_x86_64.whl
wordcloud-1.8.1-cp38-cp38-win_amd64.whl 155.9 kB Nov 11, 2020 Without provenance	CPython 3.8	CPython 3.8	Windows x86-64	Details for wordcloud-1.8.1-cp38-cp38-win_amd64.whl
wordcloud-1.8.1-cp38-cp38-win32.whl 145.9 kB Nov 11, 2020 Without provenance	CPython 3.8	CPython 3.8	Windows x86-32	Details for wordcloud-1.8.1-cp38-cp38-win32.whl
wordcloud-1.8.1-cp38-cp38-manylinux1_x86_64.whl 372.0 kB Nov 11, 2020 Without provenance	CPython 3.8	CPython 3.8	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp38-cp38-manylinux1_x86_64.whl
wordcloud-1.8.1-cp37-cp37m-win_amd64.whl 154.6 kB Nov 11, 2020 Without provenance	CPython 3.7	CPython 3.7 pymalloc	Windows x86-64	Details for wordcloud-1.8.1-cp37-cp37m-win_amd64.whl
wordcloud-1.8.1-cp37-cp37m-win32.whl 144.6 kB Nov 11, 2020 Without provenance	CPython 3.7	CPython 3.7 pymalloc	Windows x86-32	Details for wordcloud-1.8.1-cp37-cp37m-win32.whl
wordcloud-1.8.1-cp37-cp37m-manylinux1_x86_64.whl 366.1 kB Nov 11, 2020 Without provenance	CPython 3.7	CPython 3.7 pymalloc	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp37-cp37m-manylinux1_x86_64.whl
wordcloud-1.8.1-cp36-cp36m-win_amd64.whl 154.5 kB Nov 11, 2020 Without provenance	CPython 3.6	CPython 3.6 pymalloc	Windows x86-64	Details for wordcloud-1.8.1-cp36-cp36m-win_amd64.whl
wordcloud-1.8.1-cp36-cp36m-win32.whl 144.6 kB Nov 11, 2020 Without provenance	CPython 3.6	CPython 3.6 pymalloc	Windows x86-32	Details for wordcloud-1.8.1-cp36-cp36m-win32.whl
wordcloud-1.8.1-cp36-cp36m-manylinux1_x86_64.whl 366.4 kB Nov 11, 2020 Without provenance	CPython 3.6	CPython 3.6 pymalloc	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp36-cp36m-manylinux1_x86_64.whl
wordcloud-1.8.1-cp27-cp27mu-manylinux1_x86_64.whl 350.9 kB Nov 11, 2020 Without provenance	CPython 2.7	CPython 2.7 pymalloc wide-unicode	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp27-cp27mu-manylinux1_x86_64.whl
wordcloud-1.8.1-cp27-cp27m-win_amd64.whl 153.6 kB Nov 11, 2020 Without provenance	CPython 2.7	CPython 2.7 pymalloc	Windows x86-64	Details for wordcloud-1.8.1-cp27-cp27m-win_amd64.whl
wordcloud-1.8.1-cp27-cp27m-win32.whl 144.3 kB Nov 11, 2020 Without provenance	CPython 2.7	CPython 2.7 pymalloc	Windows x86-32	Details for wordcloud-1.8.1-cp27-cp27m-win32.whl
wordcloud-1.8.1-cp27-cp27m-manylinux1_x86_64.whl 350.8 kB Nov 11, 2020 Without provenance	CPython 2.7	CPython 2.7 pymalloc	Linux glibc 2.5+ x86-64	Details for wordcloud-1.8.1-cp27-cp27m-manylinux1_x86_64.whl
wordcloud-1.8.1-cp27-cp27m-macosx_10_6_x86_64.whl 161.9 kB Nov 11, 2020 Without provenance	CPython 2.7	CPython 2.7 pymalloc	macOS 10.6+ x86-64	Details for wordcloud-1.8.1-cp27-cp27m-macosx_10_6_x86_64.whl

wordcloud 1.8.1