Join thumbor-bootcamp for a learning and contribution experience with ❤️ and 🤗 from the thumbor team
thumbor is a smart imaging service and 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.
Decide which installation option you want to use.
# thumbor with main dependencies only
pip install thumbor
# thumbor with opencv dependency
pip install thumbor[opencv]
# thumbor with all dependencies
pip install thumbor[all]
sudo add-apt-repository ppa:thumbor/ppa
sudo aptitude update
sudo aptitude install thumbor
For more ways, please check out Installation.
Running it is as easy as hit:
thumbor
After this, you can reach it on https://localhost:8888/unsafe/https://github.com/raw/thumbor/thumbor/master/example.jpg
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
- 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-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 clear indication of each project quality. Have fun!
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
You can see thumbor in action at http://thumborize.me/