mapchete-hub 2026.4.0

Key Features

• 🌐 OGC API - Processes inspired: A REST API for submitting jobs, monitoring their status, and retrieving results.

• ⚙️ Advanced Job Monitoring: Inspect detailed job states (pending, running, failed, success) and view the overall progress percentage for currently running jobs.

• 🚀 Scalable Execution: Can be configured to use Dask for distributed, parallel execution of jobs.

• 💬 Slack Notifications: Optionally sends job status updates directly to a configured Slack channel.

• 🐳 Container-Ready: Designed to be deployed in containerized environments like Docker, making it easy to scale your processing capabilities.

How It Works

1. Serve: Start the mapchete Hub server. It listens for incoming job requests.

2. Prepare Job: A client application prepares a job configuration as a JSON object that follows the MapcheteJob schema.

3. Submit: The client POSTs the JSON configuration to the /jobs endpoint. The Hub validates it and returns a unique job_id.

4. Monitor: The client uses the job_id to poll the /jobs/{job_id} endpoint to track the job’s status and progress.

5. Retrieve: Once the job is successful, the results can be accessed from the location defined in the job’s output configuration.

Getting Started

pip install mapchete-hub

mhub-server start

{
  "process": "mapchete.processes.examples.hillshade",
  "zoom_levels": [
    10
  ],
  "pyramid": {
    "grid": "geodetic"
  },
  "input": {
    "dem": "https://storage.googleapis.com/mapchete-test-data/cleantopo2/dem.tif"
  },
  "output": {
    "path": "./hillshade_output",
    "format": "GTiff",
    "dtype": "uint8",
    "bands": 1
  }
}

# Submit the job
mhub-cli submit my_job.json

# The command will return a job_id. Use it to check the status:
mhub-cli status <your_job_id>

Contributing

mapchete Hub is an open-source project and we welcome contributions! Please see the Contributing Guide in the main mapchete repository for guidelines on how to get started.

Acknowledgements

The initial development of mapchete Hub was made possible with the resources and support of EOX IT Services GmbH.