titiler-core

library2.0.5pypypi✓ verified 86d ago

A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL, enabling on-the-fly map tile generation from various geospatial raster sources. Version 2.0.1 requires Python >=3.11 and includes breaking changes from the 1.x series, such as mandatory assets parameter and removal of deprecated endpoints. The library is actively maintained with frequent releases.

web-framework data aws

pip install titiler-core

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · TITILER-CORE

titiler-core

web-frameworkpythonv2.0.5

Install

9.7s avg

Import

—

Disk

246MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.24.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 9.7s · import 0.000s · 248MB

246MB installed

● package 246MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

TilerFactory

✓ from titiler.core.factory import TilerFactory

✗ from titiler.factory import TilerFactory (pre-v2)

In v2, the factory classes moved from titiler.factories to titiler.core.factory

TilerSettings

✓ from titiler.core.settings import TilerSettings

✗ from titiler.settings import TilerSettings (pre-v2)

Settings classes now under titiler.core.settings

Creates a basic FastAPI app with the COG tile server, exposing standard tile endpoints.

from titiler.core.factory import TilerFactory from fastapi import FastAPI app = FastAPI() tiler = TilerFactory() app.include_router(tiler.router) # Access: http://localhost:8000/cog/tiles/12/2048/1536?url=https://example.com/cog.tif # Check health: http://localhost:8000/health

Debug

Known issues

breakingIn v2.0.0, the `assets` parameter in tile requests became required. Use `assets=` or `assets=:all:` to specify assets.

fix

Add `assets` query parameter to all requests, e.g., `?assets=B01&url=...`

affects: >=2.0.0

deprecatedThe `titiler` metapackage is deprecated. Replace with `titiler-core`, `titiler-application`, or other subpackages.

fix

Install subpackages individually: `pip install titiler-core titiler-application`

affects: >=1.2.0

gotchaWhen using `titiler.core.algorithm`, the Contour algorithm may fail with non-8-bit masks (e.g., continuous data) causing compatibility errors.

fix

Ensure mask type is appropriate (e.g., uint8) or use custom algorithm handling.

affects: >=2.0.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'titiler'

Installed 'titiler-core' but tried to import 'titiler' (old metapackage).

fix

Import from subpackages: 'from titiler.core.factory import TilerFactory'

ValueError: assets is required

In v2, the 'assets' parameter is mandatory for tile endpoints.

fix

Provide 'assets' as a query parameter or set multiple via comma-separated values: '?assets=B01,B02'

Upgrade

Version history

2.0.5latest on PyPI · released Jun 18, 2026

Audit

Dependencies

fastapirequiredWeb framework for building the tile server endpoints

rasteriorequiredRaster I/O and GDAL bindings for reading geospatial data

rio-tilerrequiredLibrary for creating tile matrices from raster sources

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/developmentseed/titiler ↗

packagehttps://pypi.org/project/titiler-core/ ↗

homepagehttps://developmentseed.org/titiler/ ↗

docshttps://developmentseed.org/titiler/ ↗

changeloghttps://developmentseed.org/titiler/release-notes/ ↗