From e2351eaaeb978a06b68ce307bf5b6a332ae8ae01 Mon Sep 17 00:00:00 2001
From: Roman Pope <popenov.r@gmail.com>
Date: Thu, 28 May 2026 01:35:31 -0400
Subject: [PATCH] Initialize ICC demo workspace with LFS tracking + README

---
 .gitattributes | 15 +++++++++++++++
 README.md      | 16 ++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 .gitattributes
 create mode 100644 README.md

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..c70d3c8
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,15 @@
+# Git LFS tracking for ICC demo workflow.
+# Adds entries here BEFORE committing any new binary format.
+
+*.sigmf-data filter=lfs diff=lfs merge=lfs -text
+*.sigmf-meta filter=lfs diff=lfs merge=lfs -text
+*.sigmf      filter=lfs diff=lfs merge=lfs -text
+*.h5         filter=lfs diff=lfs merge=lfs -text
+*.hdf5       filter=lfs diff=lfs merge=lfs -text
+*.pth        filter=lfs diff=lfs merge=lfs -text
+*.pt         filter=lfs diff=lfs merge=lfs -text
+*.onnx       filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+*.npy        filter=lfs diff=lfs merge=lfs -text
+*.wav        filter=lfs diff=lfs merge=lfs -text
+*.bin        filter=lfs diff=lfs merge=lfs -text
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..484a51c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# ICC Demo Workspace
+
+Recordings, curated datasets, and training workflows for the WavesFM ICC presentation.
+
+## Workflow
+
+1. **Upload recordings** — drop `.sigmf-data` + `.sigmf-meta` pairs. Git LFS tracks them automatically via `.gitattributes`.
+2. **Curate** — open the Curator UI, select recordings from this repo, configure slicer + qualifier, produce an HDF5 dataset.
+3. **Commit dataset** — use the Curator's "Commit to Repository" button to land the curated `.h5` back here.
+4. **Train** — open the Model Trainer, select this repo + WavesFM Linear Probe (or LoRA), pick the dataset, submit the run.
+5. **Watch action_run** — the trainer renders `.riahub/workflows/train.yaml` and triggers a runner job. Progress lives under the Actions tab.
+
+## Notes
+
+- WavesFM foundation model: `qoherent/wavesfm-base/wavesfm-v1p0.pth` — injected into the workflow automatically.
+- If you upload a binary format not in `.gitattributes`, add it BEFORE the first commit of that file (LFS can't retroactively un-track).