thumbor is an open-source photo thumbnail service by
Python C Makefile JavaScript
Latest commit 6c3bc3f Aug 15, 2017 @masom masom committed on GitHub Merge pull request #928 from gi11es/loaderresult-custom-error
Allow custom LoaderResult errors
Failed to load latest commit information.
debian Replaced to Jul 18, 2016
docs Merge pull request #878 from Savar/filter_upscale Apr 27, 2017
integration_tests adding the url_helpers test for upscale() Apr 15, 2017
tests Allow custom LoaderResult errors Aug 15, 2017
thumbor Allow custom LoaderResult errors Aug 15, 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 background_color option added for gifv and scale put back on ffmpeg Apr 25, 2017
.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 Add links to docs in README.mkd Jul 28, 2017
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 Allow pillow 4 since there were no BC breaks Jun 8, 2017
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