Portolan CLI

Publish and manage cloud-native geospatial data catalogs.

Portolan is a CLI for publishing and managing cloud-native geospatial data catalogs. It orchestrates format conversion (GeoParquet, COG), versioning, and sync to object storage (S3, GCS, Azure) — no running servers, just static files.

Specification: The Portolan Spec defines catalog structure, format requirements, and versioning rules. When in doubt about requirements, read the spec files directly (core.md, structure.md, versions.md, formats/vector.md, formats/raster.md, formats/pointcloud.md, best-practices.md) for the most up-to-date information.

Key concepts:

• STAC (SpatioTemporal Asset Catalog) — The catalog metadata spec. Portolan is a STAC profile, not a competing spec.
• GeoParquet — Cloud-optimized vector data (columnar, spatial indexing)
• COG (Cloud-Optimized GeoTIFF) — Cloud-optimized raster data (HTTP range requests)
• COPC (Cloud-Optimized Point Cloud) — Cloud-optimized point cloud data
• PMTiles — Cloud-optimized vector/raster tiles for web map rendering
• versions.json — Single source of truth for version history, sync state, and checksums

Installation