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.1

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

Uploaded Source

Built Distributions

thumbor-7.7.1-cp38-abi3-musllinux_1_1_x86_64.whl (8.6 MB view details)

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

thumbor-7.7.1-cp38-abi3-musllinux_1_1_i686.whl (8.5 MB view details)

Uploaded CPython 3.8+ musllinux: musl 1.1+ i686

thumbor-7.7.1-cp38-abi3-musllinux_1_1_aarch64.whl (8.6 MB view details)

Uploaded CPython 3.8+ musllinux: musl 1.1+ ARM64

thumbor-7.7.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (8.5 MB view details)

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

thumbor-7.7.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (8.5 MB view details)

Uploaded CPython 3.8+ manylinux: glibc 2.17+ ARM64

thumbor-7.7.1-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (8.6 MB view details)

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

thumbor-7.7.1-cp38-abi3-macosx_11_0_arm64.whl (8.4 MB view details)

Uploaded CPython 3.8+ macOS 11.0+ ARM64

thumbor-7.7.1-cp38-abi3-macosx_10_9_x86_64.whl (8.4 MB view details)

Uploaded CPython 3.8+ macOS 10.9+ x86-64

thumbor-7.7.1-cp38-abi3-macosx_10_9_universal2.whl (8.5 MB view details)

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

File details

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

File metadata

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

File hashes

Hashes for thumbor-7.7.1.tar.gz
Algorithm Hash digest
SHA256 e6ba1571e8d3f7b39ad714851f34984831dc202ab850cfc0957283e01a19d57b
MD5 28879dd96f2698053048762fb4b3261a
BLAKE2b-256 6441a5b9522a471697f313958dbce8368657e70091d7e7215361b2dc9179496b

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 1627b7454e6b6db1363537d79f13ffcf929c02a4ac2be9707a20537dddefef0f
MD5 5511a367f00b42606a32aaa6700a3f4a
BLAKE2b-256 4a4a7f92a698d829ddecb0c17d99c92195fa5f81fd6b54794d3d095d173f0080

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-musllinux_1_1_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 c34a53e83cbd11a76623836e893b925d994fb90b1191838dca223632dc6e3c4d
MD5 55ff19372db9f6d4e0f17429650e871d
BLAKE2b-256 0fa476b91bfc3d3f1d5fce0b31e36424c479599a9fb6ce718d7a6df12b3f029f

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 85be425c38c0e2599e7d4270df03d247fc0595c889d172b467aa03a7eac226ca
MD5 b86decca53bcff095640fa3801464c73
BLAKE2b-256 b0407cbd1263872ea5e0789c90d0f6b897e6de09d8b2b1343209fd281c265fe5

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d9effc8d1097ff7300cb18017dfe9e492cdb0b34d29dc145e17eebc8b1678df9
MD5 2d74efdd985c92ddefe4554406041657
BLAKE2b-256 ce12e0b00138923379f28100ea0a456879d46011f72ff048a38d82ad816bf13b

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 6ec65537adeb5c9bb0eb38211a1a39e8b40c44ab040d999990054ebfb871da47
MD5 2fd200631889f802d86167d1040716ba
BLAKE2b-256 a7e1a15c0b759e678da5f869e352145fba01bfe9456211b740dc9636e2d71788

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 0f9558488957a73650f8ad7a10c3c25c7f1422d97c0e06b751b1bc8bfac436ad
MD5 10c6399e9f79f24c1e790cd2452c4f3a
BLAKE2b-256 0e28c7e5e0fe22c30803e03a69f72213b1a0080d5ef11e877e6c3228041062f5

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bdb21e20b2f2c8694a12e92978e32252b7d98f8d98065ecb9cbd26f1a007833b
MD5 d073380fde5a89a8108968775c6cfd36
BLAKE2b-256 9d850585f1d01de9b1d93b0f8605e9a82eb959e05bfac45438dc8a407448c7fd

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 001005d7f330c16334d58563229d7c0b1aa4715c908ac7bbb6ecb17b1a02ca36
MD5 cd2fa73e4aabb44ac679c23fccb14dc5
BLAKE2b-256 b1cfd1194c5ff000d4bc1df7b7b896fdc36a521abad311a3eee84120afb0a2d7

See more details on using hashes here.

File details

Details for the file thumbor-7.7.1-cp38-abi3-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for thumbor-7.7.1-cp38-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 3a3d767d5d1218059017c51b7f94e622274c5a87e0671ed8b6187a02c52a3f85
MD5 d147e6ef8de1f803a052939403987145
BLAKE2b-256 f5603f0cc8abd23ae7be262e9d7d8527cab2437fbe743961437ebbe948228a37

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