{"id":22462,"library":"titiler-core","title":"TiTiler Core","description":"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.","status":"active","version":"2.0.1","language":"python","source_language":"en","source_url":"https://github.com/developmentseed/titiler","tags":["tile-server","raster","COG","FastAPI","mapping","geospatial"],"install":[{"cmd":"pip install titiler-core","lang":"bash","label":"Install core package"}],"dependencies":[{"reason":"Web framework for building the tile server endpoints","package":"fastapi","optional":false},{"reason":"Raster I/O and GDAL bindings for reading geospatial data","package":"rasterio","optional":false},{"reason":"Library for creating tile matrices from raster sources","package":"rio-tiler","optional":false}],"imports":[{"note":"In v2, the factory classes moved from titiler.factories to titiler.core.factory","wrong":"from titiler.factory import TilerFactory (pre-v2)","symbol":"TilerFactory","correct":"from titiler.core.factory import TilerFactory"},{"note":"Settings classes now under titiler.core.settings","wrong":"from titiler.settings import TilerSettings (pre-v2)","symbol":"TilerSettings","correct":"from titiler.core.settings import TilerSettings"}],"quickstart":{"code":"from titiler.core.factory import TilerFactory\nfrom fastapi import FastAPI\n\napp = FastAPI()\ntiler = TilerFactory()\napp.include_router(tiler.router)\n\n# Access: http://localhost:8000/cog/tiles/12/2048/1536?url=https://example.com/cog.tif\n# Check health: http://localhost:8000/health","lang":"python","description":"Creates a basic FastAPI app with the COG tile server, exposing standard tile endpoints."},"warnings":[{"fix":"Add `assets` query parameter to all requests, e.g., `?assets=B01&url=...`","message":"In v2.0.0, the `assets` parameter in tile requests became required. Use `assets=` or `assets=:all:` to specify assets.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Install subpackages individually: `pip install titiler-core titiler-application`","message":"The `titiler` metapackage is deprecated. Replace with `titiler-core`, `titiler-application`, or other subpackages.","severity":"deprecated","affected_versions":">=1.2.0"},{"fix":"Ensure mask type is appropriate (e.g., uint8) or use custom algorithm handling.","message":"When using `titiler.core.algorithm`, the Contour algorithm may fail with non-8-bit masks (e.g., continuous data) causing compatibility errors.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Import from subpackages: 'from titiler.core.factory import TilerFactory'","cause":"Installed 'titiler-core' but tried to import 'titiler' (old metapackage).","error":"ModuleNotFoundError: No module named 'titiler'"},{"fix":"Provide 'assets' as a query parameter or set multiple via comma-separated values: '?assets=B01,B02'","cause":"In v2, the 'assets' parameter is mandatory for tile endpoints.","error":"ValueError: assets is required"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}