thumbor is an open-source photo thumbnail service by globo.com
Go to file
dependabot[bot] 07cf1c2d4d
Bump pypa/gh-action-pypi-publish from 1.8.12 to 1.8.14 (#1662)
Bumps [pypa/gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish) from 1.8.12 to 1.8.14.
- [Release notes](https://github.com/pypa/gh-action-pypi-publish/releases)
- [Commits](https://github.com/pypa/gh-action-pypi-publish/compare/v1.8.12...v1.8.14)

---
updated-dependencies:
- dependency-name: pypa/gh-action-pypi-publish
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Marcelo Jorge Vieira <metal@alucinados.com>
2024-04-17 21:52:58 -03:00
.github Bump pypa/gh-action-pypi-publish from 1.8.12 to 1.8.14 (#1662) 2024-04-17 21:52:58 -03:00
docker Bump to 7.7.0 (#1612) 2023-10-31 10:01:09 -03:00
docs feat: enable auto-png configuration (#1652) 2024-03-04 15:38:13 -03:00
integration_tests keep exit copyright information (#1507) 2022-12-06 10:02:24 -03:00
perf Documention spell check (#1501) 2022-11-01 21:36:51 +01:00
tests feat: enable auto-png configuration (#1652) 2024-03-04 15:38:13 -03:00
thumbor Release 7.7.4 2024-03-04 17:13:09 -03:00
.codacy.yml [IMPR] Removed callbacks for async/await 2020-02-13 21:49:32 +00:00
.commit-template [FEAT] URL Routers support (#1261) 2020-02-26 22:26:17 +00:00
.continuousrc Configurações do ci. 2011-07-29 17:36:46 -03:00
.coveragerc Move integration tests out of the package 2016-07-06 10:02:38 +02:00
.flake8 Add black formatter (#1428) 2022-03-31 14:58:30 +02:00
.gitignore [IMPR] Compatibility loader,storage,res storage (#1342) 2021-11-23 21:23:33 -03:00
.pre-commit-config.yaml chore: Reformat files according to new Black Code Style 2024-01-27 23:42:10 +01:00
.readthedocs.yaml docs: Add a v2 .readthedocs.yaml config file 2023-07-23 22:53:04 +02:00
.venv fish environment file 2014-08-09 12:04:45 -03:00
.yamllint Added yaml linter and made stale check less agressive. 2022-01-24 19:03:13 -03:00
CHANGELOG [IMPR] Removing changelog for Releases Page 2020-02-27 20:11:45 +00:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md (#1509) 2022-12-21 13:01:02 -03:00
CONTRIBUTING.md bump dependencies 2024-01-09 10:15:26 -03:00
LICENSE LICENSE file 2014-03-19 16:00:52 -03:00
MANIFEST.in Include WebP files in MANIFEST.in (#1426) 2022-04-06 18:37:50 -03:00
Makefile feat(engines/pil.read_multiple): Use Pillow to save multipage images as GIF 2024-01-23 20:39:12 +01:00
README.mkd Update URL of Node's favicon (#1575) 2023-06-30 10:13:13 -03:00
TestDockerfile Release Thumbor wheels and add support to Python 3.11 (#1498) 2022-12-20 03:21:17 +01:00
build.py Reformat to 80 chars and mypy.ini 2022-01-30 00:08:05 -03:00
example.jpg [FIX] Updated photo to have face 2020-02-15 21:19:34 +00:00
issue_template.md issues template 2016-02-17 13:13:48 -05:00
logo-thumbor.png logo 2014-03-12 17:14:46 -03:00
mypy.ini Reformat to 80 chars and mypy.ini 2022-01-30 00:08:05 -03:00
pylintrc Fixed pylint execution error (#1464) 2022-07-06 17:26:34 -03:00
pyproject.toml Run tests on Python3.12 (#1608) 2023-10-30 09:00:14 +01:00
redis-sentinel.conf added sentinel support (#1439) 2022-07-06 17:44:30 -03:00
redis.conf Partial support to using WebP (#140). Added support for "format" filter. 2013-07-02 18:49:37 -03:00
requirements Drop Python 2 support 2020-02-03 21:51:08 +00:00
scaling.rst [IMPR] Revising docs for 7.0.0 release (#1267) 2020-02-25 15:03:31 +00:00
setup.cfg [IMPR] Removed callbacks for async/await 2020-02-13 21:49:32 +00:00
setup.py bump dependencies 2024-01-09 10:15:26 -03:00
thumbor.key Fixes thumbor-url and adds options to key file and adaptive urls 2012-03-23 15:36:09 -03:00
unwanted_packages removing Riak from unwanted packages 2012-10-24 14:56:46 -02:00

README.mkd

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/