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

Uploaded Source

Built Distributions

thumbor-7.5.0-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.5.0-cp37-abi3-musllinux_1_1_i686.whl (8.5 MB view details)

Uploaded CPython 3.7+ musllinux: musl 1.1+ i686

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

Uploaded CPython 3.7+ musllinux: musl 1.1+ ARM64

thumbor-7.5.0-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.5.0-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.5.0-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.5.0-cp37-abi3-macosx_11_0_arm64.whl (8.4 MB view details)

Uploaded CPython 3.7+ macOS 11.0+ ARM64

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

Uploaded CPython 3.7+ macOS 10.9+ x86-64

thumbor-7.5.0-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.5.0.tar.gz.

File metadata

  • Download URL: thumbor-7.5.0.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.5.0.tar.gz
Algorithm Hash digest
SHA256 8294eab7f9938a433ade506fdc44c00a2ca99e4cebdd22f2d1b1bf3476b20bfa
MD5 d9dfc54ca469620b5f64b75f9d8a9692
BLAKE2b-256 6d320d518e11f75f270456f18221a13704f06da34eba6fefa40ea42bd5a4cb5a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 4d61d18c1d83250b1f58cbaa544f8de89a2cddf281eb48ea0700d4ae3334ee9e
MD5 264d4b137e3c4581f7b122c6f6d02140
BLAKE2b-256 d17915099cd5040b5233ad5e6a0a5898e8fb4a79970b43776f0d10d80996832d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 c15d97c4d5ad3be6ab0efee19ce94f98677e2effc554885504b8c5c14c95016b
MD5 0c736976ca460106257649f16273e114
BLAKE2b-256 44af936ab3c1aca416c65989d591ce89231843442b8ce9c898c72e177b91725b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 09e7e6dd0c04871c0ef09d1180809587cb4503ed8b5ae44c80d2d3fc0c0c6ba6
MD5 e922c5994e7c853b36d73274d639c1d3
BLAKE2b-256 d163aadfa28c59c049e61c21667678a3dc3a29c2dc115e572a7c0c5cd373c35c

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ad2ede7d7d7a74a6d4341ca80d6fdf510728661393442ee3f1666fd21b335a2b
MD5 9ed475c8c224abf78fd1661a0ee64b67
BLAKE2b-256 ec72cb33ac60cd180e26171d061c397341c37ea478110c0ca5c8bf0d11793cd6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 4e44e5f8dbdeafc8ef96e1beea54bf9e95deb94f42e5e3fee31e5ad57d2919da
MD5 29aa381ac517b74cddeaa0bd6c2a2b77
BLAKE2b-256 bcb61a9c9f8cee4f778594d23c55d32df48b5b437ec3a587fd8e1c2a47500809

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 b49346f5c1d3dbb651cc083b138517b3dddd770a0761a051a3a7aff4e867020f
MD5 e9a60ec9898bac009983116f2160b9b3
BLAKE2b-256 fb21c0ead776efa4173279f4b7d92ce3b0d46c94c5305fa68c1f5f40ad36bda6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 bb3f84e802c037b0a33da21273190cce0d51c53b1dccb3c969e66f0bfa28acdb
MD5 5ea50f72683ab80adc9d1fca2152fcc1
BLAKE2b-256 67b8b75c4e0a33cef0f17a46d478557b4d0e4aed35dac19af79bdb835aa04869

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 b7d1d013cfa16e10644be8798df3a857e21c6945c87db2cb00592426e0de0487
MD5 be714d9b79d21353d1829deadbe5f6cc
BLAKE2b-256 aef1175d091463ffabab5f1d30327366465265956ea473e5fc24cfb2b9332f62

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for thumbor-7.5.0-cp37-abi3-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 a30cc369e2f0ac34ccfd5091db0890e6172cee41c752b7e4cc02a5aa362535fd
MD5 5a47c9682801c67526ea3ab3c36aaf7a
BLAKE2b-256 c77a02df85d9dbf1ea107e3115c15ffe84d5b61b160e28cf5c00d59d74a7b077

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