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

This version

7.7.4

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 details)

Uploaded Source

Built Distributions

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

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 details)

Uploaded CPython 3.9+ musllinux: musl 1.1+ i686

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

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 details)

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 details)

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 details)

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 details)

Uploaded CPython 3.9+ macOS 11.0+ ARM64

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

Uploaded CPython 3.9+ macOS 10.9+ x86-64

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

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

File details

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

File metadata

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

File hashes

Hashes for thumbor-7.7.4.tar.gz
Algorithm Hash digest
SHA256 685377f3b15ac1bb24571a4691a3f6047343802c662616793f89abf7b4edc22d
MD5 b26d00633ecfb9db5fba5932cdf7e3ed
BLAKE2b-256 7ede05d39634cde28939c8b646f153563f616b98f82bf6cbce7e21e474ba5095

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 cb2fd227035916e43c91f5164e20ca849310b65f3e1945370e7c734f66f737c7
MD5 8a9c2db3f1a17332206d8f41a1566877
BLAKE2b-256 eb6e7994a43c9f8d9cd0a4b3cb65dad9df94a250ef08486f72efd12ea367cb14

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-musllinux_1_1_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 71679b6d0f21abdf5cba7e1cf86430926f13a52fd65aa47198704077cd921823
MD5 a058c9048d008b9743e6f4cf34577592
BLAKE2b-256 fb28a374b03c73e2d78a7edae3ca883481ef6f3c45a45d425a05f7cfcbed5ac2

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 7d1f3344cf1924c12832c946ca3aac9ab530a2d6865988ef2551085bea064965
MD5 8550c0a7110c7d84267b2a15d221ad74
BLAKE2b-256 5dfa900f50e3d85cf58cdccec40f3507ac8ff1163ea252b8f1c9c72704f9c4d2

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 cf1daf2d5b340bf537df4f8f7b19ace5bf0808049a27eb8b864836bf82aea450
MD5 d32f3586789adb883e41e300f5dcdfc7
BLAKE2b-256 8da81636406ccfdd47c27deb01ad752414dd14c9307c29431f4baba839b93304

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 6e8a78f911714d3f9770beaaf3ac791591cb1282bb7804525796378f7c96f3dd
MD5 cbe09522a68c3968f281ba99801c7d11
BLAKE2b-256 0b71bb36caac901ef214007f1d507dd01fc8c0aafc59222bd0559317204712ff

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 294b3b1a10a768208d7c7f8f89ae696aeb5ed5c7fddc70c05a9a34899e2ee3ce
MD5 1d9a0bf024c5a7a1142a587f5961c135
BLAKE2b-256 95c8f28e2678f5d24b6395d6119984cd86d818914276d14bbe5074bd134ac627

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 75ad44bbbfc6a1e747ef254b7e57152b2e01c2654bb3020c3d5ff79f4efd5153
MD5 03ccf54734f2c8192683fc357e897fd8
BLAKE2b-256 59c240dd8bbcabf93f86d163719b0160734ea652b29a6849a46ba8bd1bd5b949

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 4cf9745334f2e16b9c8b98b675dbb26717cd23b56da81df174ef4eb27217c0a4
MD5 605ec28399c0e9c492af710ce78d2ecb
BLAKE2b-256 e9f3a35ad9cfe217bb22855e4a320c90ae7d9d5b133c01ef607ab25b31da821f

See more details on using hashes here.

File details

Details for the file thumbor-7.7.4-cp39-abi3-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for thumbor-7.7.4-cp39-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 de894cd34480b10ca0067eaf443970c6cb84490e702d2defb7fc6948d6d8ade4
MD5 7cea15e484c35a5f0e5383978e97c07a
BLAKE2b-256 555feef20719960519fc8db5672bfeb2a9c31e6342ad3f4e14b17f68723a220d

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