Skip to content
thumbor is an open-source photo thumbnail service by
Branch: master
Clone or download
kkopachev Merge pull request #1207 from kkopachev/travis-xenial
Travis updated to Ubuntu Xenial: drop trusty-media repo, add libgnutls
Latest commit 37c3602 Jun 26, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Merge pull request #1197 from codechelon/patch-2 May 8, 2019
integration_tests Make ThreadPoll exec callbacks on main IOLoop. Add async test. Jun 4, 2018
tests Fix FocalPoint from_dict now returns integer (#1172) Mar 20, 2019
thumbor Add SENTRY_ENVIRONMENT configuration (#1170) Mar 20, 2019
.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 Travis updated to Ubuntu Xenial: drop trusty-media repo, add libgnutls Jun 24, 2019
.venv fish environment file Aug 9, 2014
CHANGELOG CHANGELOG: add 5.0.5 to 6.3.2 from GitHub releases. Aug 23, 2017 Replace 'pycryptodome' with 'pycryptodomex' (#1173) Feb 20, 2019
LICENSE LICENSE file Mar 19, 2014 Add LICENSE and tests (#1179) Mar 20, 2019
Makefile Set some env vars needed to build PyCURL on Mac Jan 30, 2019
README.mkd Fix readme.mkd badges Mar 1, 2019
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 Replace 'pycryptodome' with 'pycryptodomex' (#1173) Feb 20, 2019
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 Shields Shields 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

You can’t perform that action at this time.