thumbor is an open-source photo thumbnail service by
Python C Makefile JavaScript
Latest commit 722e263 Mar 15, 2017 @scorphus scorphus Fix a test name, oops
Failed to load latest commit information.
debian Replaced to Jul 18, 2016
docs changing description of fit-in (#870) Mar 5, 2017
integration_tests Move integration tests out of the package Jul 6, 2016
tests Fix a test name, oops Mar 16, 2017
thumbor Bump to 6.3.0 Mar 14, 2017
.continuousrc Configurações do ci. Jul 29, 2011
.coveragerc Move integration tests out of the package Jul 6, 2016
.gitignore Wiki documentation ported to read the docs (sphinx) Mar 25, 2015
.travis.yml Use pyssim instead of scikit-image for SSIM calculation May 29, 2016
.venv fish environment file Aug 9, 2014
CHANGELOG Use right path to repository Dec 11, 2015 Improve docs on how to contribute to Thumbor Mar 9, 2017
LICENSE LICENSE file Mar 19, 2014 Move integration tests out of the package Jul 6, 2016
Makefile Replace copyrighted images with copylefted ones Mar 4, 2017
README.mkd Fix path to documentation Apr 4, 2016
flake8 Fixing docs generation Feb 5, 2016 issues template Feb 17, 2016
logo-thumbor.png logo Mar 12, 2014
mongo_check_start.js Sane mongo start handling Apr 23, 2015
redis.conf Partial support to using WebP (#140). Added support for "format" filter. Jul 2, 2013
requirements Add Metadata using Pyexiv2 Feb 11, 2016 Constrain CairoSVG version to v1 Dec 12, 2016
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