https://github.com/sentinel-hub/titiler-openeo
openEO by TiTiler
https://github.com/sentinel-hub/titiler-openeo
openeo rasterio stac titiler
Last synced: 6 months ago
JSON representation
openEO by TiTiler
- Host: GitHub
- URL: https://github.com/sentinel-hub/titiler-openeo
- Owner: sentinel-hub
- License: mit
- Created: 2024-10-30T12:33:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-08T09:23:40.000Z (11 months ago)
- Last Synced: 2025-09-20T12:55:33.809Z (10 months ago)
- Topics: openeo, rasterio, stac, titiler
- Language: Python
- Homepage: https://sentinel-hub.github.io/titiler-openeo/
- Size: 109 MB
- Stars: 23
- Watchers: 5
- Forks: 2
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# openEO by TiTiler
TiTiler backend for openEO
## Overview
[`titiler-openeo`](titiler/openeo/main.py ) is a TiTiler backend implementation for openEO developed by 
and 
.
The main goal of this project is to provide a light and fast backend for openEO services and processes using the TiTiler engine.
This simplicity comes with some specific implementation choices like the type of data managed by the backend.
It is focused on image raster data that can be processed on-the-fly and served as tiles or as light dynamic raw data.
A concept note is available [here](https://sentinel-hub.github.io/titiler-openeo/concepts/) to describe in more detail the implementation choices.
The application provides with a minimal [openEO API (L1A and L1C)](https://openeo.org/documentation/1.0/developers/profiles/api.html#api-profiles).
## Features
- [STAC API integration](https://sentinel-hub.github.io/titiler-openeo/concepts/#collections-and-stac-integration) with external STAC services
- [Synchronous processing](https://sentinel-hub.github.io/titiler-openeo/concepts/#data-model) capabilities
- Various output formats (e.g., JPEG, PNG)
- Multiple [supported processes](https://github.com/sentinel-hub/titiler-openeo/tree/main/titiler/openeo/processes/data)
- Dynamic tiling services
- FastAPI-based application
- Middleware for CORS, compression, and caching
- Enhanced [RasterStack data model](https://sentinel-hub.github.io/titiler-openeo/raster-stack/) with temporal dimension support
- [LazyRasterStack implementation](https://sentinel-hub.github.io/titiler-openeo/raster-stack/#lazyrasterstack-with-temporal-intelligence) with concurrent execution and intelligent caching
## Installation
[`uv`](https://docs.astral.sh/uv/) is the recommended way to install the project's runtime dependencies:
```bash
uv sync
```
## Usage
Once dependencies are installed, copy one of the sample environment files (e.g. `.env.eoapi`) and start the API:
```bash
cp .env.eoapi .env
export $(cat .env | xargs)
uvicorn titiler.openeo.main:app --host 0.0.0.0 --port 8081
```
## Configuration
Configuration settings can be provided via environment variables. The following settings are available:
- TITILER_OPENEO_STAC_API_URL: URL of the STAC API with the collections to be used
- TITILER_OPENEO_STORE_URL: URL of the openEO service/UDP store json file
In this repository, 2 `.env` sample files are provided:
- [`.env.eoapi`](https://github.com/sentinel-hub/titiler-openeo/blob/main/.env.eoapi) that uses the [Earth Observation API (EOAPI)](https://eoapi.dev/).
```bash
TITILER_OPENEO_STAC_API_URL="https://stac.eoapi.dev"
TITILER_OPENEO_STORE_URL="services/eoapi.json"
```
- [`.env.cdse`](https://github.com/sentinel-hub/titiler-openeo/blob/main/.env.cdse) that uses the [Copernicus Data Space Ecosystem (CDSE)](https://dataspace.copernicus.eu/)
```bash
TITILER_OPENEO_STAC_API_URL="https://stac.dataspace.copernicus.eu/v1"
TITILER_OPENEO_STORE_URL="services/copernicus.json"
```
In order to access asset object store and to retrieve data efficiently, it requires to set additional **environment variables**:
```bash
AWS_S3_ENDPOINT=eodata.dataspace.copernicus.eu # CDSE S3 endpoint URL
AWS_ACCESS_KEY_ID= # S3 access key
AWS_SECRET_ACCESS_KEY= # S3 secret key
AWS_VIRTUAL_HOSTING=FALSE # Disable virtual hosting
CPL_VSIL_CURL_CACHE_SIZE=200000000 # Global LRU cache size
GDAL_HTTP_MULTIPLEX=TRUE # Enable HTTP multiplexing
GDAL_CACHEMAX=500 # Set GDAL cache size
GDAL_INGESTED_BYTES_AT_OPEN=50000 # Open a larger bytes range when reading
GDAL_HTTP_MERGE_CONSECUTIVE_RANGES=YES # Merge consecutive ranges
VSI_CACHE_SIZE=5000000 # Set VSI cache size
VSI_CACHE=TRUE # Enable VSI cache
```
visit ['Access to EO data via S3'](https://documentation.dataspace.copernicus.eu/APIs/S3.html) for information on how to access the Copernicus Data Space Ecosystem (CDSE) data via S3.
## Contributing
See [`CONTRIBUTING.md`](CONTRIBUTING.md) for development setup, testing, and documentation workflows.
## License
See [LICENSE](https://github.com/sentinel-hub/titiler-openeo/blob/main/LICENSE)
## Authors
Created by [Development Seed]() and [Sinergise](https://www.sinergise.com/).
See [contributors](https://github.com/sentinel-hub/titiler-openeo/graphs/contributors) for a listing of individual contributors.
## Changes
See [CHANGES.md](https://github.com/sentinel-hub/titiler-openeo/blob/main/CHANGES.md).