proxyml 0.1.5__tar.gz → 0.1.6__tar.gz

{proxyml-0.1.5 → proxyml-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyml
-Version: 0.1.5
+Version: 0.1.6
 Summary: Python SDK for calling the ProxyML API
 Author-email: ProxyML <contact@proxyml.ai>
 License:                                  Apache License

{proxyml-0.1.5 → proxyml-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "proxyml"
-version = "0.1.5"
+version = "0.1.6"
 description = "Python SDK for calling the ProxyML API"
 readme = "README.md"
 license = {file = "LICENSE"}

{proxyml-0.1.5 → proxyml-0.1.6}/src/proxyml/__init__.py

@@ -17,6 +17,7 @@ from proxyml.client import (
     delete_model,
     get_usage,
     rotate_key,
+    explain_local,
 )
 from proxyml.schema import (
     get_schema,
@@ -44,6 +45,7 @@ __all__ = [
     "delete_model",
     "get_usage",
     "rotate_key",
+    "explain_local",
     "get_schema",
     "gen_continuous_schema",
     "gen_categorical_schema",

{proxyml-0.1.5 → proxyml-0.1.6}/src/proxyml/client.py

@@ -399,6 +399,27 @@ def list_models() -> list[dict] | None:
     return None
 
 
+def explain_local(instance: list, version: str | None = None) -> dict | None:
+    """Per-feature contribution breakdown for a single instance.
+
+    Returns a dict with ``prediction``, ``feature_contributions`` (sorted by
+    abs_contribution descending), ``intercept``, optional ``probabilities``
+    (classification), and optional ``per_class_contributions`` (multiclass).
+    """
+    payload: dict = {"instance": instance}
+    if version is not None:
+        payload["version"] = version
+    r = post(endpoint="/explain/local", payload=payload)
+    if r.status_code == 200:
+        return r.json()
+    logger.error(
+        "Local explanation failed with status %s: %s",
+        r.status_code,
+        r.text,
+    )
+    return None
+
+
 def delete_model(model_id: str) -> bool:
     """Delete a surrogate model by its UUID. Returns True on success, False if not found."""
     r = delete(endpoint=f'/surrogate/models/{model_id}')

{proxyml-0.1.5 → proxyml-0.1.6}/src/proxyml.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyml
-Version: 0.1.5
+Version: 0.1.6
 Summary: Python SDK for calling the ProxyML API
 Author-email: ProxyML <contact@proxyml.ai>
 License:                                  Apache License