titiler-extensions

What it is and what it does

titiler-extensions provides a collection of pre-built extension classes that plug into TiTiler's TilerFactory to add specialized endpoints for geospatial tile serving. It extends the base TiTiler framework with support for COG (Cloud Optimized GeoTIFF) validation, HTML viewers for COGs and STAC items, and OGC Web Map Service (WMS) endpoints. The package is designed to work with titiler-core and typing-extensions, allowing you to compose tile server functionality by registering extensions at factory creation time.

You use it by importing one or more extension classes, passing them to a TilerFactory's extensions parameter, and then registering the factory's router with your application. The package also provides a base FactoryExtension class for building your own custom extensions, letting you add arbitrary endpoints that reuse the factory's dependency injection system and reader infrastructure.

Use it for:

• Add a /validate endpoint to a tile server that returns COG metadata and validation info.
• Serve an interactive HTML viewer for individual Cloud Optimized GeoTIFFs without writing custom endpoints.
• Expose STAC item collections through a /viewer endpoint for browsing and previewing raster data.
• Implement OGC Web Map Service (WMS) GetTile and GetCapabilities endpoints on a tile server.
• Build custom tile endpoints (e.g., thumbnails, statistics) by subclassing FactoryExtension and reusing factory dependencies.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides pluggable extension classes for TiTiler's TilerFactory to add specialized endpoints like COG validation, STAC viewing, WMS support, and custom tile server functionality.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and provides a clean plugin architecture for extending TiTiler with common geospatial endpoints. Install it if you are building a tile server and want to add COG validation, STAC viewing, WMS support, or custom tile endpoints without writing boilerplate.

Install

titiler-extensions on PyPI

pip install titiler-extensions

uv add titiler-extensions

poetry add titiler-extensions

Installing titiler-extensions

Before you install

Low install friction with only 2 runtime dependencies (titiler-core and typing-extensions). Actively maintained with a recent release 16 days ago and ongoing commits; the parent repository has 1145 stars.

License in practice

MIT license permits commercial and private use with minimal restrictions; you must include a copy of the license and copyright notice in distributions.

Quickstart

pip install titiler.extensions

from titiler.core.factory import TilerFactory
from titiler.extensions import cogValidateExtension

tiler = TilerFactory(
    router_prefix="/cog",
    extensions=[cogValidateExtension()]
)

Requires Python 3.11 or later; titiler-core must be installed as a runtime dependency.

Verify before relying

• Whether the cogValidateExtension's rio-cogeo dependency is automatically installed or requires manual installation via titiler.extensions["cogeo"].
• Performance characteristics when multiple extensions are registered on a single TilerFactory.
• Compatibility with specific versions of titiler-core beyond the declared runtime dependency.
• Whether all extensions work with all supported Python versions (3.11, 3.12, 3.13, 3.14).

Package facts

Evidence: titiler_extensions-2.2.1-py3-none-any.whl

Keywords: COG, Dynamic tile server, Fastapi, GDAL, MosaicJSON, OGC, Rasterio, STAC

Tags

More GIS packages