maveryn · maveryn · Jul 27, 2026 · Jul 27, 2026 · Jul 27, 2026
diff --git a/.gitignore b/.gitignore
@@ -33,6 +33,7 @@ checkpoints/
 external/
 
 *.ipynb
+!examples/notebooks/trace_quickstart.ipynb
 *.parquet
 *.sqlite
 *.sqlite3

diff --git a/README.md b/README.md
@@ -9,6 +9,7 @@ contains 1,000 tasks across 277 scenes and 11 visual domains.
 
 <p align="center">
   <a href="https://maveryn.github.io/trace/"><img alt="Project Page" src="https://img.shields.io/badge/Project-Page-14324a?style=for-the-badge"></a>
+  <a href="https://huggingface.co/spaces/maveryn/trace"><img alt="Live Demo" src="https://img.shields.io/badge/HuggingFace-Live_Demo-2563eb?style=for-the-badge"></a>
   <a href="https://arxiv.org/abs/2607.19790"><img alt="arXiv" src="https://img.shields.io/badge/arXiv-2607.19790-b31b1b?style=for-the-badge"></a>
   <a href="https://huggingface.co/collections/maveryn/trace-6a604291b4be4ed6399b9f24"><img alt="Hugging Face Collection" src="https://img.shields.io/badge/HuggingFace-Collection-f59e0b?style=for-the-badge"></a>
   <a href="https://huggingface.co/datasets/maveryn/trace"><img alt="Dataset" src="https://img.shields.io/badge/HuggingFace-Dataset-f59e0b?style=for-the-badge"></a>
@@ -18,6 +19,42 @@ contains 1,000 tasks across 277 scenes and 11 visual domains.
 
 ![Trace examples across charts, games, geometry, graphs, icons, illustrations, pages, physics, puzzles, symbolic reasoning, and 3D scenes](docs/assets/paper-domain-montage/trace-paper-domain-montage.png)
 
+## Try Trace
+
+<p align="center">
+  <a href="https://huggingface.co/spaces/maveryn/trace"><img alt="Open Trace Space" src="https://img.shields.io/badge/Open-Trace_Space-2563eb?style=for-the-badge"></a>
+  <a href="https://colab.research.google.com/github/maveryn/trace/blob/main/examples/notebooks/trace_quickstart.ipynb"><img alt="Open in Colab" src="https://img.shields.io/badge/Open_in-Colab-f9ab00?style=for-the-badge"></a>
+</p>
+
+Trace is for researchers and engineers building verifiable VLM post-training,
+synthetic-data, and evaluation pipelines.
+
+Explore all 1,000 tasks in the browser, including their deterministic images,
+prompts, typed supervision, reward contracts, annotation overlays, and public
+execution traces. Or generate the default example locally from the exact
+revision used by the demo:
+
+```bash
+python -m pip install \
+  "trace-tasks @ git+https://github.com/maveryn/trace.git@bb7fdd1fc8a0f8a2e3db7efe910a14e81d58feb7"
+```
+
+```python
+from trace_tasks import generate_task
+
+sample = generate_task(
+    "task_geometry__graph_paper__polygon_area_value",
+    seed=42,
+    max_attempts=100,
+)
+sample.image.save("trace-example.png")
+print(sample.prompt)
+print(sample.answer_gt.to_dict())
+print(sample.annotation_gt.to_dict())
+```
+
+![The Trace Space showing a generated task, its public annotation overlay, prompt, and deterministic selectors](docs/assets/examples/trace-space-quickstart.png)
+
 ## How Trace Works
 
 Trace organizes visual reasoning as `domain → scene grammar → task program`.

diff --git a/docs/README.md b/docs/README.md
@@ -27,7 +27,8 @@ hide:
 </p>
 
 <div class="trace-resource-links">
-  <a class="md-button md-button--primary" href="https://github.com/maveryn/trace">Code</a>
+  <a class="md-button md-button--primary" href="https://huggingface.co/spaces/maveryn/trace">Live Demo</a>
+  <a class="md-button" href="https://github.com/maveryn/trace">Code</a>
   <a class="md-button" href="https://arxiv.org/abs/2607.19790">Paper</a>
   <a class="md-button" href="research/">Research</a>
   <a class="md-button" href="https://huggingface.co/collections/maveryn/trace-6a604291b4be4ed6399b9f24">Collection</a>
@@ -68,6 +69,51 @@ hide:
   </figcaption>
 </figure>
 
+## Try Trace
+
+<div class="trace-resource-links">
+  <a class="md-button md-button--primary" href="https://huggingface.co/spaces/maveryn/trace">Open Trace Space</a>
+  <a class="md-button" href="https://colab.research.google.com/github/maveryn/trace/blob/main/examples/notebooks/trace_quickstart.ipynb">Open in Colab</a>
+</div>
+
+Trace is for researchers and engineers building verifiable VLM post-training,
+synthetic-data, and evaluation pipelines.
+
+Explore all 1,000 tasks in the browser, including their deterministic images,
+prompts, typed supervision, reward contracts, annotation overlays, and public
+execution traces. Or generate the default example locally from the exact
+revision used by the demo:
+
+```bash
+python -m pip install \
+  "trace-tasks @ git+https://github.com/maveryn/trace.git@bb7fdd1fc8a0f8a2e3db7efe910a14e81d58feb7"
+```
+
+```python
+from trace_tasks import generate_task
+
+sample = generate_task(
+    "task_geometry__graph_paper__polygon_area_value",
+    seed=42,
+    max_attempts=100,
+)
+sample.image.save("trace-example.png")
+print(sample.prompt)
+print(sample.answer_gt.to_dict())
+print(sample.annotation_gt.to_dict())
+```
+
+<figure class="trace-paper-figure">
+  <img
+    src="assets/examples/trace-space-quickstart.png"
+    alt="The Trace Space showing a generated task, its public annotation overlay, prompt, and deterministic selectors."
+  >
+  <figcaption>
+    The public Space exposes the same deterministic task and verifier contracts
+    as the Python package.
+  </figcaption>
+</figure>
+
 ## How Trace works
 
 Trace organizes visual reasoning as `domain → scene grammar → task program`.

diff --git a/docs/assets/examples/trace-space-quickstart.png b/docs/assets/examples/trace-space-quickstart.png
diff --git a/examples/huggingface_space/README.md b/examples/huggingface_space/README.md
@@ -0,0 +1,58 @@
+---
+title: Trace Task Explorer
+emoji: 🔎
+colorFrom: blue
+colorTo: indigo
+sdk: gradio
+sdk_version: 6.20.0
+python_version: "3.12"
+app_file: app.py
+pinned: false
+license: apache-2.0
+short_description: Generate and inspect 1,000 grounded visual-reasoning tasks.
+suggested_hardware: cpu-basic
+models:
+  - maveryn/trace-qwen2.5-vl-3b
+  - maveryn/trace-qwen2.5-vl-7b
+datasets:
+  - maveryn/trace
+tags:
+  - visual-reasoning
+  - synthetic-data
+  - reinforcement-learning
+  - rlvr
+  - multimodal
+---
+
+# Trace Task Explorer
+
+This Space generates any of Trace's 1,000 deterministic, grounded
+visual-reasoning tasks. Select a domain, scene, task, and seed to inspect the
+rendered image, prompt, typed supervision, public annotation overlay, exact
+reward contract, and sanitized public execution trace.
+
+The Space is CPU-only and may need a short cold start. It accepts no uploads and
+stores no generated examples. The package dependency is pinned to the exact
+source revision shown in the **Reproduce** tab.
+
+- [Source repository](https://github.com/maveryn/trace)
+- [Documentation](https://maveryn.github.io/trace/)
+- [Paper](https://arxiv.org/abs/2607.19790)
+- [Dataset](https://huggingface.co/datasets/maveryn/trace)
+- [Hugging Face collection](https://huggingface.co/collections/maveryn/trace-6a604291b4be4ed6399b9f24)
+- [3B checkpoint](https://huggingface.co/maveryn/trace-qwen2.5-vl-3b)
+- [7B checkpoint](https://huggingface.co/maveryn/trace-qwen2.5-vl-7b)
+
+## Citation
+
+```bibtex
+@misc{alam2026trace,
+  title         = {Trace: A Taxonomy-Guided Environment for Multidomain Visual Reasoning},
+  author        = {Alam, Md Tanvirul},
+  year          = {2026},
+  eprint        = {2607.19790},
+  archivePrefix = {arXiv},
+  primaryClass  = {cs.CV},
+  url           = {https://arxiv.org/abs/2607.19790}
+}
+```