iints-sdk-python35 1.3.0__py3-none-any.whl → 1.3.2__py3-none-any.whl

iints/__init__.py

@@ -11,7 +11,7 @@ except ImportError:  # pragma: no cover - Python < 3.8 fallback
 try:
     __version__ = version("iints-sdk-python35")
 except PackageNotFoundError:  # pragma: no cover - source tree fallback
-    __version__ = "1.3.0"
+    __version__ = "1.3.2"
 
 # Note to developers: this SDK is currently maintained by a single author.
 # Please report bugs via GitHub issues and feel free to contribute fixes via PRs.

iints/analysis/booth_demo.py

@@ -231,9 +231,13 @@ def _build_commands_markdown(
     supervisor_dir = run_outputs["03_supervisor_override"]["output_dir"]
     return (
         "# Booth Demo Commands\n\n"
+        "## Showable live demo script\n\n"
+        "```bash\n"
+        f"python3 {example_script} --output-dir {output_dir}\n"
+        "```\n\n"
         "## Run from source tree\n\n"
         "```bash\n"
-        f"PYTHONPATH=src python3 {example_script} --output-dir {output_dir}\n"
+        f"PYTHONPATH=src python3 examples/demos/06_booth_demo.py --output-dir {output_dir}\n"
         "```\n\n"
         "## Run via installed CLI\n\n"
         "```bash\n"
@@ -258,12 +262,17 @@ def _build_live_demo_script_text(
         "IINTS-AF BOOTH LIVE DEMO SCRIPT\n"
         "===============================\n\n"
         "1. WHAT CODE TO SHOW FIRST\n"
-        "- Show examples/demos/06_booth_demo.py first.\n"
-        "  Reason: it is the shortest, clearest orchestration file and shows the whole story in one screen.\n"
-        "- If someone asks how it really works, open src/iints/analysis/booth_demo.py.\n"
-        "  Reason: that file defines the three scenarios and writes the poster, talk track, and run bundle outputs.\n\n"
+        "- Show examples/demos/07_live_stage_demo.py first.\n"
+        "  Reason: the top of that file exposes the patient profile, output folder, duration, and seed on one screen.\n"
+        "- Point out the visible SDK feature calls in that script:\n"
+        "  run_full(...), generate_results_poster(...), and prepare_ai_ready_artifacts(...).\n"
+        "- Point out that you can swap PATIENT_CONFIG to another packaged profile such as patient_559_config or clinic_safe_hypo_prone.\n"
+        "- If someone asks how the full bundle is generated, open examples/demos/06_booth_demo.py and then src/iints/analysis/booth_demo.py.\n"
+        "  Reason: those files define the three scenarios and write the poster, talk track, and run bundle outputs.\n\n"
         "2. LIVE COMMAND TO RUN\n"
-        "- From the repository root, run:\n"
+        "- From the repository root, run the live stage script:\n"
+        "  ./scripts/run_live_stage_demo.sh\n"
+        "- Or run the booth bundle directly:\n"
         "  ./scripts/run_booth_demo.sh\n"
         "- Or use the installed CLI:\n"
         "  iints demo-booth --output-dir results/booth_demo\n\n"
@@ -304,6 +313,7 @@ def _build_live_demo_script_text(
 def build_booth_demo(
     output_dir: str | Path = "./results/booth_demo",
     *,
+    patient_config: str | Path | dict[str, Any] = "default_patient",
     duration_minutes: int = 360,
     time_step: int = 5,
     seed: int = 42,
@@ -326,7 +336,7 @@ def build_booth_demo(
         outputs = run_full(
             algorithm=spec.algorithm_factory(),
             scenario=spec.scenario,
-            patient_config="default_patient",
+            patient_config=patient_config,
             duration_minutes=duration_minutes,
             time_step=time_step,
             seed=seed,
@@ -375,6 +385,7 @@ def build_booth_demo(
 
     summary_payload = {
         "output_dir": str(resolved_output),
+        "patient_config": str(patient_config),
         "duration_minutes": duration_minutes,
         "time_step_minutes": time_step,
         "seed": seed,
@@ -395,7 +406,7 @@ def build_booth_demo(
     }
     _write_json(resolved_output / "demo_summary.json", summary_payload)
 
-    example_script = Path("examples/demos/06_booth_demo.py")
+    example_script = Path("examples/demos/07_live_stage_demo.py")
     commands_markdown = _build_commands_markdown(
         output_dir=resolved_output,
         example_script=example_script,

iints/cli/cli.py

@@ -53,6 +53,7 @@ from iints.data.registry import (
 )
 from iints.data.contracts import load_contract_yaml
 from iints.data.synthetic_mirror import generate_synthetic_mirror
+from iints.demo_assets import export_live_stage_demo
 from iints.mdmp.backend import (
     MDMP_GRADE_ORDER,
     active_mdmp_backend,
@@ -2740,6 +2741,39 @@ def demo_booth(
     )
 
 
+@app.command("demo-export")
+def demo_export(
+    output_dir: Annotated[
+        Path,
+        typer.Option(help="Directory where the bundled live stage demo files should be written."),
+    ] = Path("./iints_demo"),
+    overwrite: Annotated[
+        bool,
+        typer.Option("--overwrite/--no-overwrite", help="Allow overwriting exported demo files."),
+    ] = False,
+) -> None:
+    """Export the showable live demo code from the installed SDK."""
+    console = Console()
+    try:
+        outputs = export_live_stage_demo(output_dir=output_dir, overwrite=overwrite)
+    except FileExistsError as exc:
+        console.print(f"[bold red]Demo export stopped:[/bold red] {exc}")
+        raise typer.Exit(code=1)
+    except Exception as exc:
+        console.print(f"[bold red]Demo export failed:[/bold red] {exc}")
+        raise typer.Exit(code=1)
+
+    table = Table(title="IINTS Demo Export")
+    table.add_column("Artifact", style="cyan")
+    table.add_column("Path", overflow="fold")
+    table.add_row("script", outputs["script_path"])
+    table.add_row("notes", outputs["notes_path"])
+    console.print(table)
+    console.print(
+        "[green]Next:[/green] open `07_live_stage_demo.py`, explain the visible SDK calls, then run `python 07_live_stage_demo.py`."
+    )
+
+
 @app.command()
 def report(
     results_csv: Annotated[Path, typer.Option(help="Path to a simulation results CSV")],

iints/demo_assets.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from importlib.resources import files
+from pathlib import Path
+
+
+def export_live_stage_demo(output_dir: str | Path = '.', *, overwrite: bool = False) -> dict[str, str]:
+    """Export the bundled live stage demo script for users running the installed SDK."""
+    resolved_output = Path(output_dir).expanduser().resolve()
+    resolved_output.mkdir(parents=True, exist_ok=True)
+
+    script_target = resolved_output / '07_live_stage_demo.py'
+    notes_target = resolved_output / 'RUN_ME_FIRST.txt'
+
+    if not overwrite and script_target.exists():
+        raise FileExistsError(f'Demo script already exists: {script_target}')
+    if not overwrite and notes_target.exists():
+        raise FileExistsError(f'Instruction file already exists: {notes_target}')
+
+    script_content = files('iints.templates.demos').joinpath('live_stage_demo.py').read_text(encoding='utf-8')
+    notes_content = (
+        'IINTS LIVE DEMO EXPORT\n'
+        '======================\n\n'
+        'This folder was exported from the installed IINTS SDK.\n\n'
+        '1. Activate the virtual environment that contains IINTS.\n'
+        '2. Open 07_live_stage_demo.py and point to:\n'
+        '   - PATIENT_CONFIG\n'
+        '   - OUTPUT_DIR\n'
+        '   - DURATION_MINUTES\n'
+        '   - TIME_STEP_MINUTES\n'
+        '   - SEED\n'
+        '3. Explain that the script visibly calls:\n'
+        '   - run_full(...)\n'
+        '   - generate_results_poster(...)\n'
+        '   - prepare_ai_ready_artifacts(...)\n'
+        '4. Run:\n'
+        '   python 07_live_stage_demo.py\n'
+        '5. Open the generated files under results/booth_demo_live/.\n\n'
+        'Tip: if you also cloned the SDK repo, you can run the repo wrapper instead:\n'
+        '  ./scripts/run_live_stage_demo.sh\n'
+    )
+
+    script_target.write_text(script_content, encoding='utf-8')
+    notes_target.write_text(notes_content, encoding='utf-8')
+
+    return {
+        'output_dir': str(resolved_output),
+        'script_path': str(script_target),
+        'notes_path': str(notes_target),
+    }

iints/templates/demos/__init__.py

@@ -0,0 +1 @@
+"""Bundled demo script templates for installed IINTS users."""

iints/templates/demos/live_stage_demo.py

@@ -0,0 +1,410 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+SDK_SRC = Path(__file__).resolve().parents[2] / "src"
+if SDK_SRC.exists():
+    sys.path.insert(0, str(SDK_SRC))
+
+from iints.ai.prepare import prepare_ai_ready_artifacts
+from iints.analysis.poster import generate_results_poster
+from iints.core.algorithms.mock_algorithms import RunawayAIAlgorithm
+from iints.core.algorithms.pid_controller import PIDController
+from iints.highlevel import run_full
+
+# FAIR DEMO SCRIPT
+# ----------------
+# This is the file to show first on a booth stand.
+# It deliberately calls visible SDK features so you can explain the pipeline:
+#
+# 1. `run_full(...)`
+#    Runs a scenario and writes a real run bundle: CSV, PDF report, audit trail,
+#    baseline comparison, metadata, and a reproducibility manifest.
+# 2. `generate_results_poster(...)`
+#    Turns the three run bundles into one visual poster you can show to a jury.
+# 3. `prepare_ai_ready_artifacts(...)`
+#    Prepares the supervisor case for a local AI explanation, gated by MDMP.
+#
+# The knobs below are the first things to point at live.
+PATIENT_CONFIG = "default_patient"
+OUTPUT_DIR = "results/booth_demo_live"
+DURATION_MINUTES = 360
+TIME_STEP_MINUTES = 5
+SEED = 42
+PREPARE_AI = True
+
+# Other good packaged patient configs to mention live:
+# - patient_559_config
+# - clinic_safe_baseline
+# - clinic_safe_stress_meal
+# - clinic_safe_hypo_prone
+# - clinic_safe_hyper_challenge
+# - clinic_safe_midnight
+# - clinic_safe_pizza
+
+
+ScenarioSpec = dict[str, Any]
+
+
+SCENARIOS: list[ScenarioSpec] = [
+    {
+        "slug": "01_normal_run",
+        "label": "Normal Run",
+        "headline": "The controller keeps glucose in range during a calm day.",
+        "algorithm_factory": PIDController,
+        "scenario": {
+            "scenario_name": "Live Demo - Normal Run",
+            "schema_version": "1.1",
+            "scenario_version": "1.0",
+            "description": "One moderate meal to show stable closed-loop control.",
+            "stress_events": [
+                {
+                    "start_time": 45,
+                    "event_type": "meal",
+                    "value": 35,
+                    "reported_value": 35,
+                    "absorption_delay_minutes": 10,
+                    "duration": 45,
+                }
+            ],
+        },
+    },
+    {
+        "slug": "02_meal_stress_test",
+        "label": "Meal Stress Test",
+        "headline": "The same controller handles meals and exercise under stress.",
+        "algorithm_factory": PIDController,
+        "scenario": {
+            "scenario_name": "Live Demo - Meal Stress Test",
+            "schema_version": "1.1",
+            "scenario_version": "1.0",
+            "description": "Two bigger meals plus exercise to stress the controller.",
+            "stress_events": [
+                {
+                    "start_time": 45,
+                    "event_type": "meal",
+                    "value": 70,
+                    "reported_value": 70,
+                    "absorption_delay_minutes": 15,
+                    "duration": 75,
+                },
+                {
+                    "start_time": 150,
+                    "event_type": "meal",
+                    "value": 45,
+                    "reported_value": 45,
+                    "absorption_delay_minutes": 10,
+                    "duration": 50,
+                },
+                {
+                    "start_time": 210,
+                    "event_type": "exercise",
+                    "value": 0.5,
+                    "duration": 35,
+                },
+            ],
+        },
+    },
+    {
+        "slug": "03_supervisor_override",
+        "label": "Supervisor Override",
+        "headline": "A deliberately unsafe AI policy is blocked by the safety supervisor.",
+        "algorithm_factory": lambda: RunawayAIAlgorithm(max_bolus=5.0),
+        "scenario": {
+            "scenario_name": "Live Demo - Supervisor Override",
+            "schema_version": "1.1",
+            "scenario_version": "1.0",
+            "description": "A chaos run where a bad AI keeps asking for too much insulin.",
+            "stress_events": [
+                {
+                    "start_time": 30,
+                    "event_type": "meal",
+                    "value": 60,
+                    "reported_value": 60,
+                },
+                {
+                    "start_time": 120,
+                    "event_type": "exercise",
+                    "value": 0.8,
+                    "duration": 60,
+                },
+                {
+                    "start_time": 200,
+                    "event_type": "sensor_error",
+                    "value": 180,
+                },
+            ],
+        },
+    },
+]
+
+
+def _write_json(path: Path, payload: dict[str, Any]) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(payload, indent=2, sort_keys=True), encoding="utf-8")
+
+
+def _write_text(path: Path, content: str) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+
+
+def _run_single_scenario(
+    spec: ScenarioSpec,
+    *,
+    output_root: Path,
+    patient_config: str,
+    duration_minutes: int,
+    time_step_minutes: int,
+    seed: int,
+) -> dict[str, str]:
+    run_dir = output_root / spec["slug"]
+    outputs = run_full(
+        algorithm=spec["algorithm_factory"](),
+        scenario=spec["scenario"],
+        patient_config=patient_config,
+        duration_minutes=duration_minutes,
+        time_step=time_step_minutes,
+        seed=seed,
+        output_dir=run_dir,
+        enable_profiling=False,
+    )
+    return {
+        "slug": spec["slug"],
+        "label": spec["label"],
+        "headline": spec["headline"],
+        "output_dir": str(run_dir),
+        "results_csv": str(outputs["results_csv"]),
+        "report_pdf": str(outputs["report_pdf"]),
+        "run_manifest_path": str(outputs["run_manifest_path"]),
+        "run_metadata_path": str(outputs["run_metadata_path"]),
+    }
+
+
+def _build_demo_summary(
+    *,
+    output_dir: Path,
+    patient_config: str,
+    duration_minutes: int,
+    time_step_minutes: int,
+    seed: int,
+    scenario_outputs: list[dict[str, str]],
+    poster_outputs: dict[str, str],
+    ai_outputs: dict[str, str],
+    ai_status: str,
+) -> dict[str, Any]:
+    return {
+        "output_dir": str(output_dir),
+        "patient_config": patient_config,
+        "duration_minutes": duration_minutes,
+        "time_step_minutes": time_step_minutes,
+        "seed": seed,
+        "poster_png": poster_outputs["poster_png"],
+        "poster_summary_json": poster_outputs["summary_json"],
+        "ai_status": ai_status,
+        "scenarios": scenario_outputs,
+        "ai_outputs": ai_outputs,
+    }
+
+
+def _build_jury_talk_track(summary: dict[str, Any]) -> str:
+    lines = [
+        "# IINTS-AF Jury Talk Track",
+        "",
+        "## What this script shows",
+        "",
+        "- `run_full(...)` for real reproducible run bundles",
+        "- `generate_results_poster(...)` for one visual story",
+        "- `prepare_ai_ready_artifacts(...)` for optional local AI explanation",
+        "",
+        "## Walkthrough",
+        "",
+        "1. Show the constants at the top of `examples/demos/07_live_stage_demo.py`.",
+        "2. Say that swapping `PATIENT_CONFIG` reruns the same pipeline for another patient.",
+        "3. Run `./scripts/run_live_stage_demo.sh`.",
+        "4. Open the poster and explain the three panels from left to right.",
+        "5. If someone wants proof, open a scenario folder and show `results.csv`, `clinical_report.pdf`, and `run_manifest.json`.",
+        "",
+        "## Scenario story",
+        "",
+    ]
+    for scenario in summary["scenarios"]:
+        lines.extend(
+            [
+                f"### {scenario['label']}",
+                "",
+                f"- {scenario['headline']}",
+                f"- Run folder: `{scenario['output_dir']}`",
+                f"- CSV: `{scenario['results_csv']}`",
+                f"- PDF: `{scenario['report_pdf']}`",
+                "",
+            ]
+        )
+    lines.extend(
+        [
+            "## Optional AI step",
+            "",
+            summary["ai_status"],
+            "",
+            "```bash",
+            "iints ai local-check --model ministral-3:3b",
+            f"iints ai report {summary['scenarios'][2]['output_dir']} --model ministral-3:3b",
+            f"iints ai explain {summary['scenarios'][2]['output_dir']} --model ministral-3:3b",
+            "```",
+            "",
+        ]
+    )
+    return "\n".join(lines) + "\n"
+
+
+def _build_live_demo_notes(summary: dict[str, Any]) -> str:
+    return (
+        "IINTS-AF LIVE DEMO NOTES\n"
+        "========================\n\n"
+        "1. Show `examples/demos/07_live_stage_demo.py`.\n"
+        "2. Point to PATIENT_CONFIG, OUTPUT_DIR, DURATION_MINUTES, TIME_STEP_MINUTES, and SEED.\n"
+        "3. Explain that the script visibly uses these SDK features:\n"
+        "   - run_full(...)\n"
+        "   - generate_results_poster(...)\n"
+        "   - prepare_ai_ready_artifacts(...)\n\n"
+        "4. Run: ./scripts/run_live_stage_demo.sh\n"
+        f"5. Open poster: {summary['poster_png']}\n"
+        f"6. Normal run folder: {summary['scenarios'][0]['output_dir']}\n"
+        f"7. Stress run folder: {summary['scenarios'][1]['output_dir']}\n"
+        f"8. Supervisor run folder: {summary['scenarios'][2]['output_dir']}\n\n"
+        "9. Explain the three panels:\n"
+        "   - Normal Run = control case\n"
+        "   - Meal Stress Test = harder physiology\n"
+        "   - Supervisor Override = bad AI gets blocked\n"
+    )
+
+
+def _build_run_commands(summary: dict[str, Any]) -> str:
+    supervisor_dir = summary["scenarios"][2]["output_dir"]
+    return (
+        "# Live Demo Commands\n\n"
+        "## Showable script\n\n"
+        "```bash\n"
+        "python3 examples/demos/07_live_stage_demo.py\n"
+        "```\n\n"
+        "## Recommended live command\n\n"
+        "```bash\n"
+        "./scripts/run_live_stage_demo.sh\n"
+        "```\n\n"
+        "## Installed CLI alternative\n\n"
+        "```bash\n"
+        "iints demo-booth --output-dir results/booth_demo\n"
+        "```\n\n"
+        "## Optional AI step\n\n"
+        "```bash\n"
+        "iints ai local-check --model ministral-3:3b\n"
+        f"iints ai report {supervisor_dir} --model ministral-3:3b\n"
+        f"iints ai explain {supervisor_dir} --model ministral-3:3b\n"
+        "```\n"
+    )
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Fair-friendly live demo runner for the IINTS-AF SDK.")
+    parser.add_argument("--patient-config", default=PATIENT_CONFIG, help="Packaged patient profile name or path to a YAML config.")
+    parser.add_argument("--output-dir", default=OUTPUT_DIR, help="Directory where the demo bundle should be written.")
+    parser.add_argument("--duration", type=int, default=DURATION_MINUTES, help="Simulation duration in minutes.")
+    parser.add_argument("--time-step", type=int, default=TIME_STEP_MINUTES, help="Simulation time step in minutes.")
+    parser.add_argument("--seed", type=int, default=SEED, help="Deterministic random seed.")
+    parser.add_argument(
+        "--prepare-ai",
+        dest="prepare_ai",
+        action="store_true",
+        default=PREPARE_AI,
+        help="Prepare AI-ready artifacts for the Supervisor Override scenario.",
+    )
+    parser.add_argument(
+        "--skip-ai",
+        dest="prepare_ai",
+        action="store_false",
+        help="Skip AI-ready artifact generation.",
+    )
+    args = parser.parse_args()
+
+    output_dir = Path(args.output_dir).expanduser().resolve()
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    scenario_outputs = [
+        _run_single_scenario(
+            spec,
+            output_root=output_dir,
+            patient_config=args.patient_config,
+            duration_minutes=args.duration,
+            time_step_minutes=args.time_step,
+            seed=args.seed,
+        )
+        for spec in SCENARIOS
+    ]
+
+    poster_outputs = generate_results_poster(
+        run_dirs=[item["output_dir"] for item in scenario_outputs],
+        labels=[item["label"] for item in scenario_outputs],
+        output_path=output_dir / "booth_demo_poster.png",
+        summary_output_path=output_dir / "booth_demo_poster.json",
+        poster_title="288 Decisions. Every Day. We Test Them All.",
+        subtitle="Three SDK features in one story: simulate, stress, and protect.",
+    )
+
+    ai_outputs: dict[str, str] = {}
+    ai_status = "AI preparation was skipped."
+    if args.prepare_ai:
+        try:
+            ai_outputs = prepare_ai_ready_artifacts(scenario_outputs[2]["output_dir"], create_dev_mdmp_cert=True)
+            ai_status = "AI-ready artifacts were created for the Supervisor Override scenario."
+        except Exception as exc:
+            ai_status = f"AI preparation did not block the demo, but it could not finish cleanly: {exc}"
+
+    summary = _build_demo_summary(
+        output_dir=output_dir,
+        patient_config=args.patient_config,
+        duration_minutes=args.duration,
+        time_step_minutes=args.time_step,
+        seed=args.seed,
+        scenario_outputs=scenario_outputs,
+        poster_outputs=poster_outputs,
+        ai_outputs=ai_outputs,
+        ai_status=ai_status,
+    )
+    _write_json(output_dir / "demo_summary.json", summary)
+    _write_text(output_dir / "JURY_TALK_TRACK.md", _build_jury_talk_track(summary))
+    _write_text(output_dir / "BEURS_LIVE_DEMO_SCRIPT.txt", _build_live_demo_notes(summary))
+    _write_text(output_dir / "run_commands.md", _build_run_commands(summary))
+
+    print("IINTS Live Stage Demo complete.")
+    print(f"Patient config: {args.patient_config}")
+    print("")
+    print("SDK features this script just demonstrated:")
+    print("1. run_full(...) -> real run bundles per scenario")
+    print("2. generate_results_poster(...) -> one poster from those bundles")
+    print("3. prepare_ai_ready_artifacts(...) -> optional AI-ready supervisor case")
+    print("")
+    print("What to show next:")
+    print(f"1. Poster: {poster_outputs['poster_png']}")
+    print(f"2. Jury guide: {output_dir / 'JURY_TALK_TRACK.md'}")
+    print(f"3. Live demo script: {output_dir / 'BEURS_LIVE_DEMO_SCRIPT.txt'}")
+    print(f"4. Commands: {output_dir / 'run_commands.md'}")
+    print("")
+    print("Three scenario folders:")
+    for scenario in scenario_outputs:
+        print(f"- {scenario['label']}: {scenario['output_dir']}")
+    print("")
+    print("Suggested booth flow:")
+    print("- Show the constants and the visible SDK API calls in this file.")
+    print("- Run this script once.")
+    print("- Open the poster and explain the three panels from left to right.")
+    print("- If people want proof, open a scenario folder and show the CSV, PDF, and manifest.")
+    print(json.dumps(summary, indent=2, sort_keys=True))
+
+
+if __name__ == "__main__":
+    main()

{iints_sdk_python35-1.3.0.dist-info → iints_sdk_python35-1.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.3.0
+Version: 1.3.2
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 Project-URL: Homepage, https://github.com/python35/IINTS-SDK
@@ -71,7 +71,7 @@ Docs (GitHub Pages): [python35.github.io/IINTS-SDK](https://python35.github.io/I
 python3 -m venv .venv
 source .venv/bin/activate
 python -m pip install -U pip
-pip install iints-sdk-python35
+python -m pip install -U "iints-sdk-python35[mdmp]"
 ```
 
 ```bash
@@ -81,6 +81,14 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
+If you want the clearest install/path rules first, read:
+- `docs/INSTALLATION.md`
+
+Short rule:
+- installed `iints ...` commands can run from any folder
+- `python -m pip install -e ".[mdmp]"` only works from the SDK repo root
+- after `iints quickstart`, switch into the generated project folder
+
 ## CareLink Import
 
 The SDK can now ingest Medtronic CareLink / MiniMed CSV exports and convert them into the standard IINTS schema:
@@ -127,19 +135,27 @@ That workbench is designed for three things:
 The SDK now includes a research-only AI assistant layer for explanations and run summaries.
 It is gated by MDMP verification before any LLM call is allowed.
 
-Use an active virtual environment for the full flow:
+Use an active virtual environment for the full flow.
+
+If you installed the released SDK from PyPI, run:
 
 ```bash
 python3 -m venv .venv
 source .venv/bin/activate
 python -m pip install -U pip
-python -m pip install -e ".[mdmp]"
+python -m pip install -U "iints-sdk-python35[mdmp]"
+```
+
+If you are developing from source instead, first move into the SDK repo root and then run:
+
+```bash
+cd /path/to/IINTS-SDK
+python -m pip install -U -e ".[mdmp]"
 ```
 
 Run the open local Mistral model locally with Ollama:
 
 ```bash
-python -m pip install -e ".[mdmp]"
 ollama pull ministral-3:8b
 iints ai models
 ```
@@ -239,14 +255,54 @@ You can also run it through the CLI:
 iints demo-booth --output-dir results/booth_demo
 ```
 
+For a cleaner live explanation, show this source file first:
+
+```bash
+examples/demos/07_live_stage_demo.py
+```
+
+That file is deliberately small and readable, so you can point to:
+- `PATIENT_CONFIG`
+- `OUTPUT_DIR`
+- `DURATION_MINUTES`
+- `TIME_STEP_MINUTES`
+- `SEED`
+
+Then run:
+
+```bash
+./scripts/run_live_stage_demo.sh
+```
+
+That shell wrapper resolves the SDK repo root automatically, so it still works if you launch it from another working directory via its full path.
+
+And open:
+- `results/booth_demo_live/booth_demo_poster.png`
+- `results/booth_demo_live/JURY_TALK_TRACK.md`
+- `results/booth_demo_live/BEURS_LIVE_DEMO_SCRIPT.txt`
+
+What makes this script good for a booth:
+- it visibly calls `run_full(...)`
+- it visibly calls `generate_results_poster(...)`
+- it visibly calls `prepare_ai_ready_artifacts(...)`
+- you can point to one patient setting and explain how the same pipeline reruns for another patient
+
+If you installed the SDK on another machine and do not have the repository checkout there, export the same demo code with:
+
+```bash
+iints demo-export --output-dir iints_demo
+cd iints_demo
+python 07_live_stage_demo.py
+```
+
 ## Updating The SDK
 
-If another machine is missing newer commands like `iints ai ...` or `iints demo-booth`, upgrade inside the active virtual environment:
+If another machine is missing newer commands like `iints ai ...` or `iints demo-booth`, upgrade inside the active virtual environment to the latest release:
 
 ```bash
 source .venv/bin/activate
 python -m pip install -U pip
-python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
+python -m pip install -U "iints-sdk-python35[mdmp]"
 hash -r
 python -c "import iints; print(iints.__version__)"
 ```
@@ -260,6 +316,8 @@ iints-sdk-doctor
 Full guide:
 - `docs/UPDATING.md`
 
+If you specifically need to reproduce a known environment, you can pin an exact release number instead of using the unpinned upgrade command above.
+
 Troubleshooting:
 - If `iints ai ...` says `No such command 'ai'`, your environment usually still has a legacy `iints` package installed alongside `iints-sdk-python35`.
 - Run `iints-sdk-doctor` first.
@@ -267,7 +325,7 @@ Troubleshooting:
 
 ```bash
 python -m pip uninstall -y iints iints-sdk-python35
-python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
+python -m pip install -U "iints-sdk-python35[mdmp]"
 hash -r
 ```
 

{iints_sdk_python35-1.3.0.dist-info → iints_sdk_python35-1.3.2.dist-info}/RECORD

@@ -1,4 +1,5 @@
-iints/__init__.py,sha256=s1XULKZVzVJ5hsjHybit0pJpgAHBIVdE-G6wc98TWV4,6879
+iints/__init__.py,sha256=Es2ooqFwm2hLeKbqbJG__d6HA2rdBkMPz27SCe3BIm0,6879
+iints/demo_assets.py,sha256=h9bXB6aBptwtvd2drAjg4wp3XE7zXuESxVG8vJgSUJU,2071
 iints/highlevel.py,sha256=DX12LRmL6YaYY99P0c_P93xfHe4mZjqyLhTYuS6L6hI,20491
 iints/metrics.py,sha256=O9hqOqJpUhUJDqsbfuqRMS9dkV97gzcgh3Y2jYUqHzg,907
 iints/ai/__init__.py,sha256=nyRDcFfSHI4a3NbTvySipFc3_inqRMEsr6xIEipWuyo,575
@@ -15,7 +16,7 @@ iints/ai/backends/ollama.py,sha256=3VWi37ueh7oeNK6tPrq3Ks8gbfQhzgNlMHHnV_6BxAY,1
 iints/analysis/__init__.py,sha256=qz0Su0PtICIBLlUgfq37YW4IkK6BuyfOWaqC6t4NKQM,640
 iints/analysis/algorithm_xray.py,sha256=-AtXkZsgnsiFQ_K-IozjIDWkq-dDn0i0zmqWVMhINP4,15952
 iints/analysis/baseline.py,sha256=PCFVb5vX0lYKChZvVk-8I_B5NLQQwGyx7Y6M3XjpIEY,3458
-iints/analysis/booth_demo.py,sha256=qpcLwLDqEiCon9RrK2GQrNvkdsb6mkoilAv8EXJsT_s,17131
+iints/analysis/booth_demo.py,sha256=nVjn04VLNndfW1WivZvTKOisTV4V9onil5XeCbhqwqA,17900
 iints/analysis/carelink_workbench.py,sha256=SZLUamITycXgJpVUhAvsVmU1H_9vSNxp7zl4Ym2cadA,28241
 iints/analysis/clinical_benchmark.py,sha256=FP3L2Ntub6vpWxCwI91BSQ-Y9pTuFqkt2SYjb91Q7DE,7766
 iints/analysis/clinical_metrics.py,sha256=a9JNEV7Jzr_DZqS5o8UhHpB7TTkBZ9pp_OqSKN43OZc,18441
@@ -39,7 +40,7 @@ iints/api/registry.py,sha256=h2syJwacFbgrtgnVK20JwlXivvVO31zeJ_Ez4KBkn1g,3240
 iints/api/template_algorithm.py,sha256=AFs9AymL3ddWAjgpOkF1Oa3TeOSg56siyDt_BmsAND8,9195
 iints/assets/iints_logo.png,sha256=rWzP8XqIYDrPCTp378w73zA1snKCUHrZ76vwslro-uk,700372
 iints/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-iints/cli/cli.py,sha256=hp2N_1DpRiHkOw6huGAVEOPn-K0sPGokbsxQw6rR0k0,220938
+iints/cli/cli.py,sha256=Gt-OaS4BtSfr5YVB6CQsBFW-7ZPEHOEB8qBn3OQd2a0,222261
 iints/core/__init__.py,sha256=rRH2lTmikavR7BgeJCUla0ZmPbZxATR6rEcSSv_tet4,28
 iints/core/device.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iints/core/device_manager.py,sha256=479_CNn6YescDLWDE7w1BbwuLwRUmCUOColAVTEWQc8,2078
@@ -128,6 +129,8 @@ iints/scenarios/__init__.py,sha256=8rH1LQlxfp6h7vQwkSkOV_HAj1PO61rFZt1e0nAAOE8,1
 iints/scenarios/generator.py,sha256=OJgsBFqByX5wbvaf_Qr1a9Vz8mY7CPvjFJLPBJNfA4Y,3027
 iints/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iints/templates/default_algorithm.py,sha256=Wmo2qByEfH84XZYnMZkSjYPAlTaob71mbUtXGRfxi8s,3486
+iints/templates/demos/__init__.py,sha256=M84ipt4rGkG6Xx8Tb1E4P3fbeTKIvNmz5b_KXNFRNNY,63
+iints/templates/demos/live_stage_demo.py,sha256=AGaI5gMcfri9TUMm1Q0ym6L_flqFQKkQNdIk3L6iJXY,14974
 iints/templates/scenarios/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iints/templates/scenarios/chaos_insulin_stacking.json,sha256=SyQsBsXOFvkoOjCgz3mjP3sYVZwoVzRAr9ix9N5pBKY,648
 iints/templates/scenarios/chaos_runaway_ai.json,sha256=x39fkG_kDIknW7J-_WtbIi9Cg-gxrgfDOpWVb5d9Scw,544
@@ -145,9 +148,9 @@ iints/validation/schemas.py,sha256=uXhiPxyfyvOgCA83ZPBIzlITOu663fWctYxOMXUyf1I,4
 iints/visualization/__init__.py,sha256=OdxVHDpY-9bDt8DTWWd-dspn1p0O9T908Cck-IGFaiM,640
 iints/visualization/cockpit.py,sha256=Y7hoJXcTEWQ8yLiU5X5abT58uqGGsQllftXJwqerG1E,25057
 iints/visualization/uncertainty_cloud.py,sha256=I5nNzSitgai21rkul31YNtJriSEmCeTsW0GWW2HUskY,19848
-iints_sdk_python35-1.3.0.dist-info/licenses/LICENSE,sha256=b1luljj2mWWDW10t_qFIqd9Z6euXAcDBmIXowWuUlm4,1417
-iints_sdk_python35-1.3.0.dist-info/METADATA,sha256=i7LlkYoLExo1fYreCnPQ0wKfGCQV8hY9lS0u6XLp4WM,12639
-iints_sdk_python35-1.3.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-iints_sdk_python35-1.3.0.dist-info/entry_points.txt,sha256=aVioeLytTHG7WM7L3LIZ6XDJCKiSfqG-nVUQDVHPpQk,578
-iints_sdk_python35-1.3.0.dist-info/top_level.txt,sha256=7Usr6NQKiC9SpNFyCis81MmgXy71lDCr5unR8BNXZ0E,6
-iints_sdk_python35-1.3.0.dist-info/RECORD,,
+iints_sdk_python35-1.3.2.dist-info/licenses/LICENSE,sha256=b1luljj2mWWDW10t_qFIqd9Z6euXAcDBmIXowWuUlm4,1417
+iints_sdk_python35-1.3.2.dist-info/METADATA,sha256=FBAzFYfrxxe_oJNkcfuVAQRpIJPoi4ytimYmI4cmTjg,14445
+iints_sdk_python35-1.3.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+iints_sdk_python35-1.3.2.dist-info/entry_points.txt,sha256=aVioeLytTHG7WM7L3LIZ6XDJCKiSfqG-nVUQDVHPpQk,578
+iints_sdk_python35-1.3.2.dist-info/top_level.txt,sha256=7Usr6NQKiC9SpNFyCis81MmgXy71lDCr5unR8BNXZ0E,6
+iints_sdk_python35-1.3.2.dist-info/RECORD,,