iints-sdk-python35 1.1.0__tar.gz → 1.1.1__tar.gz

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.1.0
+Version: 1.1.1
 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
@@ -81,7 +81,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
-## AI Assistant (Ministral via Ollama)
+## AI Assistant (Ministral 3 Open-Weight via Ollama)
 
 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.
@@ -95,11 +95,19 @@ python -m pip install -U pip
 python -m pip install -e ".[mdmp]"
 ```
 
-Run Ministral locally with Ollama:
+Run the open local Mistral model locally with Ollama:
 
 ```bash
-ollama pull mistral/ministral-8b-instruct
-iints ai local-check --model ministral
+python -m pip install -e ".[mdmp]"
+ollama pull ministral-3:8b
+iints ai models
+```
+
+Recommended first-time setup:
+
+```bash
+ollama pull ministral-3:8b
+iints ai local-check --model ministral-3:8b
 ```
 
 Example commands:
@@ -116,6 +124,8 @@ iints ai report results/simulation_run.json \
 Notes:
 - AI analysis is blocked if the MDMP artifact is invalid.
 - Minimum required MDMP grade defaults to `research_grade`.
+- The SDK now targets the open local `Ministral 3` Ollama model by default.
+- Users can choose a larger or smaller local Mistral-family model with `--model ...`.
 - Large JSON payloads are clipped automatically before prompt generation to keep local inference stable.
 - Output is research-only and not medical advice.
 

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/README.md

@@ -30,7 +30,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
-## AI Assistant (Ministral via Ollama)
+## AI Assistant (Ministral 3 Open-Weight via Ollama)
 
 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.
@@ -44,11 +44,19 @@ python -m pip install -U pip
 python -m pip install -e ".[mdmp]"
 ```
 
-Run Ministral locally with Ollama:
+Run the open local Mistral model locally with Ollama:
 
 ```bash
-ollama pull mistral/ministral-8b-instruct
-iints ai local-check --model ministral
+python -m pip install -e ".[mdmp]"
+ollama pull ministral-3:8b
+iints ai models
+```
+
+Recommended first-time setup:
+
+```bash
+ollama pull ministral-3:8b
+iints ai local-check --model ministral-3:8b
 ```
 
 Example commands:
@@ -65,6 +73,8 @@ iints ai report results/simulation_run.json \
 Notes:
 - AI analysis is blocked if the MDMP artifact is invalid.
 - Minimum required MDMP grade defaults to `research_grade`.
+- The SDK now targets the open local `Ministral 3` Ollama model by default.
+- Users can choose a larger or smaller local Mistral-family model with `--model ...`.
 - Large JSON payloads are clipped automatically before prompt generation to keep local inference stable.
 - Output is research-only and not medical advice.
 

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "1.1.0"
+version = "1.1.1"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints/ai/__init__.py

@@ -1,6 +1,7 @@
 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
 
 __all__ = [
     "AIResponse",
@@ -10,4 +11,6 @@ __all__ = [
     "OllamaBackend",
     "GuardResult",
     "MDMPGuard",
+    "LocalMistralModelProfile",
+    "list_local_mistral_models",
 ]

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints/ai/backends/mistral_api.py

@@ -13,5 +13,5 @@ class MistralAPIBackend:
     def complete(self, *, system_prompt: str, user_prompt: str) -> str:
         raise RuntimeError(
             "Cloud fallback is not enabled in this SDK build yet. "
-            "Use mode='local' with Ollama for Ministral."
+            "Use mode='local' with Ollama for the open Ministral 3 model."
         )

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints/ai/backends/ollama.py

@@ -6,12 +6,19 @@ from urllib import error, request
 
 
 DEFAULT_OLLAMA_HOST = "http://127.0.0.1:11434"
-DEFAULT_MINISTRAL_MODEL = "mistral/ministral-8b-instruct"
+DEFAULT_MINISTRAL_MODEL = "ministral-3:8b"
+LEGACY_MINISTRAL_MODEL = "mistral/ministral-8b-instruct"
+MIN_OLLAMA_VERSION_FOR_MINISTRAL_3 = (0, 13, 1)
 MINISTRAL_MODEL_ALIASES = (
     DEFAULT_MINISTRAL_MODEL,
+    "ministral-3",
+    "ministral-3:latest",
+    "ministral-3:8b",
+    "ministral-3:8b-instruct",
     "ministral",
     "ministral-8b",
     "ministral-8b-instruct",
+    LEGACY_MINISTRAL_MODEL,
 )
 
 
@@ -23,7 +30,7 @@ class OllamaBackend:
         *,
         model_name: str = DEFAULT_MINISTRAL_MODEL,
         base_url: str | None = None,
-        timeout_seconds: float = 60.0,
+        timeout_seconds: float = 120.0,
     ) -> None:
         self.model_name = model_name
         self.base_url = (base_url or os.getenv("OLLAMA_HOST") or DEFAULT_OLLAMA_HOST).rstrip("/")
@@ -33,6 +40,28 @@ class OllamaBackend:
     def _pull_hint(self) -> str:
         return f"ollama pull {self.model_name}"
 
+    def _requires_ministral_3_runtime(self) -> bool:
+        requested = self.model_name.strip().lower()
+        return requested.startswith("ministral-3") or requested == "ministral"
+
+    @staticmethod
+    def _parse_version(raw_version: str) -> tuple[int, ...] | None:
+        value = raw_version.strip().lower().lstrip("v")
+        numeric_parts: list[int] = []
+        for part in value.split("."):
+            digits = ""
+            for char in part:
+                if char.isdigit():
+                    digits += char
+                else:
+                    break
+            if not digits:
+                break
+            numeric_parts.append(int(digits))
+        if not numeric_parts:
+            return None
+        return tuple(numeric_parts)
+
     def _request_json(
         self,
         path: str,
@@ -79,6 +108,27 @@ class OllamaBackend:
             return False
         return True
 
+    def server_version(self) -> str | None:
+        try:
+            response = self._request_json("/api/version", method="GET")
+        except Exception:
+            return None
+        raw_version = response.get("version")
+        if isinstance(raw_version, str) and raw_version.strip():
+            return raw_version.strip()
+        return None
+
+    def version_supported(self) -> tuple[bool | None, str | None]:
+        version = self.server_version()
+        if version is None:
+            return None, None
+        if not self._requires_ministral_3_runtime():
+            return True, version
+        parsed = self._parse_version(version)
+        if parsed is None:
+            return None, version
+        return parsed >= MIN_OLLAMA_VERSION_FOR_MINISTRAL_3, version
+
     def list_models(self) -> list[str]:
         response = self._request_json("/api/tags", method="GET")
         raw_models = response.get("models", [])
@@ -102,12 +152,24 @@ class OllamaBackend:
             return installed_lookup[self.model_name.lower()]
 
         requested = self.model_name.strip().lower()
-        if requested in {"ministral", "ministral-8b", "ministral-8b-instruct"}:
+        if requested in {
+            "ministral",
+            "ministral-3",
+            "ministral-3:latest",
+            "ministral-3:8b",
+            "ministral-3:8b-instruct",
+            "ministral-8b",
+            "ministral-8b-instruct",
+        }:
             for alias in MINISTRAL_MODEL_ALIASES:
                 resolved = installed_lookup.get(alias.lower())
                 if resolved is not None:
                     return resolved
 
+        for installed_name in installed:
+            lowered = installed_name.lower()
+            if "ministral-3" in lowered and "8b" in lowered:
+                return installed_name
         for installed_name in installed:
             lowered = installed_name.lower()
             if "ministral" in lowered and "8b" in lowered:
@@ -116,6 +178,14 @@ class OllamaBackend:
         return None
 
     def ensure_model_ready(self) -> str:
+        version_ok, version = self.version_supported()
+        if version_ok is False:
+            required_version = ".".join(str(part) for part in MIN_OLLAMA_VERSION_FOR_MINISTRAL_3)
+            raise RuntimeError(
+                "The open Ministral 3 local model requires a newer Ollama runtime.\n"
+                f"Detected Ollama: {version}\n"
+                f"Required Ollama: >= {required_version}"
+            )
         try:
             resolved = self.resolve_model_name()
         except RuntimeError:
@@ -137,6 +207,7 @@ class OllamaBackend:
         return resolved
 
     def healthcheck(self) -> dict[str, object]:
+        version_ok, version = self.version_supported()
         installed = self.list_models()
         resolved = self.resolve_model_name() if installed else None
         return {
@@ -148,6 +219,8 @@ class OllamaBackend:
             "ready": resolved is not None,
             "pull_command": None if resolved is not None else self._pull_hint(),
             "timeout_seconds": self.timeout_seconds,
+            "server_version": version,
+            "version_ok": version_ok,
         }
 
     def complete(self, *, system_prompt: str, user_prompt: str) -> str:

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints/ai/cli.py

@@ -7,10 +7,12 @@ from typing import Any, Optional
 import typer
 from rich.console import Console
 from rich.panel import Panel
+from rich.table import Table
 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
 
 
 app = typer.Typer(help="Research-only AI assistant commands gated by MDMP certification.")
@@ -64,6 +66,7 @@ def _render_local_check(console: Console, status: dict[str, object]) -> None:
                     f"Endpoint: {status.get('base_url')}",
                     f"Requested model: {status.get('requested_model')}",
                     f"Resolved local model: {resolved_model}",
+                    f"Server version: {status.get('server_version') or 'unknown'}",
                     f"Timeout (s): {status.get('timeout_seconds')}",
                     f"Installed models: {installed_text}",
                     (
@@ -78,9 +81,40 @@ def _render_local_check(console: Console, status: dict[str, object]) -> None:
         )
     )
     if ready:
-        console.print("[green]Local Ollama backend is ready for Ministral inference.[/green]")
+        console.print("[green]Local Ollama backend is ready for open Ministral 3 inference.[/green]")
     else:
         console.print("[bold red]Local Ollama backend is reachable, but the requested model is missing.[/bold red]")
+    if status.get("version_ok") is False:
+        console.print("[bold red]Ollama is too old for the open Ministral 3 runtime.[/bold red]")
+
+
+@app.command("models")
+def models() -> None:
+    console = Console()
+    table = Table(title="IINTS AI Local Mistral Model Guide")
+    table.add_column("Model Tag", style="cyan", no_wrap=True)
+    table.add_column("Best For", style="green")
+    table.add_column("Approx Download")
+    table.add_column("System RAM")
+    table.add_column("GPU VRAM")
+    table.add_column("Notes", overflow="fold")
+
+    for profile in list_local_mistral_models():
+        vram = f"{profile.recommended_vram_gb}+ GB" if profile.recommended_vram_gb is not None else "CPU-only"
+        table.add_row(
+            profile.tag,
+            profile.fit,
+            f"{profile.approx_download_gb:.1f} GB",
+            f"{profile.recommended_system_ram_gb}+ GB",
+            vram,
+            profile.notes,
+        )
+
+    console.print(table)
+    console.print(
+        "[dim]Tip:[/dim] start with "
+        f"`{DEFAULT_MINISTRAL_MODEL}` unless you know your hardware can comfortably run a larger local model."
+    )
 
 
 def _build_assistant(

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

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .backends.ollama import DEFAULT_MINISTRAL_MODEL
+
+
+@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, ...] = ()
+
+
+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",),
+    ),
+)
+
+
+def list_local_mistral_models() -> list[LocalMistralModelProfile]:
+    return list(LOCAL_MISTRAL_MODEL_PROFILES)

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints_sdk_python35.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.1.0
+Version: 1.1.1
 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
@@ -81,7 +81,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
-## AI Assistant (Ministral via Ollama)
+## AI Assistant (Ministral 3 Open-Weight via Ollama)
 
 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.
@@ -95,11 +95,19 @@ python -m pip install -U pip
 python -m pip install -e ".[mdmp]"
 ```
 
-Run Ministral locally with Ollama:
+Run the open local Mistral model locally with Ollama:
 
 ```bash
-ollama pull mistral/ministral-8b-instruct
-iints ai local-check --model ministral
+python -m pip install -e ".[mdmp]"
+ollama pull ministral-3:8b
+iints ai models
+```
+
+Recommended first-time setup:
+
+```bash
+ollama pull ministral-3:8b
+iints ai local-check --model ministral-3:8b
 ```
 
 Example commands:
@@ -116,6 +124,8 @@ iints ai report results/simulation_run.json \
 Notes:
 - AI analysis is blocked if the MDMP artifact is invalid.
 - Minimum required MDMP grade defaults to `research_grade`.
+- The SDK now targets the open local `Ministral 3` Ollama model by default.
+- Users can choose a larger or smaller local Mistral-family model with `--model ...`.
 - Large JSON payloads are clipped automatically before prompt generation to keep local inference stable.
 - Output is research-only and not medical advice.
 

{iints_sdk_python35-1.1.0 → iints_sdk_python35-1.1.1}/src/iints_sdk_python35.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/iints/ai/__init__.py
 src/iints/ai/assistant.py
 src/iints/ai/cli.py
 src/iints/ai/mdmp_guard.py
+src/iints/ai/model_catalog.py
 src/iints/ai/prompts.py
 src/iints/ai/backends/__init__.py
 src/iints/ai/backends/base.py