Skip to main content

thumbor is an open-source photo thumbnail service by globo.com

Project description

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

thumbor

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


thumbor is trusted by hundreds of companies worldwide

Wikipedia trusts thumbor  Globo.com trusts thumbor  Vox Media trusts thumbor  Forbes trusts thumbor  Square trusts thumbor  Deliveroo trusts thumbor  Canal+ trusts thumbor  Terra trusts thumbor  nrc trusts thumbor  web.dev 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:

http://<thumbor-server>/300x200/smart/thumbor.readthedocs.io/en/latest/_images/logo-thumbor.png

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.

Run

Running it is as easy as hit:

thumbor

After this, you can reach it on https://localhost:8888/unsafe/https://raw.githubusercontent.com/thumbor/thumbor/master/example.jpg

Troubles?

If you experience any troubles, try running:

thumbor-doctor

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 https://gitter.im/thumbor/thumbor

👀 Demo

You can see thumbor in action at http://thumborize.me/

Project details


Release history Release notifications | RSS feed

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.4.1.tar.gz (29.7 MB view details)

Uploaded Source

Built Distributions

thumbor-7.4.1-cp37-abi3-musllinux_1_1_x86_64.whl (8.6 MB view details)

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

thumbor-7.4.1-cp37-abi3-musllinux_1_1_i686.whl (8.5 MB view details)

Uploaded CPython 3.7+ musllinux: musl 1.1+ i686

thumbor-7.4.1-cp37-abi3-musllinux_1_1_aarch64.whl (8.6 MB view details)

Uploaded CPython 3.7+ musllinux: musl 1.1+ ARM64

thumbor-7.4.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.5 MB view details)

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

thumbor-7.4.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (8.5 MB view details)

Uploaded CPython 3.7+ manylinux: glibc 2.17+ ARM64

thumbor-7.4.1-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (8.6 MB view details)

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

thumbor-7.4.1-cp37-abi3-macosx_11_0_arm64.whl (8.4 MB view details)

Uploaded CPython 3.7+ macOS 11.0+ ARM64

thumbor-7.4.1-cp37-abi3-macosx_10_9_x86_64.whl (8.4 MB view details)

Uploaded CPython 3.7+ macOS 10.9+ x86-64

thumbor-7.4.1-cp37-abi3-macosx_10_9_universal2.whl (8.5 MB view details)

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

File details

Details for the file thumbor-7.4.1.tar.gz.

File metadata

  • Download URL: thumbor-7.4.1.tar.gz
  • Upload date:
  • Size: 29.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for thumbor-7.4.1.tar.gz
Algorithm Hash digest
SHA256 2368d7cd1408ffb00eaa50d8224169c92052eaf36ce3d287a597d7d5bf56114d
MD5 298233f059ed31dd44d89d150d44d04d
BLAKE2b-256 f130539ea7d973dd8822027677db5f0b8ab79f37762ea612cf59dd5b422e9c92

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 51100e2604cb17e30b8e37ebf49eb4e9b8dd0249c5c8262ae539c0dca4aaf594
MD5 cf7c85d96975a550adb3a471a638036b
BLAKE2b-256 38b7c94273bc4d53279d00a692dbca9c9fe8c3fb4b18c86185bab64de91f2e7e

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-musllinux_1_1_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 3255742213b3e76117205fe2df01a7679b66cc23d2300b4203fbc04b66877a40
MD5 7049fecb33073b6e31c1bccb42a77325
BLAKE2b-256 b5eac122239153197ff223425cd165e2ad6be5dc1ff673c0474da342c094bd8e

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 d562e87b9c8880dc3bd30b8e9dc33f5162278ce0878328e7f9db9066325c9788
MD5 4211c58214e1e2c9f410c161d8dbf6f2
BLAKE2b-256 5f2586d32fd0c4523bb6d8b7951bccbcb663c53b384be537a2dce8de76cbb989

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 c112f884f759ac5700aa0772a9a816bc86e7713c445d9905eb4a5f7f2f6d5d1b
MD5 456ffde77c08a1b7dc8bfa3ece69e34b
BLAKE2b-256 222bd58b3f9ad4625a0bca3f917c1a053b9149526f16b0c1cbead99063c8dee3

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 2957c29de12a0d1172173bc3d27ac3161ab46f9789123cbb84fd18c8a998e723
MD5 b1d3a7ea98d38b9355bc9353a91af228
BLAKE2b-256 da5c492e379a1c8daa17be5e399f0f020553a5c557d11b0f56a86d0f63159307

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 ae65ebbf12189a5ea50b88f89fa469c1c77827fe930c9b420d944f78dd04eeee
MD5 c5dc37484eea9a91a9ff47940a5731b0
BLAKE2b-256 dff7bc8475fceeedf3e21934f4cc61bb3c39b4665bd23ff2ef2003ab1d179cff

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d9b89c586cc453edcbeee5b4c8fcfee36257bbde64af5eec12a7e608d1f8104a
MD5 4d47387e8c2eda2c6abbbf1570fde582
BLAKE2b-256 ddbaa41f5ede4fa15466308496e88c7697cb5bb62aee4709a61af488fddf4522

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 70e5fe3303d8b8f4fbe50310d1fd1ca91df71554f84ab3c707e2d48a9d4d3a5a
MD5 bff3ac64d5985b15bfa3bc98b28d4169
BLAKE2b-256 8884e28707b9badfb526daba006aad4d8b2db80eb7f94b1efde12a33a7fce656

See more details on using hashes here.

File details

Details for the file thumbor-7.4.1-cp37-abi3-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for thumbor-7.4.1-cp37-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 4173a5013e2dc059be03059e3c4ec62399d9e057887dbe42b28731fd2bdb6446
MD5 5728bfb0b19cea35b1186b0f7fbc152e
BLAKE2b-256 586091952b6c9c6b028efacbac2989dd4ba7afe6806b5244ee2de9c14179bcde

See more details on using hashes here.

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