# Tilebox Cookbook

Recipes for going from question to running system: query satellite catalogs, ingest your own data, ship workflows, and debug what happened.

## Datasets

Find, model, ingest, and query geospatial metadata with Tilebox Datasets.

### [Query open satellite data](/docs/guides/datasets/query-satellite-data)

Beginner · 5 min

Explore open data catalogs and query Sentinel-2 metadata by time and location.

Open data · Sentinel-2 · Metadata queries · Spatial filters

### [Create a Sentinel-2 RGB image](/docs/guides/datasets/access-sentinel2-data)

Beginner · 10 min

Combine three public Sentinel-2 COG assets into a cloud-free RGB image.

Assets · COG · Sentinel-2 · RGB

### [Create a Sentinel-1 radar image](/docs/guides/datasets/access-sentinel1-data)

Intermediate · 15 min

Render a north-up monochrome image from a public Sentinel-1 GRD measurement COG.

Assets · COG · Sentinel-1 · SAR

### [Build a spatio-temporal catalog](/docs/guides/datasets/build-spatiotemporal-catalog)

Intermediate · 20 min

Create, document, ingest, and query a geospatial catalog with asset references.

Spatio-temporal datasets · Assets · Ingestion · Python SDK

### [Ingest into a spatio-temporal catalog](/docs/guides/datasets/ingest-into-spatiotemporal-catalog)

Beginner · 15 min

Prepare GeoParquet metadata and ingest it into an existing spatio-temporal catalog.

Ingestion · Spatio-temporal datasets · GeoParquet · Python SDK

### [Ingesting from common file formats](/docs/guides/datasets/ingest-format)

Intermediate · 20 min

Load tabular and geospatial files before ingesting them into Tilebox.

Ingestion · DataFrames · xarray · File formats

## Workflows

Create workflow tasks, run jobs, publish releases, and deploy code to your own compute.

### [Run your first workflow](/docs/guides/workflows/run-your-first-workflow)

Beginner · 10 min

Define a small task, start a direct runner, submit a job, and inspect the result.

Tasks · Jobs · Direct runners · Python SDK

### [Execute tasks in parallel](/docs/guides/workflows/execute-tasks-in-parallel)

Beginner · 15 min

Submit many subtasks and process them with several direct runners at the same time.

Tasks · Subtasks · Direct runners · Parallelism

### [Build and deploy a workflow project](/docs/guides/workflows/build-and-deploy-workflow)

Beginner · 15 min

Initialize a Python workflow project, publish a release, and deploy it to a development cluster.

Workflow releases · Cluster deployments · Release runners · CLI

### [Deploy to your compute](/docs/guides/workflows/deploy-to-your-compute)

Intermediate · 10 min

Run workflow releases on local, cloud, or on-premises compute you control.

Clusters · Release runners · Compute · Deployments

### [Debug a failed workflow run](/docs/guides/workflows/debug-failed-run)

Beginner · 10 min

Inspect task state, logs, traces, runner context, and cluster alignment.

Jobs · Logs · Traces · Runners

### [Retry a failed job after a compatible fix](/docs/guides/workflows/retry-with-compatible-release)

Intermediate · 10 min

Publish a compatible fix and retry failed work without rerunning completed tasks.

Workflow releases · Retries · Task identifiers · Clusters

### [Iterate on Workflow Releases with Agents](/docs/guides/workflows/agentic-workflow-iteration)

Intermediate · 20 min

Use a coding agent to edit, publish, deploy, run, and debug workflow releases.

Agents · Workflow releases · Clusters · Observability

### [Multi-language Workflows](/docs/guides/workflows/multi-language)

Intermediate · 20 min

Combine Python and Go tasks in one workflow when each step needs different tools.

Python SDK · Go SDK · Tasks · Interoperability

## Operations

Monitor jobs, query telemetry, and configure automations for recurring or event-driven workflow runs.

### [Monitor workflow runs](/docs/guides/operations/monitor-workflow-runs)

Beginner · 5 min

Use the Console, CLI, and SDKs to monitor workflow execution.

Console · CLI · Jobs · Observability

### [Query logs and spans](/docs/guides/operations/query-logs-and-spans)

Beginner · 8 min

Query workflow telemetry from the CLI or SDKs for diagnostics and reports.

Logs · Spans · Telemetry · SDKs

### [Configure cron automations](/docs/guides/operations/configure-cron-automations)

Beginner · 8 min

Register an automation that submits workflow jobs on a schedule.

Automations · Cron · Runners · Tasks

### [Configure storage-event automations](/docs/guides/operations/configure-storage-event-automations)

Intermediate · 10 min

Trigger workflow jobs when files are created or modified in a storage location.

Automations · Storage locations · Storage events · Runners