iints-sdk-python35 1.5.9__tar.gz → 1.5.11__tar.gz

{iints_sdk_python35-1.5.9/src/iints_sdk_python35.egg-info → iints_sdk_python35-1.5.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.5.9
+Version: 1.5.11
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 License-Expression: Apache-2.0
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 License-File: LICENSE-MIT-IINTS-LEGACY
-Requires-Dist: fastapi<0.136.4,>=0.115.0
+Requires-Dist: fastapi!=0.136.3,<1.0.0,>=0.115.0
 Requires-Dist: numpy<3.0.0,>=1.24.0
 Requires-Dist: pandas<3.0.0,>=2.0.0
 Requires-Dist: pydantic<3.0.0,>=2.0.0
@@ -34,6 +34,7 @@ Requires-Dist: fpdf2<3.0.0,>=2.8.0; extra == "reports"
 Requires-Dist: matplotlib<4.0.0,>=3.5.0; extra == "reports"
 Requires-Dist: openpyxl<4.0.0,>=3.0.0; extra == "reports"
 Requires-Dist: pillow<13.0.0,>=12.1.1; extra == "reports"
+Requires-Dist: SciencePlots<3.0.0,>=2.1.0; extra == "reports"
 Requires-Dist: seaborn<1.0.0,>=0.11.0; extra == "reports"
 Provides-Extra: full
 Requires-Dist: fpdf2<3.0.0,>=2.8.0; extra == "full"
@@ -41,6 +42,7 @@ Requires-Dist: matplotlib<4.0.0,>=3.5.0; extra == "full"
 Requires-Dist: openpyxl<4.0.0,>=3.0.0; extra == "full"
 Requires-Dist: pyserial<4.0,>=3.5; extra == "full"
 Requires-Dist: pillow<13.0.0,>=12.1.1; extra == "full"
+Requires-Dist: SciencePlots<3.0.0,>=2.1.0; extra == "full"
 Requires-Dist: seaborn<1.0.0,>=0.11.0; extra == "full"
 Provides-Extra: dev
 Requires-Dist: pytest<10.0.0,>=7.0.0; extra == "dev"
@@ -117,13 +119,13 @@ Full documentation: [python35.github.io/IINTS-SDK](https://python35.github.io/II
 
 ## Live Demo
 
-For a Zoom call, jury walkthrough, or sponsor demo where you want to show both the code and the generated outputs in one terminal flow:
+For a Zoom call, jury walkthrough, or sponsor demo where you want the story first and code as proof:
 
 ```bash
-iints demo-live --output-dir results/live_demo
+iints demo eucys --output-dir results/live_demo
 ```
 
-That exports the showable demo script, prints the key SDK calls, runs the demo, and lists the poster plus proof artifacts to open next.
+Use `iints demo doctor` for clinical feedback conversations and `iints demo booth` for public digital-patient demos.
 
 ---
 

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/README.md

@@ -50,13 +50,13 @@ Full documentation: [python35.github.io/IINTS-SDK](https://python35.github.io/II
 
 ## Live Demo
 
-For a Zoom call, jury walkthrough, or sponsor demo where you want to show both the code and the generated outputs in one terminal flow:
+For a Zoom call, jury walkthrough, or sponsor demo where you want the story first and code as proof:
 
 ```bash
-iints demo-live --output-dir results/live_demo
+iints demo eucys --output-dir results/live_demo
 ```
 
-That exports the showable demo script, prints the key SDK calls, runs the demo, and lists the poster plus proof artifacts to open next.
+Use `iints demo doctor` for clinical feedback conversations and `iints demo booth` for public digital-patient demos.
 
 ---
 

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "1.5.9"
+version = "1.5.11"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]
@@ -24,7 +24,7 @@ classifiers = [
     "Development Status :: 5 - Production/Stable",
 ]
 dependencies = [
-    "fastapi>=0.115.0,<0.136.4",
+    "fastapi>=0.115.0,!=0.136.3,<1.0.0",
     "numpy>=1.24.0,<3.0.0",
     "pandas>=2.0.0,<3.0.0",
     "pydantic>=2.0.0,<3.0.0",
@@ -44,6 +44,7 @@ reports = [
   "matplotlib>=3.5.0,<4.0.0",
   "openpyxl>=3.0.0,<4.0.0",
   "pillow>=12.1.1,<13.0.0",
+  "SciencePlots>=2.1.0,<3.0.0",
   "seaborn>=0.11.0,<1.0.0",
 ]
 full = [
@@ -52,6 +53,7 @@ full = [
   "openpyxl>=3.0.0,<4.0.0",
   "pyserial>=3.5,<4.0",
   "pillow>=12.1.1,<13.0.0",
+  "SciencePlots>=2.1.0,<3.0.0",
   "seaborn>=0.11.0,<1.0.0",
 ]
 dev = [

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/src/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.5.9"
+    __version__ = "1.5.11"
 
 # 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.
@@ -237,9 +237,10 @@ def generate_agp_assets(
     output_dir: Optional[str] = None,
     subject_name: str = "Research simulation",
     summary_json_path: Optional[str] = None,
+    export_svg: bool = True,
 ) -> Optional[dict]:
     """
-    Export AGP-style PNG assets and summary JSON from dense CGM/simulation data.
+    Export AGP-style PNG/SVG assets and summary JSON from dense CGM/simulation data.
     """
     if output_dir is None:
         return None
@@ -249,6 +250,7 @@ def generate_agp_assets(
         output_dir,
         subject_name=subject_name,
         summary_json_path=summary_json_path,
+        export_svg=export_svg,
     )
 
 # You can also define __all__ to explicitly control what gets imported with `from iints import *`

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/src/iints/ai/__init__.py

@@ -1,7 +1,15 @@
 from .assistant import AIResponse, IINTSAssistant
 from .backends import DEFAULT_MINISTRAL_MODEL, DEFAULT_OLLAMA_HOST, OllamaBackend
 from .mdmp_guard import GuardResult, MDMPGuard
-from .model_catalog import LocalMistralModelProfile, list_local_mistral_models
+from .model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    LocalMistralModelProfile,
+    MistralAPIMigrationProfile,
+    list_local_mistral_models,
+    list_mistral_api_migrations,
+    migrate_mistral_api_model,
+)
 from .prepare import prepare_ai_ready_artifacts
 
 __all__ = [
@@ -12,7 +20,12 @@ __all__ = [
     "OllamaBackend",
     "GuardResult",
     "MDMPGuard",
+    "DEFAULT_MISTRAL_API_MODEL",
+    "DEFAULT_MISTRAL_API_REASONING_EFFORT",
     "LocalMistralModelProfile",
+    "MistralAPIMigrationProfile",
     "list_local_mistral_models",
+    "list_mistral_api_migrations",
+    "migrate_mistral_api_model",
     "prepare_ai_ready_artifacts",
 ]

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/src/iints/ai/assistant.py

@@ -82,12 +82,20 @@ class IINTSAssistant:
             ollama_backend.ensure_model_ready()
             return local_backend
         if requested == "api":
-            api_backend: CompletionBackend = MistralAPIBackend()
+            api_backend: CompletionBackend = MistralAPIBackend(model_name=model)
             if api_backend.available():
                 return api_backend
+            api_model = getattr(api_backend, "model_name", "mistral-small-latest")
+            api_reasoning = getattr(api_backend, "reasoning_effort", None)
+            reasoning_hint = (
+                f" with reasoning_effort='{api_reasoning}'"
+                if isinstance(api_reasoning, str) and api_reasoning.strip()
+                else ""
+            )
             raise RuntimeError(
                 "Cloud API fallback is not enabled in this SDK build yet. "
-                "Use mode='local' with Ollama."
+                "Use mode='local' with Ollama, or configure an external Mistral client with "
+                f"`{api_model}`{reasoning_hint}."
             )
         raise ValueError(f"Unsupported AI mode: {mode}")
 
@@ -125,3 +133,6 @@ class IINTSAssistant:
 
     def review_realism(self, run: dict[str, Any]) -> AIResponse:
         return self._run_task("review_realism", run)
+
+    def predict_insulin(self, payload: dict[str, Any]) -> AIResponse:
+        return self._run_task("predict_insulin", payload)

iints_sdk_python35-1.5.11/src/iints/ai/backends/mistral_api.py

@@ -0,0 +1,46 @@
+from __future__ import annotations
+
+from ..model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    migrate_mistral_api_model,
+)
+
+
+class MistralAPIBackend:
+    backend_name = "mistral_api"
+
+    def __init__(
+        self,
+        *,
+        model_name: str = DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort: str | None = DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        **kwargs,
+    ) -> None:
+        migrated_model, migrated_reasoning, migrated = migrate_mistral_api_model(model_name)
+        self.requested_model_name = model_name
+        self.model_name = migrated_model
+        self.reasoning_effort = migrated_reasoning if migrated_reasoning is not None else reasoning_effort
+        self.model_was_migrated = migrated
+
+    def available(self) -> bool:
+        return False
+
+    def complete(self, *, system_prompt: str, user_prompt: str) -> str:
+        migration_hint = (
+            f" Requested deprecated model '{self.requested_model_name}' was mapped to "
+            f"'{self.model_name}'."
+            if self.model_was_migrated
+            else ""
+        )
+        reasoning_hint = (
+            f" Default Mistral reasoning_effort is '{self.reasoning_effort}'."
+            if self.reasoning_effort
+            else ""
+        )
+        raise RuntimeError(
+            "Cloud fallback is not enabled in this SDK build yet. "
+            "Use mode='local' with Ollama for the open Ministral 3 model, or configure "
+            f"your external Mistral client for '{self.model_name}'."
+            f"{reasoning_hint}{migration_hint}"
+        )

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/src/iints/ai/cli.py

@@ -12,7 +12,13 @@ from typing_extensions import Annotated
 
 from .assistant import AIResponse, IINTSAssistant
 from .backends import DEFAULT_MINISTRAL_MODEL, OllamaBackend
-from .model_catalog import list_local_mistral_models
+from .model_catalog import (
+    DEFAULT_MISTRAL_API_MODEL,
+    DEFAULT_MISTRAL_API_REASONING_EFFORT,
+    STRONG_MISTRAL_API_MODEL,
+    list_local_mistral_models,
+    list_mistral_api_migrations,
+)
 from .prepare import prepare_ai_ready_artifacts
 
 
@@ -183,10 +189,31 @@ def models() -> None:
         )
 
     console.print(table)
+    migration_table = Table(title="Mistral Serverless Migration Guide")
+    migration_table.add_column("Deprecated", style="yellow", overflow="fold")
+    migration_table.add_column("Replacement", style="cyan", no_wrap=True)
+    migration_table.add_column("Reasoning")
+    migration_table.add_column("Retires")
+    migration_table.add_column("Use Case", overflow="fold")
+    for migration_profile in list_mistral_api_migrations():
+        reasoning = migration_profile.reasoning_effort or "n/a"
+        migration_table.add_row(
+            ", ".join(migration_profile.deprecated_models),
+            migration_profile.replacement_model,
+            reasoning,
+            migration_profile.retirement_date,
+            migration_profile.use_case,
+        )
+    console.print(migration_table)
     console.print(
         "[dim]Tip:[/dim] start with "
         f"`{DEFAULT_MINISTRAL_MODEL}` unless you know your hardware can comfortably run a larger local model."
     )
+    console.print(
+        "[dim]Serverless:[/dim] use "
+        f"`{DEFAULT_MISTRAL_API_MODEL}` with `reasoning_effort={DEFAULT_MISTRAL_API_REASONING_EFFORT}` "
+        f"for small reasoning/code tasks, or `{STRONG_MISTRAL_API_MODEL}` for stronger review."
+    )
 
 
 @app.command(name="prepare")

iints_sdk_python35-1.5.11/src/iints/ai/model_catalog.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .backends.ollama import DEFAULT_MINISTRAL_MODEL
+
+DEFAULT_MISTRAL_API_MODEL = "mistral-small-latest"
+DEFAULT_MISTRAL_API_REASONING_EFFORT = "high"
+STRONG_MISTRAL_API_MODEL = "mistral-medium-3-5"
+DEFAULT_MISTRAL_OCR_MODEL = "mistral-ocr-latest"
+DEFAULT_MISTRAL_MODERATION_MODEL = "mistral-moderation-2603"
+DEFAULT_MISTRAL_TRANSCRIBE_MODEL = "voxtral-mini-latest"
+
+
+@dataclass(frozen=True)
+class LocalMistralModelProfile:
+    tag: str
+    label: str
+    approx_download_gb: float
+    recommended_system_ram_gb: int
+    recommended_vram_gb: int | None
+    fit: str
+    notes: str
+    aliases: tuple[str, ...] = ()
+
+
+@dataclass(frozen=True)
+class MistralAPIMigrationProfile:
+    deprecated_models: tuple[str, ...]
+    replacement_model: str
+    reasoning_effort: str | None
+    retirement_date: str
+    use_case: str
+    notes: str
+
+
+LOCAL_MISTRAL_MODEL_PROFILES: tuple[LocalMistralModelProfile, ...] = (
+    LocalMistralModelProfile(
+        tag="ministral-3:3b",
+        label="Ministral 3 3B",
+        approx_download_gb=3.0,
+        recommended_system_ram_gb=16,
+        recommended_vram_gb=6,
+        fit="Entry-level laptop / small edge box",
+        notes="Best starting point for CPU-only systems or modest GPUs. Fastest option, lowest memory pressure.",
+        aliases=("ministral-3:3b",),
+    ),
+    LocalMistralModelProfile(
+        tag=DEFAULT_MINISTRAL_MODEL,
+        label="Ministral 3 8B",
+        approx_download_gb=6.0,
+        recommended_system_ram_gb=24,
+        recommended_vram_gb=10,
+        fit="Balanced desktop / strong laptop",
+        notes="Recommended default for most users. Best trade-off between quality, speed, and local memory footprint.",
+        aliases=("ministral", "ministral-3", "ministral-3:8b"),
+    ),
+    LocalMistralModelProfile(
+        tag="ministral-3:14b",
+        label="Ministral 3 14B",
+        approx_download_gb=10.0,
+        recommended_system_ram_gb=32,
+        recommended_vram_gb=16,
+        fit="High-end workstation",
+        notes="Use when you have plenty of RAM or a strong GPU and want better reasoning depth at the cost of latency.",
+        aliases=("ministral-3:14b",),
+    ),
+)
+
+
+MISTRAL_API_MIGRATION_PROFILES: tuple[MistralAPIMigrationProfile, ...] = (
+    MistralAPIMigrationProfile(
+        deprecated_models=("devstral-small-2507", "devstral-small-latest"),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31",
+        use_case="code and agentic helper",
+        notes="Use Mistral Small 4 through the stable latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("devstral-medium-2507", "devstral-2512", "devstral-latest"),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31 / 2026-07-31",
+        use_case="strong code and research assistant",
+        notes="Use Mistral Medium 3.5 for higher-complexity code/research review.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("magistral-small-2509",),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="small reasoning",
+        notes="Mistral Small 4 now supports adjustable reasoning.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("magistral-medium-2509", "magistral-medium-latest"),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="medium reasoning",
+        notes="Mistral Medium 3.5 supports adjustable reasoning for harder tasks.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=(
+            "mistral-large-2411",
+            "pixtral-large-2411",
+            "mistral-medium-2505",
+            "mistral-medium-2508",
+        ),
+        replacement_model=STRONG_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-05-31 / 2026-08-31",
+        use_case="general strong cloud model",
+        notes="Medium 3.5 is the current stronger general-purpose replacement.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-small-2506",),
+        replacement_model=DEFAULT_MISTRAL_API_MODEL,
+        reasoning_effort=DEFAULT_MISTRAL_API_REASONING_EFFORT,
+        retirement_date="2026-07-31",
+        use_case="small general cloud model",
+        notes="Use the Mistral Small 4 latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("open-mistral-nemo-2407",),
+        replacement_model="ministral-8b-2512",
+        reasoning_effort=None,
+        retirement_date="2026-07-31",
+        use_case="small/low-cost serverless model",
+        notes="Serverless replacement for Nemo. Local SDK defaults still use Ollama `ministral-3:8b`.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-ocr-2505",),
+        replacement_model=DEFAULT_MISTRAL_OCR_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-05-31",
+        use_case="OCR",
+        notes="Use OCR 3 through the latest alias.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("mistral-moderation-2411", "mistral-moderation-latest"),
+        replacement_model=DEFAULT_MISTRAL_MODERATION_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-06-30",
+        use_case="moderation",
+        notes="Use Mistral Moderation 2.",
+    ),
+    MistralAPIMigrationProfile(
+        deprecated_models=("voxtral-mini-2507",),
+        replacement_model=DEFAULT_MISTRAL_TRANSCRIBE_MODEL,
+        reasoning_effort=None,
+        retirement_date="2026-05-31",
+        use_case="audio transcription",
+        notes="Use Voxtral Mini Transcribe 2.0 through the latest alias.",
+    ),
+)
+
+
+def list_local_mistral_models() -> list[LocalMistralModelProfile]:
+    return list(LOCAL_MISTRAL_MODEL_PROFILES)
+
+
+def list_mistral_api_migrations() -> list[MistralAPIMigrationProfile]:
+    return list(MISTRAL_API_MIGRATION_PROFILES)
+
+
+def migrate_mistral_api_model(model_name: str) -> tuple[str, str | None, bool]:
+    requested = model_name.strip()
+    requested_key = requested.lower()
+    for profile in MISTRAL_API_MIGRATION_PROFILES:
+        if requested_key in {model.lower() for model in profile.deprecated_models}:
+            return profile.replacement_model, profile.reasoning_effort, True
+    return requested, None, False

{iints_sdk_python35-1.5.9 → iints_sdk_python35-1.5.11}/src/iints/ai/prompts.py

@@ -10,6 +10,7 @@ TaskName = Literal[
     "detect_anomalies",
     "generate_report",
     "review_realism",
+    "predict_insulin",
 ]
 MAX_PROMPT_PAYLOAD_CHARS = 12000
 
@@ -71,6 +72,22 @@ TASK_TEMPLATES: dict[TaskName, str] = {
         "Focus on glycemic ranges, excursion patterns, insulin behavior, safety overrides, and whether the data looks internally coherent.\n\n"
         "Input JSON:\n{data}"
     ),
+    "predict_insulin": (
+        "You are reviewing a simulated bi-hormonal (Insulin + Glucagon) dose candidate inside the IINTS-AF research sandbox.\n"
+        "You are not controlling a real pump, not treating a patient, and not giving medical advice.\n"
+        "You will be provided with the current biological state of the patient, which now includes deep science metrics like "
+        "active_insulin, insulin_effect, plasma_glucagon_pg_ml, and the haaf_metric (Hypoglycemia-Associated Autonomic Failure memory). "
+        "You will also see a mathematically optimal insulin dose calculated by a deterministic MPC solver running differential equations.\n\n"
+        "Your task is to critique the candidate and decide on both Insulin and Glucagon doses for research simulation only. "
+        "Never increase insulin above the deterministic MPC dose or safety caps. "
+        "If glucose is low, predicted low, falling quickly, or active insulin is high, reduce the insulin dose to 0.0. "
+        "If the patient is in severe hypoglycemia risk and HAAF is high (meaning natural rescue is failing), "
+        "you may propose a simulation-only glucagon rescue candidate. The simulator will still apply hard glucagon safety caps.\n"
+        "Respond with a short explanation followed by exactly this format:\n"
+        "FINAL_DOSE: <number>\n"
+        "FINAL_GLUCAGON_DOSE_MG: <number>\n\n"
+        "Input JSON:\n{data}"
+    ),
 }