humanmade /tachyon
Faster than light image resizing service that runs on AWS. Super simple to set up, highly available and very performant.
★ 298⑂ 4👁 23⑃ 585● 82▤ 32
+0
Daily
298
stars
4
forks
23
watchers
585
prs
82
issues
32
releases
README
Tachyon
Faster than light image resizing service that runs on AWS. Super simple to set up, highly available and very performant.
A Human Made project. Maintained by @joehoyle.
Tachyon is a faster than light image resizing service that runs on AWS. Super simple to set up, highly available and very performant.
Setup
Tachyon comes in two parts: the server to serve images and the plugin to use it. To use Tachyon, you need to run at least one server, as well as the plugin on all sites you want to use it.
Installation on AWS Lambda
We require using Tachyon on AWS Lambda to offload image processing task in a serverless configuration. This ensures you don't need lots of hardware to handle thousands of image resize requests, and can scale essentially infinitely. One Tachyon stack is required per S3 bucket, so we recommend using a common region bucket for all sites, which then only requires a single Tachyon stack per region.
Tachyon requires the following Lambda Function spec:
- Runtime: Node JS 24
- Function URL activated
- Env vars:
- S3_BUCKET=my-bucket
- S3_REGION=my-bucket-region
- S3_ENDPOINT=http://my-custom-endpoint (optional)
- S3_FORCE_PATH_STYLE=1 (optional)
Take the lambda.zip from the latest release and upload it to your function.
For routing web traffic to the Lambda function, we recommend using Lambda Function URLs. These should be configured as:
- Auth type: None
- Invoke mode: RESPONSE_STREAM
Alternatively, you can use API Gateway; this should be set to route all GET requests (i.e. /{proxy+}) to invoke your Tachyon Lambda function.
We also recommend running an aggressive caching proxy/CDN in front of Tachyon, such as CloudFront. (An expiration time of 1 year is typical for a production configuration.)
Documentation
Plugin Setup
Using Tachyon
Hints and Tips
Credits
Created by Human Made for high volume and large-scale sites. We run Tachyon on sites with millions of monthly page views, and thousands of sites.
Written and maintained by Joe Hoyle.
Tachyon is inspired by Photon by Automattic. As Tachyon is not an all-purpose image resizer, rather it uses a media library in Amazon S3, it has a different use case to Photon.
Tachyon uses the Sharp (Used under the license Apache License 2.0) Node.js library for the resizing operations, which in turn uses the great libvips library.
Interested in joining in on the fun? Join us, and become human!
Looking for a different Tachyon?
Tachyon by Human Made provides image resizing services for the web, and is specifically designed for WordPress. "Tachyon" is named after the hypothetical faster-than-light particle.
Other software named Tachyon include:
Tachyon by VYV - Video playback and media server.
Tachyon by Cinnafilm - Video processing for the cinema industry.
TACHYONS - CSS framework.Top issues
#3Support for animated gifs10 comments · 2016-02-15#67Support for colour grading using LUTs3 comments · 2018-09-20#543Smart Cropping Unexpectedly Applies Rule of Thirds with no off mechanism2 comments · 2025-10-01#125AVIF support2 comments · 2020-09-09#156BUG: Requesting image that doesn't exist returns `Content-Type: json`1 comments · 2023-01-20#143Accept standard argument formats for "false" attributes passed through query args 1 comments · 2022-04-22#123Support rotation1 comments · 2020-09-01#643Fix deprecated option on Charp to upgrade version 0.35.30 comments · 2026-07-23
Latest release
3.0.8 v3.0.8 2025-07-15What's Changed Bump eslint-plugin-jsdoc from 50.6.3 to 50.6.9 by @dependabot[bot] in https://github.com/humanmade/tachyon/pull/424 Bump ts-jest from 29.2.5 to 29.2.6 by @dependabot[bot] in https://github.com/humanmade/tachyon/pull/415 Bump @types/aws-lambda from 8.10.147 to 8.10.148 by @dependabot[bot] in https://github.com/humanmade/tachyon/pull/426 Bump typescript from 5.7.3 to 5.8.3 by @dependabot[bot] in https://github.com/humanmade/tachyon/pull/433 Bump lambda-stream from 0.5.0 to 0.6.0 by @dependabot[bot] in https://github.com/humanmade/tachyon/pull/428 Bump ts-jest from 29.3