Skip to main content

Cloud Optimized GeoTIFF (COGEO) creation plugin for rasterio

Project description



Cloud Optimized GeoTIFF (COG) creation and validation plugin for Rasterio.

Test Coverage Package version Conda Forge Downloads Downloads


Source Code:

Cloud Optimized GeoTIFF

This plugin aims to facilitate the creation and validation of Cloud Optimized GeoTIFF (COG or COGEO). While it respects the COG specifications, this plugin also enforces several features:

  • Internal overviews (User can remove overview with option --overview-level 0)
  • Internal tiles (default profiles have 512x512 internal tiles)

Important: in GDAL 3.1 a new COG driver has been added (doc, discussion), starting with rio-cogeo version 2.2, --use-cog-driver option was added to create COG using the COG driver.


$ pip install -U pip
$ pip install rio-cogeo

Or install from source:

$ pip install -U pip
$ pip install git+

GDAL Version

It is recommended to use GDAL > 2.3.2. Previous versions might not be able to create proper COGs (ref:

More info in


Blog post on good and bad COG formats:

Checkout rio-glui or rio-viz rasterio plugins to explore COG locally in your web browser.

Contribution & Development






Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rio_cogeo-5.3.0.tar.gz (20.9 kB view hashes)

Uploaded Source

Built Distribution

rio_cogeo-5.3.0-py3-none-any.whl (20.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page