Restructure repo: src/, frontend/, modal/ dirs; update app_file paths; update .gitignore

.gitignore

@@ -1,15 +1,33 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+.gradio/
+
+# Node
 node_modules/
-build/
+
+# Build artifacts
 dist/
+build/
 coverage/
-.DS_Store
-*.log
+
+# Environment
 .env*
 !.env.example
-__pycache__/
-*.pyc
-.gradio/
-test-qwen/
+
+# OS
+.DS_Store
+*.swp
+
+# Logs
+*.log
+
+# Data / temp
+trace.jsonl
+metadata.json
+*.mp4
+
+# Legacy / experiments
 legacy/
 experimental/
-*.swp

README.md

@@ -5,12 +5,13 @@ colorFrom: red
 colorTo: gray
 sdk: gradio
 sdk_version: 6.16.0
-app_file: server_app.py
+app_file: src/server_app.py
 pinned: false
 license: apache-2.0
 tags:
   - hackathon
   - build-small-hackathon
+  - backyard-ai
   - voice-ai
   - french-learning
   - dental
@@ -18,6 +19,8 @@ tags:
   - modal
   - llama-cpp
   - gemma
+  - off-brand
+  - off-the-grid
 ---
 
 # Patient Virtuel · Français en médecine dentaire
@@ -37,18 +40,24 @@ See [`space_README.md`](space_README.md) for the full description.
 📖 [Field Notes](FIELD_NOTES.md) — architecture decisions, lessons learned, and the story behind the app.
 📡 [Agent Trace](https://huggingface.co/datasets/build-small-hackathon/patient-virtuel-trace) — curated build log on HF Hub (Sharing is Caring badge).
 
+[Demo video](https://youtu.be/oP3KrlZFUPk) · [LinkedIn post](https://www.linkedin.com/posts/carlosduplar_my-wife-is-a-dentist-re-entering-the-workforce-activity-7471897489332289536-p5Ne)
+
 ## Architecture
 
 ```
-server_app.py       → gr.Server backend (API endpoints)
-custom_index.html   → Custom vanilla HTML/CSS/JS frontend
-core.py             → Shared session logic
-llm_engine.py       → Gemma 4 26B-A4B via Modal (llama.cpp runtime)
-stt_engine.py       → faster-whisper via Modal
-tts_engine.py       → piper-tts (local neural, fr_FR-siwis-medium)
-prompts.py          → System prompts
-parse_feedback.py   → Feedback parsing
-modal_app.py        → Modal deployments (llama.cpp + CUDA)
+src/
+  server_app.py       → gr.Server backend (API endpoints)
+  core.py             → Shared session logic
+  llm_engine.py       → Gemma 4 26B-A4B via Modal (llama.cpp runtime)
+  stt_engine.py       → faster-whisper via Modal
+  tts_engine.py       → piper-tts (local neural, fr_FR-siwis-medium)
+  prompts.py          → System prompts
+  parse_feedback.py   → Feedback parsing
+frontend/
+  custom_index.html   → Custom vanilla HTML/CSS/JS frontend
+  style.css           → Styles
+modal/
+  modal_app.py        → Modal deployments (llama.cpp + CUDA)
 ```
 
 ## Running locally

index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>My Google AI Studio App</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
-

metadata.json

@@ -1,5 +0,0 @@
-{
-  "name": "Patient Virtuel: Français en médecine dentaire",
-  "description": "A real-time voice-only interactive app for dental hygienists to practice professional French in a Swiss clinic setting.",
-  "requestFramePermissions": ["microphone"]
-}

space_README.md

@@ -6,9 +6,22 @@ colorTo: gray
 sdk: gradio
 sdk_version: 6.16.0
 python_version: "3.12"
-app_file: server_app.py
+app_file: src/server_app.py
 pinned: false
 license: apache-2.0
+tags:
+  - hackathon
+  - build-small-hackathon
+  - backyard-ai
+  - voice-ai
+  - french-learning
+  - dental
+  - gradio
+  - modal
+  - llama-cpp
+  - gemma
+  - off-brand
+  - off-the-grid
 ---
 
 # Patient Virtuel · Français en médecine dentaire
@@ -34,6 +47,14 @@ This app uses `gradio.Server` with a fully custom HTML/CSS/JS frontend instead o
 - **TTS**: [piper-tts](https://github.com/OHF-Voice/piper1-gpl) (local, `fr_FR-siwis-medium` voice)
 - **STT**: [faster-whisper-large-v3-turbo](https://github.com/SYSTRAN/faster-whisper) via Modal (T4 GPU) — MIT
 
+## Modal
+
+Both GPU workloads (LLM + STT) run on Modal serverless containers. See `modal_app.py` for the full deployment config.
+
+## Social
+
+[Demo video](https://youtu.be/oP3KrlZFUPk) · [LinkedIn post](https://www.linkedin.com/posts/carlosduplar_my-wife-is-a-dentist-re-entering-the-workforce-activity-7471897489332289536-p5Ne)
+
 ## License
 
 All components are Apache 2.0 or MIT licensed.

server_app.py → src/server_app.py

@@ -1,7 +1,10 @@
 import logging
 import os
+import sys
 import tempfile
 
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
 from gradio import Server
 from gradio.data_classes import FileData
 from fastapi.responses import HTMLResponse, FileResponse
@@ -100,7 +103,7 @@ async def serve_audio(filename: str):
 
 @app.get("/", response_class=HTMLResponse)
 async def homepage():
-    html_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "custom_index.html")
+    html_path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "frontend", "custom_index.html")
     with open(html_path, "r", encoding="utf-8") as f:
         return f.read()
 
@@ -149,7 +152,7 @@ _FIELD_NOTES_HTML_TEMPLATE = """\
 
 @app.get("/field-notes", response_class=HTMLResponse)
 async def field_notes():
-    notes_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "FIELD_NOTES.md")
+    notes_path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "FIELD_NOTES.md")
     try:
         with open(notes_path, "r", encoding="utf-8") as f:
             raw = f.read()

vite.config.ts

@@ -1,24 +0,0 @@
-import tailwindcss from '@tailwindcss/vite';
-import react from '@vitejs/plugin-react';
-import path from 'path';
-import {defineConfig, loadEnv} from 'vite';
-
-export default defineConfig(({mode}) => {
-  const env = loadEnv(mode, '.', '');
-  return {
-    plugins: [react(), tailwindcss()],
-    define: {
-      'process.env.GEMINI_API_KEY': JSON.stringify(env.GEMINI_API_KEY),
-    },
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, '.'),
-      },
-    },
-    server: {
-      // HMR is disabled in AI Studio via DISABLE_HMR env var.
-      // Do not modify—file watching is disabled to prevent flickering during agent edits.
-      hmr: process.env.DISABLE_HMR !== 'true',
-    },
-  };
-});