| # app.md — Gradio Interface Reference |
|
|
| `app.py` — Gradio multi-tab interactive interface for LifeStack. |
|
|
| --- |
|
|
| ## Overview |
|
|
| `app.py` is the entry point for the demo. It wires together all LifeStack modules into |
| a single Gradio `Blocks` application served on `http://127.0.0.1:7860`. |
|
|
| --- |
|
|
| ## Module-level Singletons |
|
|
| These are instantiated once at import time: |
|
|
| | Variable | Type | Purpose | |
| |---|---|---| |
| | `MEMORY` | `LifeStackMemory` | ChromaDB trajectory + feedback store | |
| | `AGENT` | `LifeStackAgent` | LLM-backed decision agent | |
| | `INTAKE` | `LifeIntake` | NL → structured conflict parser | |
| | `DEMO_CONFLICT` | `ConflictEvent` | Fixed "Friday 6PM" conflict for tab 1 | |
| | `DEMO_PREDICTOR` | `TrajectoryPredictor` | 7-day risk score tracker | |
| | `LONG_DEMO` | `LongitudinalDemo` | Arjun's multi-week journey | |
| | `GMAIL` | `GmailSignalExtractor` | Optional Gmail stress signal extractor | |
|
|
| --- |
|
|
| ## Tabs |
|
|
| | Tab | Label | Key Function | |
| |---|---|---| |
| | 1 | 🎯 Live Demo | `run_demo(person_label, conflict_label)` | |
| | 2 | 💭 Try Your Situation | `run_custom(situation, sliders..., gmail_signals)` | |
| | 3 | 📊 Training Results | `load_training_tab()` | |
| | 4 | 🗓️ Arjun's Journey | `LONG_DEMO.show_longitudinal_comparison()` | |
| | 5 | 🗺️ Task Explorer | `load_demo_task()` | |
| | 6 | 📬 Follow-up | `submit_outcome_feedback(...)` | |
|
|
| --- |
|
|
| ## Key Functions |
|
|
| ### `submit_outcome_feedback(ep_id, score, domains_up, domains_down, notes, time_spent)` |
|
|
| Stores real-world outcome data into ChromaDB via `MEMORY.store_feedback(feedback)`. |
|
|
| > **Note:** Uses `MEMORY` (the module-level `LifeStackMemory` instance). The previously |
| > undefined `AGENT_MEMORY` reference was corrected to `MEMORY` on 2026-04-23. |
| |
| ### `run_demo(person_label, conflict_label)` |
|
|
| Generator — yields `(pred_html, before_html, narrative, decision_html)` tuples for each |
| animation frame. Runs cascade animation then agent intervention. |
|
|
| ### `run_custom(situation, ...)` |
| |
| Calls `INTAKE.full_intake()` to parse NL input, then `AGENT.get_action()`, steps the env, |
| returns `(life_html, after_html, plan_html)`. |
|
|
| --- |
|
|
| ## Running |
|
|
| ```bash |
| python app.py |
| ``` |
|
|
| Starts on port `7860` with `share=False`. Edit `__main__` block to change port/theme. |
|
|
| --- |
|
|
| ## Change Log |
|
|
| | Date | Change | |
| |---|---| |
| | 2026-04-23 | `AGENT_MEMORY` undefined crash fixed — replaced with `MEMORY` in `submit_outcome_feedback` | |
|
|
