---
id: titiler-mosaic
version: "2.2.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# titiler-mosaic — cogeo-mosaic (MosaicJSON) plugin for TiTiler.

License: permissive · Maintenance: active · Downloads: 104.1K/mo

## What it is and what it does

titiler-mosaic is a plugin for TiTiler that extends its tile-serving capabilities to handle mosaicked raster datasets through MosaicJSON. It wraps rio-tiler's Mosaic Backend and exposes it as a set of endpoints, allowing you to build a dynamic tile server that can composite and serve tiles from multiple raster sources on demand.

The package is designed for geospatial workflows where you need to serve tiles from collections of raster data. It handles the complexity of mosaic composition and tile extraction. Installation is straightforward with a single core dependency (titiler-core), and it supports Python 3.11 through 3.14.

Use it for:

- Serve tiles from a collection of raster sources as a single unified mosaic through endpoints.
- Build a dynamic tile server that composites multiple raster datasets on-the-fly.
- Expose MosaicJSON metadata and tile endpoints for geospatial data discovery and access.
- Create OGC-compliant tile services for satellite imagery, elevation data, or raster collections.
- Integrate mosaic tiling into a web application for custom geospatial services.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds MosaicJSON support to TiTiler, enabling you to build a tile server that serves mosaicked raster data through FastAPI endpoints.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively under MIT. Install it if you need to add MosaicJSON support to TiTiler for serving mosaicked raster data.

## Install

pip install titiler-mosaic
uv add titiler-mosaic
poetry add titiler-mosaic

## Installing titiler-mosaic

Before you install: Low install friction with a single runtime dependency (titiler-core). The package is actively maintained with a recent release 16 days ago and supports Python 3.11, 3.12, 3.13, and 3.14.

License in practice: MIT license is permissive; you can use this package in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install titiler-mosaic

from titiler.mosaic.factory import MosaicTilerFactory

mosaic = MosaicTilerFactory(backend=MosaicBackend)
app.include_router(mosaic.router, tags=["MosaicJSON"])

Requires Python 3.11 or later.

Verify before relying:

- Whether cogeo-mosaic is an optional or required dependency for typical use cases.
- Performance characteristics when serving large mosaics or high-frequency tile requests.
- Compatibility with specific versions of rio-tiler and GDAL/Rasterio.
- How MosaicTilerFactory is instantiated and what backend options are available.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 104.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mosaic tile server, mosaicjson fastapi, raster mosaic tiling, cogeo mosaic plugin, dynamic tile serving, geospatial tile endpoints, rio-tiler mosaic backend, geospatial-tiling, raster-data, fastapi-plugin

[View on SkillFed](https://skillfed.io/packages/titiler-mosaic) · [View on PyPI](https://pypi.org/project/titiler-mosaic/)