Benchmarking TiTiler-based dynamic tiling services.

titiler-benchmark

Benchmarks comparing TiTiler-based dynamic tiling services: request latency (via pytest-benchmark) and load/throughput (via siege).

Two scenarios are covered:

• cog/ — tiling a single Cloud-Optimized GeoTIFF, comparing titiler vs async-titiler.
• mosaic/ — tiling a mosaic backed by a STAC search, comparing titiler-pgstac, titiler-stacapi, and async-titiler-stacapi.

Each scenario has its own docker-compose stack, benchmark suite, and siege URL list — see the READMEs in cog/ and mosaic/ for how to run them locally.

CI & results

On every push to main, benchmark-cog.yml and benchmark-mosaic.yml run both benchmark suites and siege load tests, then publish results to the gh-benchmarks branch. On pull requests, the same workflows run to validate the change without publishing results.

Requirements

• uv
• Docker / Docker Compose
• siege for load testing

Setup

uv sync