Skip to main content

Tilebox documentation

Start building with Tilebox

Query Earth Data. Build, run, debug, and scale geospatial workflows across environments. One API for humans and agents.

QuickstartGet API KeyIngest data
> User
Onboard yourself to Tilebox: https://docs.tilebox.com/onboard-your-agent

Then use Tilebox to find which data center sites changed most from space.

Build a reproducible workflow that:
   - starting from a user-provided CSV of known data centers
   - finds cloud-free Sentinel-2 imagery over a target lat/lon in a time window
   - reads the relevant band products, crops scenes to a 3km area around the target
   - computes the cloud fraction for the cropped area, filter out scenes > 1%
   - compares before/after by scoring visible change based on suitable metrics
   - then create a datacenter site ranking based on score

Use the provided Tilebox skills to research datasets, storage access and outline the
workflow, then implement it. Deploy and run on our GCP cluster, in case of failures
inspect runner logs and iterate on the workflow.

Get started

Choose how you build

Use Tilebox directly as a developer, or give an agent the same tools and documentation context so it can work with Tilebox for you.

Agent connected to Earth data and workflow observability tools

Use an agent

Configure a coding agent with the Tilebox CLI, agent skills, and optional MCP access. Agents can inspect datasets, write workflow code, submit jobs, and debug runs with Tilebox context.

Onboard your agentCreate and deploy workflowsConnect with MCP
Developer terminal connected to code debugging and dataset tools

Build as a developer

Use the Console, Python SDK, Go SDK, and CLI to query data, ingest your own catalogs, create workflow tasks, and run them across your infrastructure.

QuickstartChoose an SDKAPI reference

Learn

Explore the platform

Start from the outcome you need. Tilebox combines typed data access, workflow execution on your infrastructure, and shared observability for people and agents working on geospatial systems.

Tilebox dataset explorerTilebox dataset explorer

Query satellite data

Search typed datasets by time, location, collection, or datapoint ID.

Workflow logs in Tilebox ConsoleWorkflow logs in Tilebox Console

Inspect workflow runs

Use logs, traces, progress, and job state to debug workflows and verify results.

Tilebox runner architectureTilebox runner architecture

Deploy to your own compute

Connect runners to your own infrastructure and control where workflow tasks execute.

Run a workflow

Connect storage

Ingest data

Sample notebooks

Spatio-temporal datasets

Jobs

Scale

From first query to running on your infrastructure

Start with open data or your own catalogs, turn processing steps into tasks, and run them where your data and infrastructure already live.

1

Discover and query data

Query open datasets or your own Tilebox datasets by time, area of interest, collection, or datapoint ID.
2

Build workflow tasks

Turn processing steps into workflow tasks that can submit subtasks, report progress, use caches, and emit logs and traces.
3

Prototype locally

Develop with local runners, iterate quickly, and prototype your geospatial workflows.
4

Deploy to your own compute

Run workflows across cloud, on-premises, sovereign, air-gapped, or edge environments while Tilebox tracks jobs and distributes work for parallel execution.
5

Inspect and iterate

Query job state, logs, spans, and progress from the Console, SDKs, CLI, or agent tools.