Skip to main content

command line tool for creating awesome thug memes

Project description

build pypi python_versions codecov

Command line Thug Meme generator written in Python.



  • Python 3.4+
pip3 install thug-memes

This installs the core version which supports opencv haarcascade based detector. If you are serious with your thug memes (like you definitely should), there is also support for dlib based detector which, in general, provides better results. If you want to enjoy dlib’s accuracy, please follow dlib’s own installation instructions. Some additional dlib installation guides for macOS and Ubuntu can be found in: [1] [2]. Thug memes can be installed with dlib’s Python bindings included:

pip3 install thug-memes[dlib]


thug path/to/the/original/image 'JUST CASUALLY LIFTING' '20KGs HERE'

Will store something like this in your current directory:


If you have installed dlib and want to use it instead of opencv detector, add option:

--detector dlib

If you want to see the results of the detection, add –debug option:

Opencv (–debug):


Dlib (–detector dlib –debug):


Almost everything is configurable. You can see the used configuration with:


The default configuration is in src/thug/defaul.conf. You can override this by defining environment variable THUG_CONF and pointing it to a file which contains overrides. In addition, you can override any of the configuration variables from command line with –override or -o options. For example:

thug path/to/original/img.jpg 'WE HAVE HUGE CIGARS' 'BUT ALSO PINK TEXT' --detector dlib -o cigar_length 2 -o glasses_width 5 -o font_bgr '[180,105,255]'


For all available options, see:

thug --help

If you don’t want to have awesome Thug elements in your meme, there is also ‘a plain meme’ alternative:

meme path/to/the/original/image 'THIS IS A NORMAL MEME' 'WITHOUT THUG STUFF :(' -o font_bgr '[255,255,255]'


Example images are from pexels.


See contributing guide.

Project details

Download files

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

Files for thug-memes, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size thug-memes-0.1.2.tar.gz (1.2 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page