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

# titiler-core — A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.

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

## What it is and what it does

titiler.core is a FastAPI framework for building dynamic tile servers that serve raster geospatial data on demand. It abstracts away the complexity of tile generation, coordinate transformation, and OGC standards compliance, letting you spin up a tile server by instantiating a TilerFactory and registering its router to your FastAPI app. The package wraps rasterio and GDAL for raster I/O and includes factories for Cloud Optimized GeoTIFF (COG) endpoints, response models aligned with Mapbox TileJSON and OGC standards, and middleware for common geospatial server concerns.

The core dependencies are fastapi, starlette, rasterio, rio-tiler, pydantic, and morecantile—a stack designed for efficient tile serving. It ships with algorithm abstractions for elevation data and band indexing, Jinja2 templates for map viewers and WMTS documents, and telemetry hooks for OpenTelemetry tracing. The package is actively maintained, supports Python 3.11 through 3.14, and carries no known security vulnerabilities.

Use it for:

- Build a COG tile server by instantiating TilerFactory and registering its router, then serve Cloud Optimized GeoTIFFs over standard tile endpoints.
- Implement custom raster algorithms by subclassing the algorithm base class and plugging them into the factory.
- Serve OGC-compliant WMTS endpoints with auto-generated TileMatrixSet models and XML templates.
- Add telemetry and error handling to a tile service using the built-in middleware and error handler factories.
- Create a map viewer UI by leveraging the included Leaflet-based HTML template and Mapbox TileJSON response models.

## Worth the install?

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

Provides FastAPI-based building blocks to create dynamic tile servers for Cloud Optimized GeoTIFFs and raster data, handling tile generation, OGC standards, and geospatial data serving.

Yes. titiler.core is actively maintained, has no security vulnerabilities, installs with low friction, and provides a well-structured FastAPI framework for geospatial tile serving. It is suitable for production use if you need to serve raster data as tiles and want OGC standards compliance out of the box. The MIT license imposes no restrictions. Install it if you are building a tile server; skip it if you need a ready-made tile service rather than a framework.

## Install

pip install titiler-core
uv add titiler-core
poetry add titiler-core

## Installing titiler-core

Before you install: Low friction install with a pure-Python wheel. Actively maintained as of 16 days ago with recent commits and a stable repository. Requires Python 3.11 or later.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

from fastapi import FastAPI
from titiler.core.factory import TilerFactory

app = FastAPI(description="A lightweight Cloud Optimized GeoTIFF tile server")
cog = TilerFactory()
app.include_router(cog.router, tags=["Cloud Optimized GeoTIFF"])

Requires Python 3.11 or later; rasterio and GDAL dependencies may require system libraries on some platforms.

Verify before relying:

- Whether the package handles MosaicJSON and STAC data sources as mentioned in keywords, and what the API surface looks like for those use cases.
- Performance characteristics and scalability limits for concurrent tile requests or large raster datasets.
- Whether OpenTelemetry tracing (mentioned in module structure) is enabled by default or requires configuration.

## Package facts

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

## Tags

cloud optimized geotiff tile server, dynamic raster tile generation, fastapi geospatial tiles, cog tile server framework, ogc wmts tile endpoints, geospatial, tile-server, raster-data

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