cylf-dev · pjhartzell · Mar 4, 2026 · Mar 3, 2026 · Mar 3, 2026 · Mar 4, 2026
diff --git a/.gitignore b/.gitignore
@@ -6,3 +6,6 @@
 .pytest_cache/
 .mypy_cache/
 .ruff_cache/
+
+demo/data/
+**/.ipynb_checkpoints/
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -2,7 +2,7 @@
 
 ## Prerequisites
 
-- **Python 3.14+**
+- **Python 3.13+**
 - **[uv](https://docs.astral.sh/uv/)** — Python package and project manager
 
 ## Setup

diff --git a/demo/README.md b/demo/README.md
@@ -0,0 +1,26 @@
+# Demo
+
+A notebook demonstrating chonkle's codec pipeline with Python and WebAssembly codecs,
+using a real Sentinel-2 COG tile as test data.
+
+## Setup
+
+From the repo root:
+
+```
+uv sync --group notebook
+```
+
+## Running
+
+```
+uv run jupyter lab --notebook-dir=demo
+```
+
+Then open `chonkle-pipeline.ipynb` from the file browser.
+
+## Notes
+
+- The notebook downloads a ~200 MB Sentinel-2 COG on first run; subsequent runs skip the download.
+- The HTTPS and OCI Wasm loading steps require internet access.
+- A pre-compiled `tiff-predictor-2-c.wasm` is included for the local `file://` test.
diff --git a/demo/chonkle-pipeline.ipynb b/demo/chonkle-pipeline.ipynb
diff --git a/demo/tiff-predictor-2-c.wasm b/demo/tiff-predictor-2-c.wasm
diff --git a/pyproject.toml b/pyproject.toml
@@ -72,3 +72,8 @@ dev = [
     "pytest>=9.0",
     "ruff>=0.15",
 ]
+notebook = [
+    "chunk-utils @ git+https://github.com/cylf-dev/chunk-utils.git@v0.1.0",
+    "jupyterlab",
+    "matplotlib",
+]
diff --git a/uv.lock b/uv.lock