Freedom251 › Image Compression Software
Thumbor
by Thumbor

What Thumbor is
Thumbor is a free, open-source image service for processing images on demand. It can crop, resize, and flip images, with smart cropping that checks for faces before falling back to feature detection. Filters can be combined, including brightness, contrast, grayscale, red-eye, and blur. Thumbor supports WebP delivery to browsers that accept the format, along with the listed AVIF support. Its loaders and storages have file, HTTP, Redis, and Mongo implementations. Teams can add custom filters, storage systems, loaders, engines, detection, and optimizers. Image URLs can be signed with a SECURITY_KEY and HMAC to help guard against tampering. The default HTTP loader uses HTTP; HTTPS and strict HTTPS options are also described. Thumbor is distributed as a Python package, and current releases require Python 3.10 or newer. It is available for API, Linux, and self-hosted use. The project lists an MIT license, and its free plan costs nothing.
Who it suits
Thumbor suits developers and operations teams that want to manage image processing in a self-hosted setup. Its extension points may also suit teams with custom processing needs.
What it does well
- On-demand cropping, resizing, and flipping
- Smart cropping prioritizes face detection
- Chainable filters include blur and grayscale
- Custom loaders, storages, engines, and optimizers
- Free plan listed as free
What to know first
- Current releases require Python 3.10 or newer
- Default HTTP loader uses HTTP
- Self-hosted setup is listed as a platform
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Thumbor | Open-source image service; self-hosted | Free |
As thumbor.org lists them, read 9 Oct 2026. The maker's own page has the final word.
Getting started
- Visit https://thumbor.org/.
- Install Thumbor as a Python package.
- Use a Linux, API, or self-hosted setup.
- Configure loaders and storage for your environment.
- Set a SECURITY_KEY to sign image URLs if needed.
Thumbor is a free, open-source image service that processes requests as they arrive rather than relying on a desktop editor or a fixed asset pipeline. It is most suitable for developers and operations teams comfortable running a self-hosted Python application. The trade-off is clear: you get broad control and extensibility, but deployment and ongoing service ownership remain yours.
Overview
Thumbor runs as an API on Linux or another self-hosted environment, with image transformations controlled through URLs. Its MIT licence permits use, modification, and redistribution without a software fee. That makes it a practical foundation for organizations that want image handling inside their own infrastructure instead of sending assets to a hosted processor.
The service is a better fit for teams with operational capacity than for individuals seeking a turnkey web tool. Current releases require Python 3.10 or newer, so the runtime requirement belongs in deployment planning. Thumbor's maker is based in Rio de Janeiro, Brazil.
Key features
On-demand cropping, resizing, and flipping let one source image serve multiple dimensions. Smart mode first looks for faces and then uses feature detection when no face is found, helping keep an important subject in frame across generated crops. For straightforward dimension changes, standard resizing avoids the need for detection.
Filters can be combined in a chain. Brightness, contrast, grayscale, red-eye correction, and blur cover common adjustments without a separate editing pass. Thumbor also supports responsive images, automatic optimization, AVIF, and WebP delivery to browsers that support WebP, giving delivery pipelines options for modern formats and varying screen sizes.
Loaders and storage implementations include file, HTTP, Redis, and Mongo. That range can align the service with existing asset sources, caches, or databases, but selecting and operating the appropriate backend is part of the self-hosted responsibility. Extension points cover custom filters, storages, image loaders, engines, detection, and optimizers, so teams with specialized processing needs can change more than the default transformation set.
URLs can be protected with a SECURITY_KEY that signs them with HMAC, which helps stop clients from altering transformation requests. The default HTTP loader uses HTTP; the documentation also describes HTTPS and strict-HTTPS loader options for deployments that need encrypted image retrieval. Security issues can be reported to the project team or through an issue.
Pricing
Thumbor costs nothing under its Thumbor plan. The plan is an open-source image service that you host yourself, with no seat, usage quota, renewal charge, or trial period stated. The real cost is infrastructure and administration: your team supplies the runtime, storage, loaders, and maintenance needed to keep the service operating.
Platforms
Thumbor is offered as an API for Linux and self-hosted deployments. It is distributed as a Python package, and current releases require Python 3.10 or newer. This combination suits teams already standardizing on Python and Linux; it is less suitable if you need a managed, browser-only service.
Who it's for
Developers can embed URL-driven transformations and build custom processing components. Operations teams can select loaders and storage that fit their infrastructure and enforce signed URLs. Designers and project managers may benefit when one service must deliver responsive, optimized variants, but they will depend on technical staff to deploy and maintain it. Choose Thumbor when control, extensibility, and self-hosting matter more than a managed setup.
Pros and cons
Pros
- Broad transformation control: Cropping, resizing, flipping, smart detection, and chained filters cover both automated and directed image workflows.
- Modern delivery support: Responsive images, automatic optimization, AVIF, and WebP serving help adapt output to current delivery requirements.
- Extensible architecture: Custom filters, loaders, storages, engines, detection, and optimizers allow specialized pipelines.
- Open-source economics: The MIT licence and free plan avoid a software subscription.
- Request protection: HMAC-signed URLs can reduce tampering with transformation parameters.
Cons
- Self-hosting required: You must run and maintain the service, storage, and supporting infrastructure.
- Python dependency: Current releases require Python 3.10 or newer, which can complicate environments on older runtimes.
- Loader security needs care: HTTP is the default loader protocol, so secure deployments need to configure the documented HTTPS options.
Alternatives
Choose Optimole if you want a web-based freemium service: its Free plan allows 2,000 monthly visits, unlimited images, and unlimited sites, while Starter covers 48,000 visits per month at custom pricing.
TinyPNG is the simpler API-oriented choice when session limits are acceptable: its free tier permits 20 compressions per session, 5 MB per image, and three conversions per session.
Pick pngcrush for a free, open-source command-line option across Linux, macOS, and Windows rather than an on-demand service.
Fastly Image Optimizer suits teams wanting a hosted API with 100,000 free image requests per month and usage-based pricing beyond that.
JPEGmini is aimed at desktop and web users who prefer an image-compression workflow; its free plan allows 50 images per day on one device after a seven-day Pro trial.
Use Squoosh for browser-based, local compression, FileOptimizer for unrestricted Windows file optimization, or Curtail for Linux compression of PNG, JPEG, WebP, and SVG files.
For broader category browsing, see Image Compression Software and Photo Resizing Software.
Verdict
Thumbor is a strong choice for development and operations teams that need free, self-hosted, URL-controlled image processing with room for custom detection, storage, and optimization. Its main reason to choose it is the combination of smart transformations and deep extension points. Look elsewhere if you want managed hosting, a graphical workflow, or minimal operational responsibility.
Verdict
Thumbor combines on-demand image transformations with configurable detection, filters, loaders, and storage. Its free, self-hosted model fits teams prepared to manage the service and meet its Python requirement.
Questions
How much does Thumbor cost?
The Thumbor plan is free.
Is Thumbor open source?
Yes. The project describes it as open source and lists an MIT license.
Which platforms does Thumbor support?
Its listed platforms are API, Linux, and self-hosted use.
What image formats does Thumbor support?
It supports WebP delivery to browsers that support the format and lists AVIF support.
What Python version do current releases require?
Current releases require Python 3.10 or newer.
Can Thumbor use different storage and loaders?
Listed implementations include file, HTTP, Redis, and Mongo. Custom storage and image loaders can also be added.
Facts from Thumbor's own pages
- Automatic optimization
- Yes · github.com, 20 Sept 2026
- AVIF support
- Yes · github.com, 20 Sept 2026
- Extensibility
- Thumbor supports custom filters, storages, image loaders, engines, detection, and optimizers. · thumbor.readthedocs.io, 9 Oct 2026
- Filters
- Filters can be chained and include brightness, contrast, grayscale, red-eye, and blur. · thumbor.org, 9 Oct 2026
- Free plan
- Yes · github.com, 20 Sept 2026
- Headquarters
- Rio de Janeiro, Brazil · thumbor.org, 28 Sept 2026
- HTTPS loading
- The documentation says the default HTTP loader uses HTTP and describes HTTPS and strict HTTPS loader options. · thumbor.readthedocs.io, 9 Oct 2026
- Image formats
- Thumbor supports WebP and can serve it to browsers that support the format. · thumbor.org, 9 Oct 2026
- Image processing
- Thumbor provides on-demand image cropping, resizing, and flipping. · thumbor.org, 9 Oct 2026
- Installation
- Thumbor is distributed as a Python package and current releases require Python 3.10 or newer. · thumbor.readthedocs.io, 9 Oct 2026
- Intended users
- The site describes use cases for developers, operations teams, designers, and project managers. · thumbor.org, 9 Oct 2026
- Open source
- The project repository describes Thumbor as an open-source photo thumbnail service and lists an MIT license. · github.com, 9 Oct 2026
- Responsive images
- Yes · github.com, 20 Sept 2026
- Security reporting
- The security page asks users who find flaws or vulnerabilities to contact the team or create an issue. · thumbor.readthedocs.io, 9 Oct 2026
- Smart cropping
- Smart mode uses face detection first and feature detection if it finds no faces. · thumbor.readthedocs.io, 9 Oct 2026
- Storage and loaders
- The site lists file, HTTP, Redis, and Mongo implementations for loaders and storages. · thumbor.org, 9 Oct 2026
- URL signing
- A SECURITY_KEY can sign image URLs with HMAC to help prevent URL tampering. · thumbor.readthedocs.io, 9 Oct 2026
- URL transformations
- Yes · github.com, 20 Sept 2026
Where Thumbor stands on Freedom251
- Image Compression Software#6 of 85
- Photo Resizing Software#12 of 28
- Image CDN services#16 of 26