Upload folder using huggingface_hub

README.md

@@ -11,6 +11,10 @@ license: apache-2.0
 short_description: Voice tutor that sketches on a whiteboard while it talks
 tags:
   - build-small-hackathon
+  - backyard ai
+  - off the grid
+  - off-brand
+  - sharing is caring
   - agent
   - education
   - speech
@@ -30,6 +34,16 @@ with its voice.**
 Built for the [HF Build Small Hackathon](https://huggingface.co/build-small-hackathon):
 every model runs **on this Space itself** via ZeroGPU. No cloud APIs, no keys.
 
+## Why Backyard AI 🏡
+
+I built Tutori for my parents. They're quite behind on today's technology —
+especially AI — and the firehose of new models and jargon is impenetrable
+from the outside. With Tutori they can just **ask**: "what is Gemma?",
+"what happened in AI this month?" — and get a patient, spoken explanation,
+drawn out on a whiteboard, at their pace, with the research done for them.
+They've actually been using it, and they find it genuinely useful for
+finally keeping up.
+
 ## The stack (Σ 19.8B params — well under the 32B cap)
 
 | Role | Model | Params |
@@ -101,3 +115,6 @@ from what Nemotron found, Higgs speaks it, Whisper listens.
   optional keyless web search, and you can switch that off too.
 - 🎨 **Off-Brand** — custom hand-drawn whiteboard frontend (vanilla canvas,
   ~600 lines of sketchy-stroke renderer) on top of Gradio.
+- 🤝 **Sharing is Caring** — verbatim agent traces from live sessions are
+  published in [`traces/`](./traces): the Nemotron planner's search queries,
+  every spoken sentence, and every whiteboard op with coordinates, timestamped.

app.py

@@ -276,13 +276,6 @@ with gr.Blocks(
         '<div id="made-by">Made by SSH/ProCreations</div></div>'
     )
 
-    # hidden, API-only endpoint: TTS in Tutori's voice (used for demo narration)
-    if ENGINE.MODELS_INFO.get("mode") == "zerogpu":
-        with gr.Row(visible=False):
-            tts_in = gr.Textbox()
-            tts_out = gr.Textbox()
-            tts_btn = gr.Button("tts")
-        tts_btn.click(ENGINE.tts_only, tts_in, tts_out, api_name="tts_demo")
 
     # ---------------- wiring ----------------
     # The `js` hook runs client-side BEFORE fn and its return replaces the

traces/README.md

@@ -0,0 +1,15 @@
+# Agent traces — Sharing is Caring 🤝
+
+Three **verbatim event traces** from live sessions on this Space, exactly as
+the agent streamed them (timestamps in seconds from turn start):
+
+| Trace | Shows |
+|---|---|
+| `trace-space-exploration.json` | The full research path: Nemotron 3 Nano decides to search, its queries appear verbatim in the `Researching:` status, and the lesson teaches from what it found |
+| `trace-rockets-orbit.json` | A conceptual lesson — the planner correctly skips the web |
+| `trace-gradient-descent.json` | A quantitative lesson (axes / curve / descent arrow board ops) |
+
+Each event is one of: `status` (the agent's live state, including the
+planner's search queries), `step` (a lesson step: the exact spoken sentence
+plus every whiteboard op with coordinates, post layout-engine), or `final`.
+TTS audio payloads are stripped for repo size; everything else is untouched.

traces/trace-gradient-descent.json

@@ -0,0 +1,203 @@
+{
+ "question": "How does gradient descent work?",
+ "events": [
+  {
+   "t": 1.22,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Thinking\u2026"
+   }
+  },
+  {
+   "t": 7.59,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Deciding what context I need\u2026"
+   }
+  },
+  {
+   "t": 8.51,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Preparing your whiteboard lesson\u2026"
+   }
+  },
+  {
+   "t": 32.18,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 1"
+   }
+  },
+  {
+   "t": 32.18,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Let's visualize gradient descent as a way to find the lowest point of a valley. We start at a random spot and want to reach the bottom.",
+     "board": [
+      {
+       "op": "clear"
+      },
+      {
+       "op": "title",
+       "text": "Gradient Descent Basics"
+      },
+      {
+       "op": "axes",
+       "at": [
+        10.0,
+        25.0
+       ],
+       "w": 50.0,
+       "h": 40.0,
+       "xlabel": "Weight (w)",
+       "ylabel": "Loss"
+      },
+      {
+       "op": "curve",
+       "points": [
+        [
+         10.0,
+         65.0
+        ],
+        [
+         20.0,
+         40.0
+        ],
+        [
+         30.0,
+         20.0
+        ],
+        [
+         40.0,
+         10.0
+        ],
+        [
+         50.0,
+         10.0
+        ],
+        [
+         60.0,
+         20.0
+        ],
+        [
+         70.0,
+         40.0
+        ],
+        [
+         80.0,
+         65.0
+        ]
+       ],
+       "color": "blue"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 9.69s \u2014 stripped for repo size>",
+     "dur": 9.69,
+     "i": 0
+    }
+   }
+  },
+  {
+   "t": 44.68,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 2"
+   }
+  },
+  {
+   "t": 44.68,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "The gradient is just the slope. If the slope is positive, we move left; if it is negative, we move right to decrease our loss.",
+     "board": [
+      {
+       "op": "dot",
+       "at": [
+        20.0,
+        40.0
+       ],
+       "color": "red",
+       "label": null
+      },
+      {
+       "op": "arrow",
+       "from": [
+        20.0,
+        40.0
+       ],
+       "to": [
+        35.0,
+        30.0
+       ],
+       "label": null,
+       "color": "green"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 9.66s \u2014 stripped for repo size>",
+     "dur": 9.66,
+     "i": 1
+    }
+   }
+  },
+  {
+   "t": 55.99,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 3"
+   }
+  },
+  {
+   "t": 55.99,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "The learning rate determines how big our steps are. A huge step might jump over the bottom, while a tiny step takes forever to get there.",
+     "board": [],
+     "audio": "<higgs-audio-v2 wav, 9.11s \u2014 stripped for repo size>",
+     "dur": 9.11,
+     "i": 2
+    }
+   }
+  },
+  {
+   "t": 61.82,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 4"
+   }
+  },
+  {
+   "t": 61.82,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Does that visual of walking down a slope to find the minimum make sense to you so far?",
+     "board": [],
+     "audio": "<higgs-audio-v2 wav, 5.38s \u2014 stripped for repo size>",
+     "dur": 5.38,
+     "i": 3
+    }
+   }
+  },
+  {
+   "t": 62.44,
+   "event": {
+    "type": "final",
+    "text": "Let's visualize gradient descent as a way to find the lowest point of a valley. We start at a random spot and want to reach the bottom. The gradient is just the slope. If the slope is positive, we move left; if it is negative, we move right to decrease our loss. The learning rate determines how big our steps are. A huge step might jump over the bottom, while a tiny step takes forever to get there. Does that visual of walking down a slope to find the minimum make sense to you so far?",
+    "error": null,
+    "question": "How does gradient descent work?"
+   }
+  }
+ ],
+ "note": "Verbatim agent trace from a live session on this Space. Timing in seconds from turn start. 'Researching:' status lines show the Nemotron 3 Nano planner's queries verbatim."
+}

traces/trace-rockets-orbit.json

@@ -0,0 +1,235 @@
+{
+ "question": "How do rockets actually reach orbit?",
+ "events": [
+  {
+   "t": 1.22,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Thinking\u2026"
+   }
+  },
+  {
+   "t": 8.19,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Deciding what context I need\u2026"
+   }
+  },
+  {
+   "t": 9.41,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Preparing your whiteboard lesson\u2026"
+   }
+  },
+  {
+   "t": 30.02,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 1"
+   }
+  },
+  {
+   "t": 30.02,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "To reach orbit, a rocket isn't just going up; it's mostly going sideways. We need to balance gravity against a massive horizontal velocity.",
+     "board": [
+      {
+       "op": "clear"
+      },
+      {
+       "op": "title",
+       "text": "The Path to Orbit"
+      },
+      {
+       "op": "axes",
+       "at": [
+        10.0,
+        25.0
+       ],
+       "w": 50.0,
+       "h": 40.0,
+       "xlabel": "Distance",
+       "ylabel": "Altitude"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 11.51s \u2014 stripped for repo size>",
+     "dur": 11.51,
+     "i": 0
+    }
+   }
+  },
+  {
+   "t": 43.13,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 2"
+   }
+  },
+  {
+   "t": 43.13,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "First, the rocket fights gravity to gain altitude. This is the vertical climb where it clears the thickest part of the atmosphere.",
+     "board": [
+      {
+       "op": "curve",
+       "points": [
+        [
+         15.0,
+         65.0
+        ],
+        [
+         20.0,
+         50.0
+        ],
+        [
+         25.0,
+         35.0
+        ]
+       ],
+       "color": "blue"
+      },
+      {
+       "op": "dot",
+       "at": [
+        25.0,
+        35.0
+       ],
+       "color": "red",
+       "label": "Max Q",
+       "label_at": [
+        28.0,
+        18.0
+       ]
+      },
+      {
+       "op": "text",
+       "text": "Vertical Climb",
+       "at": [
+        15.0,
+        71.0
+       ],
+       "size": "s",
+       "color": "blue"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 8.96s \u2014 stripped for repo size>",
+     "dur": 8.96,
+     "i": 1
+    }
+   }
+  },
+  {
+   "t": 62.4,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 3"
+   }
+  },
+  {
+   "t": 62.4,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Then, it performs a gravity turn. By tilting, the rocket converts its upward thrust into horizontal speed, which is what keeps it from falling back.",
+     "board": [
+      {
+       "op": "curve",
+       "points": [
+        [
+         25.0,
+         35.0
+        ],
+        [
+         40.0,
+         30.0
+        ],
+        [
+         60.0,
+         28.0
+        ]
+       ],
+       "color": "green"
+      },
+      {
+       "op": "arrow",
+       "from": [
+        60.0,
+        28.0
+       ],
+       "to": [
+        75.0,
+        28.0
+       ],
+       "label": "Orbital Velocity",
+       "color": "green",
+       "label_at": [
+        67.5,
+        19.0
+       ]
+      },
+      {
+       "op": "notes",
+       "title": "Key Goals",
+       "lines": [
+        "1. Escape Air",
+        "2. Gain Speed",
+        "3. Stay Sideways"
+       ],
+       "at": [
+        70.0,
+        45.0
+       ],
+       "color": "gray",
+       "compact": true
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 11.51s \u2014 stripped for repo size>",
+     "dur": 11.51,
+     "i": 2
+    }
+   }
+  },
+  {
+   "t": 73.14,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 4"
+   }
+  },
+  {
+   "t": 73.14,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Think of it like a ball thrown so fast that the curve of its fall matches the curve of the Earth. Does that distinction between height and speed make sense?",
+     "board": [],
+     "audio": "<higgs-audio-v2 wav, 11.46s \u2014 stripped for repo size>",
+     "dur": 11.46,
+     "i": 3
+    }
+   }
+  },
+  {
+   "t": 73.14,
+   "event": {
+    "type": "final",
+    "text": "To reach orbit, a rocket isn't just going up; it's mostly going sideways. We need to balance gravity against a massive horizontal velocity. First, the rocket fights gravity to gain altitude. This is the vertical climb where it clears the thickest part of the atmosphere. Then, it performs a gravity turn. By tilting, the rocket converts its upward thrust into horizontal speed, which is what keeps it from falling back. Think of it like a ball thrown so fast that the curve of its fall matches the curve of the Earth. Does that distinction between height and speed make sense?",
+    "error": null,
+    "question": "How do rockets actually reach orbit?"
+   }
+  }
+ ],
+ "note": "Verbatim agent trace from a live session on this Space. Timing in seconds from turn start. 'Researching:' status lines show the Nemotron 3 Nano planner's queries verbatim."
+}

traces/trace-space-exploration.json

@@ -0,0 +1,233 @@
+{
+ "question": "What happened in space exploration this month?",
+ "events": [
+  {
+   "t": 1.22,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Thinking\u2026"
+   }
+  },
+  {
+   "t": 7.28,
+   "event": {
+    "type": "status",
+    "status": "thinking",
+    "detail": "Deciding what context I need\u2026"
+   }
+  },
+  {
+   "t": 10.63,
+   "event": {
+    "type": "status",
+    "status": "searching",
+    "detail": "Researching: space exploration news June 2026 \u00b7 NASA SpaceX ESA space missions June 2026"
+   }
+  },
+  {
+   "t": 13.05,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Preparing your whiteboard lesson\u2026"
+   }
+  },
+  {
+   "t": 33.97,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 1"
+   }
+  },
+  {
+   "t": 33.97,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "It has been a massive month for space exploration, especially with the Artemis program reaching some huge milestones for lunar exploration.",
+     "board": [
+      {
+       "op": "clear"
+      },
+      {
+       "op": "title",
+       "text": "June 2026 Space Milestones"
+      },
+      {
+       "op": "notes",
+       "title": "Key Events",
+       "lines": [
+        "Artemis III Crew Named",
+        "Luca Parmitano Selection",
+        "Artemis II Flyby (April)",
+        "Starlink Growth"
+       ],
+       "at": [
+        54.0,
+        20.0
+       ],
+       "color": "gray"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 9.51s \u2014 stripped for repo size>",
+     "dur": 9.51,
+     "i": 0
+    }
+   }
+  },
+  {
+   "t": 50.42,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 2"
+   }
+  },
+  {
+   "t": 50.42,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "NASA officially announced the crew for Artemis III, which includes a mix of American and international astronauts like the Italian pilot.",
+     "board": [
+      {
+       "op": "ellipse",
+       "at": [
+        10.0,
+        35.0
+       ],
+       "w": 30.0,
+       "h": 20.0,
+       "label": "Artemis III Crew",
+       "color": "blue"
+      },
+      {
+       "op": "box",
+       "at": [
+        43,
+        51
+       ],
+       "w": 25.0,
+       "h": 20.0,
+       "label": "SpaceX Starship",
+       "color": "orange"
+      },
+      {
+       "op": "arrow",
+       "from": [
+        40.0,
+        45.0
+       ],
+       "to": [
+        40.0,
+        55.0
+       ],
+       "label": "Lunar Landing",
+       "color": "ink",
+       "label_at": [
+        26.0,
+        60.0
+       ]
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 9.48s \u2014 stripped for repo size>",
+     "dur": 9.48,
+     "i": 1
+    }
+   }
+  },
+  {
+   "t": 62.98,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 3"
+   }
+  },
+  {
+   "t": 62.98,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Luca Parmitano was selected as the test pilot, and ESA is providing the European Service Module to power the Orion spacecraft.",
+     "board": [
+      {
+       "op": "box",
+       "at": [
+        8,
+        16
+       ],
+       "w": 25.0,
+       "h": 15.0,
+       "label": "ESA Service Module",
+       "color": "green"
+      },
+      {
+       "op": "arrow",
+       "from": [
+        33.0,
+        23.0
+       ],
+       "to": [
+        45.0,
+        62.0
+       ],
+       "label": null,
+       "color": "green"
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 8.29s \u2014 stripped for repo size>",
+     "dur": 8.29,
+     "i": 2
+    }
+   }
+  },
+  {
+   "t": 76.19,
+   "event": {
+    "type": "status",
+    "status": "teaching",
+    "detail": "Teaching \u2014 step 4"
+   }
+  },
+  {
+   "t": 76.19,
+   "event": {
+    "type": "step",
+    "step": {
+     "say": "Beyond the Moon, SpaceX has continued its Starlink expansion with its 50th mission of the year launching this month.",
+     "board": [
+      {
+       "op": "dot",
+       "at": [
+        66.0,
+        50.0
+       ],
+       "color": "red",
+       "label": "Starlink 50",
+       "label_at": [
+        83.0,
+        57.0
+       ]
+      }
+     ],
+     "audio": "<higgs-audio-v2 wav, 7.38s \u2014 stripped for repo size>",
+     "dur": 7.38,
+     "i": 3
+    }
+   }
+  },
+  {
+   "t": 76.19,
+   "event": {
+    "type": "final",
+    "text": "It has been a massive month for space exploration, especially with the Artemis program reaching some huge milestones for lunar exploration. NASA officially announced the crew for Artemis III, which includes a mix of American and international astronauts like the Italian pilot. Luca Parmitano was selected as the test pilot, and ESA is providing the European Service Module to power the Orion spacecraft. Beyond the Moon, SpaceX has continued its Starlink expansion with its 50th mission of the year launching this month.",
+    "error": null,
+    "question": "What happened in space exploration this month?"
+   }
+  }
+ ],
+ "note": "Verbatim agent trace from a live session on this Space. Timing in seconds from turn start. 'Researching:' status lines show the Nemotron 3 Nano planner's queries verbatim."
+}