Repolode
Submit
developmentseed

developmentseed/titiler

A Python FastAPI toolkit for building dynamic map tile servers that serve Cloud Optimized GeoTIFF, STAC, Zarr and MosaicJSON data.

View on GitHubWebsite
Stars
1,205
Forks
255
Open issues
26
Last commit
5 days ago

What is it?

TiTiler is a set of Python packages for building FastAPI applications that generate map tiles on the fly from raster datasets. Instead of pre-rendering tiles, it reads imagery at request time, so a single source file can serve any tile, projection, or band combination on demand.

The project is split into namespace packages: titiler.core handles Cloud Optimized GeoTIFF and STAC, titiler.xarray covers Zarr and NetCDF multi-dimensional data, and titiler.mosaic serves virtual mosaics defined by MosaicJSON. A ready-made demo application, titiler.application, combines all of them.

Output can be JPEG, JP2, PNG, WEBP, GeoTIFF or raw NumpyTile arrays, and the service exposes OGC WMTS and OGC Tiles API endpoints. Deployment examples for AWS Lambda, ECS via CDK, and a Kubernetes Helm chart are included, along with a Docker image.

Key features

  • 01Serves Cloud Optimized GeoTIFF and STAC items as dynamic tiles
  • 02Supports Zarr and NetCDF datasets through Xarray
  • 03Reprojects to multiple TileMatrixSets via morecantile
  • 04Exposes OGC WMTS and OGC Tiles API endpoints with automatic OpenAPI docs
  • 05Creates virtual mosaics from MosaicJSON definitions

Use cases

  • Serving satellite or aerial imagery to a web map without pre-generating tile caches
  • Publishing a STAC catalog of raster data as a browsable tile service
  • Deploying a geospatial tile API on AWS Lambda, ECS, or Kubernetes

Quick start

  1. 1

    Upgrade pip before installing

    python -m pip install -U pip
  2. 2

    Install the application package from PyPI

    python -m pip install titiler.application
  3. 3

    Install uvicorn to run the server

    python -m pip install uvicorn
  4. 4

    Launch the FastAPI application locally

    uvicorn titiler.application.main:app

Things to know

  • The PyPI package named titiler is no longer supported; you must install a specific titiler.{package} name.

Topics

#geospatial#map-tiles#raster#fastapi#cloud-optimized-geotiff#stac#python#gis#cog#cogeotiff

FAQ

What is titiler?
A Python FastAPI toolkit for building dynamic map tile servers that serve Cloud Optimized GeoTIFF, STAC, Zarr and MosaicJSON data. TiTiler is a set of Python packages for building FastAPI applications that generate map tiles on the fly from raster datasets. Instead of pre-rendering tiles, it reads imagery at request time, so a single source file can serve any tile, projection, or band combination on demand.
Is titiler free to use? What license does it have?
titiler is open source under the MIT license. Check the license terms before using it in commercial products.
Is titiler still maintained?
Actively maintained. The last commit to titiler was on Nov 2, 2026.
What can I use titiler for?
Serving satellite or aerial imagery to a web map without pre-generating tile caches Publishing a STAC catalog of raster data as a browsable tile service Deploying a geospatial tile API on AWS Lambda, ECS, or Kubernetes
How do I install titiler?
Upgrade pip before installing: python -m pip install -U pip Install the application package from PyPI: python -m pip install titiler.application Install uvicorn to run the server: python -m pip install uvicorn Launch the FastAPI application locally: uvicorn titiler.application.main:app
Where can I get titiler?
The source code and installation instructions are on GitHub: https://github.com/developmentseed/titiler

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects