thumbor is an open-source photo thumbnail service by
Carlos Gusmão
Carlos Gusmão Release 6.6.0
Latest commit 5b6e89c Nov 7, 2018
Failed to load latest commit information.
docs Stretch filter Nov 7, 2018
integration_tests Make ThreadPoll exec callbacks on main IOLoop. Add async test. Jun 4, 2018
tests Improving stretch filter test coverage Nov 7, 2018
thumbor Release 6.6.0 Nov 7, 2018
.continuousrc Configurações do ci. Jul 29, 2011
.coveragerc Move integration tests out of the package Jul 6, 2016
.gitignore Support Graceful shutdown on SIGTERM and SIGINT. Jun 19, 2018
.travis.yml Install ffmpeg from distr repos to speed up build time Jun 11, 2018
.venv fish environment file Aug 9, 2014
CHANGELOG CHANGELOG: add 5.0.5 to 6.3.2 from GitHub releases. Aug 23, 2017 fixing codacy trailing space issue, adding yang to test requirement p… Jan 15, 2018
LICENSE LICENSE file Mar 19, 2014 Move integration tests out of the package Jul 6, 2016
Makefile Ignoring flake errors tied to python3 Oct 29, 2018
README.mkd Revert "Git Shallow Clone on CI w/ other changes" Aug 29, 2017
flake8 Fixing docs generation Feb 5, 2016 issues template Feb 17, 2016
logo-thumbor.png logo Mar 12, 2014
mongo_check_start.js Revert "Git Shallow Clone on CI w/ other changes" Aug 29, 2017
redis.conf Partial support to using WebP (#140). Added support for "format" filter. Jul 2, 2013
requirements Add Metadata using Pyexiv2 Feb 11, 2016 Allow Pillow 5.2 Aug 3, 2018
thumbor.key Fixes thumbor-url and adds options to key file and adaptive urls Mar 23, 2012
unwanted_packages removing Riak from unwanted packages Oct 24, 2012



If you use thumbor, please take 1 minute and answer this survey? It's only 2 questions and one is multiple choice!!!

Coverage Status Code Climate Codacy Badge Issue Stats Issue Stats PyPI PyPI Bountysource

thumbor is a smart imaging service. It enables on-demand crop, resizing and flipping of images.

It also features a VERY smart detection of important points in the image for better cropping and resizing, using state-of-the-art face and feature detection algorithms (more on that in Detection Algorithms).

Using thumbor is very easy (after it is running). All you have to do is access it using an URL for an image, like this:


That URL would show an image of the big brother brasil participants in 300x200 using smart crop.

There are several other options to the image URL configuration. You can check them in the Usage page.

For more information check thumbor's documentation.


You can see thumbor in action at

Join the chat at