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 http://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.7.7.tar.gz (29.2 MB view details)

Uploaded Source

Built Distributions

thumbor-7.7.7-cp39-abi3-musllinux_1_2_x86_64.whl (8.2 MB view details)

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

thumbor-7.7.7-cp39-abi3-musllinux_1_2_i686.whl (8.2 MB view details)

Uploaded CPython 3.9+ musllinux: musl 1.2+ i686

thumbor-7.7.7-cp39-abi3-musllinux_1_2_aarch64.whl (8.2 MB view details)

Uploaded CPython 3.9+ musllinux: musl 1.2+ ARM64

thumbor-7.7.7-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.2 MB view details)

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

thumbor-7.7.7-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (8.2 MB view details)

Uploaded CPython 3.9+ manylinux: glibc 2.17+ ARM64

thumbor-7.7.7-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (8.2 MB view details)

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

thumbor-7.7.7-cp39-abi3-macosx_11_0_arm64.whl (8.1 MB view details)

Uploaded CPython 3.9+ macOS 11.0+ ARM64

thumbor-7.7.7-cp39-abi3-macosx_10_9_x86_64.whl (8.1 MB view details)

Uploaded CPython 3.9+ macOS 10.9+ x86-64

thumbor-7.7.7-cp39-abi3-macosx_10_9_universal2.whl (8.2 MB view details)

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

File details

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

File metadata

  • Download URL: thumbor-7.7.7.tar.gz
  • Upload date:
  • Size: 29.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for thumbor-7.7.7.tar.gz
Algorithm Hash digest
SHA256 76bc6118ca5ea7a47cc3febdcb9516f8b8c114ffad09bc5903ab28e4fc927cc6
MD5 05f0658c8a9ac18cd5c30eca56c2572a
BLAKE2b-256 4e26e10a984ffb3fbfcd90e14ebbb8c1f0dcd7aa060fbb3e684ca7ab51c899ca

See more details on using hashes here.

File details

Details for the file thumbor-7.7.7-cp39-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 efa2b247007ae63503e5ff2d6d2cea0265ba289395c3d0bf89fff0ea58405ce9
MD5 6d1fffcc9ac13b85acb1f9a863b9a37b
BLAKE2b-256 c3b94b7714d45f27bc55014f65953b9a9a9ad548ad2374a0845dfecaeb83b8f7

See more details on using hashes here.

File details

Details for the file thumbor-7.7.7-cp39-abi3-musllinux_1_2_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-musllinux_1_2_i686.whl
Algorithm Hash digest
SHA256 15c8d4206c0c17ddd74ea9be5cb75f945481b40a9297b403a696b9fcf486803f
MD5 528ac3d511622c744cfba572000b4fff
BLAKE2b-256 1393bbcb3c323861beb8d2b39215764c407f3e5509c97b65f58c4ea81e8a6c7f

See more details on using hashes here.

File details

Details for the file thumbor-7.7.7-cp39-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 16b88d517e8dcc773176a5572637244393017f8ad321c6e16e8c5fe9536105ec
MD5 ddbe850668e00d60ecfbd2f201bad35b
BLAKE2b-256 c959375ad0d5e9d24adec07b2db70caae2b3f5b6ce001b95f5c6eb943a2a527d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 bdfb003e9727e8fa870b05bbdc566f237496c1f1b6ea9aa45c9590d1b6d5733f
MD5 bf696e4a058a1c63386a27e462f9925a
BLAKE2b-256 9c1727b182a9760ee6f89c101f96a8473780875f65d26ff7fae62f4673aa91b7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 171adce6c1b28b71a387c27a73eaf468309a9c0fb22a3d91e6a067a09a3f8ce2
MD5 e05e524b02808ef6104632f80715d245
BLAKE2b-256 93bda9136ac2f4fc97d6655bd107c93c7ea313d0503a935e144f2dd1841ee63a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 ba3c193d6f3f8dad8ecc301681877336e09c603df49e664c6b55a0e9c3127736
MD5 94c4bab00b4e9f296962bab8036edc65
BLAKE2b-256 469f9251eb5976df6de26266d8977a321bae34e4d754ad7a0b6e2a9d2d12b5fb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1498f3fdee12d56fe4311d3a140b3dfcda7ffb20315e99ff37c96ce9d6448204
MD5 08467edb563dcd0e7aed909d259577d0
BLAKE2b-256 886c06fefc8ec4c465b3891c0cbba7f975c065c074308d8d901a407f50510411

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 1f755b685a53bbf82df317d6b46c9f768268d862843237cb95affa72a8ca1526
MD5 d308a1f111b48fb6391f70eff85e794b
BLAKE2b-256 fee9d6411e2bfee29e0b1adbefea91322c01c9763111b08c302b862dc30dd0f1

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.7.7-cp39-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 a10f4a8ddcbc4ae7cbcaeab453ab269b7f3d9fc3130d2c81b3486c085a653742
MD5 0f2b42c512468a8f729883282f1b4a8b
BLAKE2b-256 ca05fc4bca86edb5127d14e3e1b19e66123a619355710d10062ef6d52513ecc1

See more details on using hashes here.

Supported by

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