Skip to main content

thumbor is an open-source photo thumbnail service by

Project description

Join thumbor-bootcamp for a learning and contribution experience with ❤️ and 🤗 from the thumbor team


Crop, resize, transform and much more, all on-demand and AI Powered

thumbor is trusted by hundreds of companies worldwide

Wikipedia trusts thumbor trusts thumbor  Vox Media trusts thumbor  Forbes trusts thumbor  Square trusts thumbor  Deliveroo trusts thumbor  Canal+ trusts thumbor  Terra trusts thumbor  nrc trusts thumbor indicates thumbor for high-performance web sites  aws indicates thumbor for serverless image handling
and many more!

thumbor is a smart imaging service that enables on-demand cropping, resizing, applying filters and optimizing images.

Cropping photos automatically can be a frustrating experience with severed heads involved. thumbor uses AI for smart detection.

thumbor is an HTTP server and you can create as many different images as you want just by varying path parameters:


You should see an image of the thumbor logo in 300x200.

Learn more about all you can do in thumbor's documentation.

⚙️ Installation

Decide which installation option you want to use.

Option 1: pip

# thumbor with main dependencies only
pip install thumbor

# thumbor with OpenCV dependency
pip install thumbor[opencv]

# thumbor with all dependencies
pip install thumbor[all]

Option 2: Binary

sudo add-apt-repository ppa:thumbor/ppa
sudo aptitude update
sudo aptitude install thumbor

For more ways, please check out Installation.


Running it is as easy as hit:


After this, you can reach it on https://localhost:8888/unsafe/


If you experience any troubles, try running:


If you have a thumbor.conf file, you can use that to help thumbor-doctor:

thumbor-doctor -c thumbor.conf

If you still need help, please raise an issue. Remember to send your thumbor-doctor output in the issue:

thumbor-doctor --nocolor -c thumbor.conf

🎯 Features

  • supports all common images formats out of the box
  • intelligent cropping and resizing
  • blazing fast using caching
  • supports many storages (local storage, AWS S3, Rackspace, Ceph, ...)
  • AI-powered cropping based on face and feature detection (glasses, interesting points, ...)
  • integrated with many programming languages and frameworks and many more...
  • highly extensible

🌟 Awesome Goodies

awesome-thumbor is a curated list of all things thumbor. There you can find filters, storages, engines, loaders, docker images, extensions in your favorite language and framework, and much more.

All of it with a clear indication of each project's quality. Have fun!

👍 Contribute

thumbor is an open-source project with many contributors. Join them contributing code or contributing documentation.

If you use thumbor, please take 1 minute and answer this survey? Only 2 questions!

Join the chat at

👀 Demo

You can see thumbor in action at

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

thumbor-7.7.4.tar.gz (30.7 MB view hashes)

Uploaded Source

Built Distributions

thumbor-7.7.4-cp39-abi3-musllinux_1_1_x86_64.whl (8.6 MB view hashes)

Uploaded CPython 3.9+ musllinux: musl 1.1+ x86-64

thumbor-7.7.4-cp39-abi3-musllinux_1_1_i686.whl (8.5 MB view hashes)

Uploaded CPython 3.9+ musllinux: musl 1.1+ i686

thumbor-7.7.4-cp39-abi3-musllinux_1_1_aarch64.whl (8.5 MB view hashes)

Uploaded CPython 3.9+ musllinux: musl 1.1+ ARM64

thumbor-7.7.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.5 MB view hashes)

Uploaded CPython 3.9+ manylinux: glibc 2.17+ x86-64

thumbor-7.7.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (8.5 MB view hashes)

Uploaded CPython 3.9+ manylinux: glibc 2.17+ ARM64

thumbor-7.7.4-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (8.6 MB view hashes)

Uploaded CPython 3.9+ manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

thumbor-7.7.4-cp39-abi3-macosx_11_0_arm64.whl (8.4 MB view hashes)

Uploaded CPython 3.9+ macOS 11.0+ ARM64

thumbor-7.7.4-cp39-abi3-macosx_10_9_x86_64.whl (8.4 MB view hashes)

Uploaded CPython 3.9+ macOS 10.9+ x86-64

thumbor-7.7.4-cp39-abi3-macosx_10_9_universal2.whl (8.5 MB view hashes)

Uploaded CPython 3.9+ macOS 10.9+ universal2 (ARM64, x86-64)

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page