ebaml 0.2.0__tar.gz → 0.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. {ebaml-0.2.0 → ebaml-0.2.2}/PKG-INFO +28 -2
  2. {ebaml-0.2.0 → ebaml-0.2.2}/README.md +27 -1
  3. {ebaml-0.2.0 → ebaml-0.2.2}/pyproject.toml +9 -1
  4. {ebaml-0.2.0 → ebaml-0.2.2}/pyproject.toml.orig +14 -1
  5. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/graphs/ebm_graph.py +8 -3
  6. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/graphs/model_kinds.py +1 -0
  7. ebaml-0.2.2/src/ebaml/graphs/terms.py +58 -0
  8. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/descriptors.py +12 -7
  9. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/local/facts.py +10 -4
  10. {ebaml-0.2.0 → ebaml-0.2.2}/LICENSE +0 -0
  11. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/.baml-generator-output-root +0 -0
  12. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/.baml-generator-output.json +0 -0
  13. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/.gitignore +0 -0
  14. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/__init__.py +0 -0
  15. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/__init__.pyi +0 -0
  16. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_baml_sources.py +0 -0
  17. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_function_registry.py +0 -0
  18. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_inlinedbaml.py +0 -0
  19. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_invocation_types.py +0 -0
  20. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_invocation_types.pyi +0 -0
  21. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/_typemap.py +0 -0
  22. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/__init__.py +0 -0
  23. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/__init__.pyi +0 -0
  24. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/clients/__init__.py +0 -0
  25. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/clients/__init__.pyi +0 -0
  26. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/content/__init__.py +0 -0
  27. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/content/__init__.pyi +0 -0
  28. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/errors/__init__.py +0 -0
  29. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/errors/__init__.pyi +0 -0
  30. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/events/__init__.py +0 -0
  31. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/events/__init__.pyi +0 -0
  32. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/internal/__init__.py +0 -0
  33. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/internal/__init__.pyi +0 -0
  34. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/mcp/__init__.py +0 -0
  35. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/mcp/__init__.pyi +0 -0
  36. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/stream/__init__.py +0 -0
  37. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/stream/__init__.pyi +0 -0
  38. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/tools/__init__.py +0 -0
  39. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/tools/__init__.pyi +0 -0
  40. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/wire/__init__.py +0 -0
  41. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/ai/wire/__init__.pyi +0 -0
  42. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/__init__.py +0 -0
  43. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/__init__.pyi +0 -0
  44. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/crypto/__init__.py +0 -0
  45. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/crypto/__init__.pyi +0 -0
  46. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/csv/__init__.py +0 -0
  47. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/csv/__init__.pyi +0 -0
  48. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/env/__init__.py +0 -0
  49. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/env/__init__.pyi +0 -0
  50. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/errors/__init__.py +0 -0
  51. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/errors/__init__.pyi +0 -0
  52. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/fs/__init__.py +0 -0
  53. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/fs/__init__.pyi +0 -0
  54. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/future/__init__.py +0 -0
  55. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/future/__init__.pyi +0 -0
  56. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/glob/__init__.py +0 -0
  57. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/glob/__init__.pyi +0 -0
  58. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/hash/__init__.py +0 -0
  59. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/hash/__init__.pyi +0 -0
  60. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/host/__init__.py +0 -0
  61. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/host/__init__.pyi +0 -0
  62. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/http/__init__.py +0 -0
  63. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/http/__init__.pyi +0 -0
  64. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/io/__init__.py +0 -0
  65. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/io/__init__.pyi +0 -0
  66. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/iter/__init__.py +0 -0
  67. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/iter/__init__.pyi +0 -0
  68. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/json/__init__.py +0 -0
  69. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/json/__init__.pyi +0 -0
  70. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/media/__init__.py +0 -0
  71. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/media/__init__.pyi +0 -0
  72. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/net/__init__.py +0 -0
  73. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/net/__init__.pyi +0 -0
  74. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/ops/__init__.py +0 -0
  75. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/ops/__init__.pyi +0 -0
  76. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/panics/__init__.py +0 -0
  77. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/panics/__init__.pyi +0 -0
  78. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/random/__init__.py +0 -0
  79. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/random/__init__.pyi +0 -0
  80. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/regex/__init__.py +0 -0
  81. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/regex/__init__.pyi +0 -0
  82. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/sap/__init__.py +0 -0
  83. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/sap/__init__.pyi +0 -0
  84. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/spawn/__init__.py +0 -0
  85. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/spawn/__init__.pyi +0 -0
  86. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/sys/__init__.py +0 -0
  87. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/sys/__init__.pyi +0 -0
  88. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/time/__init__.py +0 -0
  89. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/time/__init__.pyi +0 -0
  90. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/toml/__init__.py +0 -0
  91. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/toml/__init__.pyi +0 -0
  92. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/ws/__init__.py +0 -0
  93. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/ws/__init__.pyi +0 -0
  94. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/yaml/__init__.py +0 -0
  95. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/baml/yaml/__init__.pyi +0 -0
  96. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/experimental/__init__.py +0 -0
  97. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/experimental/__init__.pyi +0 -0
  98. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/py.typed +0 -0
  99. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/__init__.py +0 -0
  100. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/__init__.pyi +0 -0
  101. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/class_/__init__.py +0 -0
  102. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/class_/__init__.pyi +0 -0
  103. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/enum/__init__.py +0 -0
  104. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/enum/__init__.pyi +0 -0
  105. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/errors/__init__.py +0 -0
  106. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/errors/__init__.pyi +0 -0
  107. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/function/__init__.py +0 -0
  108. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/function/__init__.pyi +0 -0
  109. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/interface/__init__.py +0 -0
  110. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/reflect/interface/__init__.pyi +0 -0
  111. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/__init__.py +0 -0
  112. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/__init__.pyi +0 -0
  113. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/__init__.py +0 -0
  114. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/__init__.pyi +0 -0
  115. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/internal/__init__.py +0 -0
  116. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/anthropic/internal/__init__.pyi +0 -0
  117. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/assert_/__init__.py +0 -0
  118. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/assert_/__init__.pyi +0 -0
  119. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/__init__.py +0 -0
  120. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/__init__.pyi +0 -0
  121. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/internal/__init__.py +0 -0
  122. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/aws/internal/__init__.pyi +0 -0
  123. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/__init__.py +0 -0
  124. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/__init__.pyi +0 -0
  125. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/internal/__init__.py +0 -0
  126. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/claude_code/internal/__init__.pyi +0 -0
  127. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/google/__init__.py +0 -0
  128. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/google/__init__.pyi +0 -0
  129. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/google/internal/__init__.py +0 -0
  130. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/google/internal/__init__.pyi +0 -0
  131. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/__init__.py +0 -0
  132. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/__init__.pyi +0 -0
  133. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/__init__.py +0 -0
  134. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/__init__.pyi +0 -0
  135. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/decisions/__init__.py +0 -0
  136. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/openai/internal/decisions/__init__.pyi +0 -0
  137. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/testing/__init__.py +0 -0
  138. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/testing/__init__.pyi +0 -0
  139. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/trace/__init__.py +0 -0
  140. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/trace/__init__.pyi +0 -0
  141. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/__init__.py +0 -0
  142. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/__init__.pyi +0 -0
  143. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/internal/__init__.py +0 -0
  144. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/typesafeai/internal/__init__.pyi +0 -0
  145. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/__init__.py +0 -0
  146. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/__init__.pyi +0 -0
  147. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/internal/__init__.py +0 -0
  148. {ebaml-0.2.0 → ebaml-0.2.2}/src/baml_sdk/vendor/vercel/internal/__init__.pyi +0 -0
  149. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/__init__.py +0 -0
  150. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/benchmark.py +0 -0
  151. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/core/__init__.py +0 -0
  152. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/core/custom_types.py +0 -0
  153. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/core/exceptions.py +0 -0
  154. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/graphs/__init__.py +0 -0
  155. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/graphs/graph_text.py +0 -0
  156. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/__init__.py +0 -0
  157. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/options.py +0 -0
  158. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/provider_errors.py +0 -0
  159. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/retry.py +0 -0
  160. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/llm/sdk_setup.py +0 -0
  161. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/local/__init__.py +0 -0
  162. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/local/fact_text.py +0 -0
  163. {ebaml-0.2.0 → ebaml-0.2.2}/src/ebaml/py.typed +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ebaml
3
- Version: 0.2.0
3
+ Version: 0.2.2
4
4
  Summary: BAML for Explainable Boosting Machines: talk to your EBM.
5
5
  Keywords: baml,llm,explainable-ai,explainable-boosting-machine,interpretml
6
6
  Author: Johnny Godoy
@@ -186,7 +186,8 @@ Three keyword-only arguments set the options. `graph=GraphOptions(...)` sets the
186
186
  A multiclass classifier has one graph series per class. `GraphOptions(classes=[...])` selects the classes to describe,
187
187
  because the text of a model with many classes is long. In every bin, the scores have the same mean over all the classes
188
188
  of the model. Only the differences between the classes change the predicted probabilities.
189
- `notebooks/multiclass.py` shows each option on the iris data.
189
+ `notebooks/multiclass.py` shows each option on the iris data. `notebooks/model_kinds.py` compares the graphs and the local
190
+ explanations of a binary classifier, a multiclass classifier and a regressor.
190
191
 
191
192
  <!-- invisible-code-block: python
192
193
  import numpy as np
@@ -304,6 +305,31 @@ compare what the LLM reads for a layperson and a data scientist, and (with a key
304
305
  uv run marimo edit notebooks/local_explanations.py
305
306
  ```
306
307
 
308
+ [`notebooks/model_providers.py`](notebooks/model_providers.py) sends the same request to OpenRouter, OpenAI, Anthropic,
309
+ Ollama and a gateway with an OpenAI-compatible API, one section for each provider. It shows the key that each provider
310
+ needs, and the errors for an unknown provider and a missing key. Each button sends real requests to one provider.
311
+
312
+ ```bash
313
+ uv run marimo edit notebooks/model_providers.py
314
+ ```
315
+
316
+ [`notebooks/multiclass.py`](notebooks/multiclass.py) reads an EBM of the iris data, which has three classes. It shows the
317
+ graph with one series per class, the centring that keeps the predictions, the `classes` and `normalization` options, and
318
+ the errors of wrong options. Two buttons describe a graph and the whole model.
319
+
320
+ ```bash
321
+ uv run marimo edit notebooks/multiclass.py
322
+ ```
323
+
324
+ [`notebooks/model_kinds.py`](notebooks/model_kinds.py) fits a binary classifier, a multiclass classifier and a regressor
325
+ on the same iris features. It compares the kind that `model_kind` reads, the graph text of each kind, the fields of the
326
+ local explanations and the error for the kinds that they do not accept. One button for each model describes the same
327
+ graph.
328
+
329
+ ```bash
330
+ uv run marimo edit notebooks/model_kinds.py
331
+ ```
332
+
307
333
  ## Benchmark
308
334
 
309
335
  The benchmark follows [TalkToEBM's benchmark](https://github.com/interpretml/TalkToEBM/tree/main/benchmark) that checks how well a
@@ -158,7 +158,8 @@ Three keyword-only arguments set the options. `graph=GraphOptions(...)` sets the
158
158
  A multiclass classifier has one graph series per class. `GraphOptions(classes=[...])` selects the classes to describe,
159
159
  because the text of a model with many classes is long. In every bin, the scores have the same mean over all the classes
160
160
  of the model. Only the differences between the classes change the predicted probabilities.
161
- `notebooks/multiclass.py` shows each option on the iris data.
161
+ `notebooks/multiclass.py` shows each option on the iris data. `notebooks/model_kinds.py` compares the graphs and the local
162
+ explanations of a binary classifier, a multiclass classifier and a regressor.
162
163
 
163
164
  <!-- invisible-code-block: python
164
165
  import numpy as np
@@ -276,6 +277,31 @@ compare what the LLM reads for a layperson and a data scientist, and (with a key
276
277
  uv run marimo edit notebooks/local_explanations.py
277
278
  ```
278
279
 
280
+ [`notebooks/model_providers.py`](notebooks/model_providers.py) sends the same request to OpenRouter, OpenAI, Anthropic,
281
+ Ollama and a gateway with an OpenAI-compatible API, one section for each provider. It shows the key that each provider
282
+ needs, and the errors for an unknown provider and a missing key. Each button sends real requests to one provider.
283
+
284
+ ```bash
285
+ uv run marimo edit notebooks/model_providers.py
286
+ ```
287
+
288
+ [`notebooks/multiclass.py`](notebooks/multiclass.py) reads an EBM of the iris data, which has three classes. It shows the
289
+ graph with one series per class, the centring that keeps the predictions, the `classes` and `normalization` options, and
290
+ the errors of wrong options. Two buttons describe a graph and the whole model.
291
+
292
+ ```bash
293
+ uv run marimo edit notebooks/multiclass.py
294
+ ```
295
+
296
+ [`notebooks/model_kinds.py`](notebooks/model_kinds.py) fits a binary classifier, a multiclass classifier and a regressor
297
+ on the same iris features. It compares the kind that `model_kind` reads, the graph text of each kind, the fields of the
298
+ local explanations and the error for the kinds that they do not accept. One button for each model describes the same
299
+ graph.
300
+
301
+ ```bash
302
+ uv run marimo edit notebooks/model_kinds.py
303
+ ```
304
+
279
305
  ## Benchmark
280
306
 
281
307
  The benchmark follows [TalkToEBM's benchmark](https://github.com/interpretml/TalkToEBM/tree/main/benchmark) that checks how well a
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "ebaml"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "BAML for Explainable Boosting Machines: talk to your EBM."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -42,6 +42,14 @@ Changelog = "https://github.com/johnny-godoy/EBaMl/blob/main/CHANGELOG.md"
42
42
 
43
43
  [tool.uv]
44
44
  exclude-newer = "7 days"
45
+ override-dependencies = [
46
+ "mcp>=1.30.0,<2",
47
+ "opentelemetry-api>=1.45.1,<2",
48
+ "opentelemetry-sdk>=1.45.1,<2",
49
+ "opentelemetry-exporter-otlp-proto-http>=1.45.1,<2",
50
+ "opentelemetry-instrumentation-requests>=0.66b0",
51
+ "opentelemetry-instrumentation-threading>=0.66b0",
52
+ ]
45
53
 
46
54
  [tool.uv.exclude-newer-package]
47
55
  certifi = false
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "ebaml"
3
- version = "0.2.0"
3
+ version = "0.2.2"
4
4
  description = "BAML for Explainable Boosting Machines: talk to your EBM."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -43,6 +43,19 @@ exclude-newer = "7 days"
43
43
  # skew error. CI installs the newest toolchain, and toolchain 0.23.0 changed the ai.Client interface, so the repository
44
44
  # needs baml-bridge 0.23.0 at once. Remove the entry once 0.23.0 is more than 7 days old.
45
45
  exclude-newer-package = { certifi = false, baml-bridge = false }
46
+ # reason: semgrep 1.182.1 pins mcp==1.29.0 and opentelemetry-api~=1.37.0, which have 5 known CVEs fixed in mcp 1.30.0
47
+ # and opentelemetry-api 1.45.1. Dependabot cannot update them, so the override forces the fixed releases. The
48
+ # opentelemetry packages must move together, because semgrep fails to import with opentelemetry-api 1.45 and the older
49
+ # exporter. The upper bound keeps mcp on 1.x. Remove the override once semgrep loosens its pins
50
+ # (https://github.com/semgrep/semgrep/issues/12018).
51
+ override-dependencies = [
52
+ "mcp>=1.30.0,<2",
53
+ "opentelemetry-api>=1.45.1,<2",
54
+ "opentelemetry-sdk>=1.45.1,<2",
55
+ "opentelemetry-exporter-otlp-proto-http>=1.45.1,<2",
56
+ "opentelemetry-instrumentation-requests>=0.66b0",
57
+ "opentelemetry-instrumentation-threading>=0.66b0",
58
+ ]
46
59
 
47
60
  [tool.uv.build-backend]
48
61
  # baml_sdk is generated by `baml generate` and gitignored: run it before `uv build`, or the wheel lacks it.
@@ -27,6 +27,7 @@ from ebaml.core.exceptions import (
27
27
  )
28
28
  from ebaml.graphs.graph_text import parse_graph_text, xy_to_json
29
29
  from ebaml.graphs.model_kinds import model_kind
30
+ from ebaml.graphs.terms import main_term
30
31
 
31
32
  # nominal features are unordered categories
32
33
  _FORMAT_ALIASES = {FeatureType.NOMINAL: FeatureType.CATEGORICAL}
@@ -303,7 +304,8 @@ class EBMGraph:
303
304
  ebm: ExplainableBoostingModel
304
305
  The EBM model.
305
306
  feature_index: int
306
- The index of the feature in the EBM.
307
+ The index of the feature in the EBM. A feature that ``exclude`` or ``remove_terms`` left out has no
308
+ main-effect term, and raises ``UnsupportedModelError``.
307
309
  normalization: Normalization | str, default=Normalization.NONE
308
310
  How to normalize the graph (shift on the y-axis).
309
311
  use_feature_bounds: bool, default=True
@@ -336,13 +338,16 @@ class EBMGraph:
336
338
  classes of the model, before it selects ``classes``. The standard deviations stay those of the EBM.
337
339
  The normalization then shifts all the scores by one constant, so the differences between the classes of a bin
338
340
  do not change.
341
+ ``proofs/papers/multiclass-scores/paper.typ`` proves that these graphs keep the predictions of the EBM.
339
342
 
340
343
  """
341
344
  # read the variables from the ebm
342
345
  feature_name = ebm.feature_names_in_[feature_index]
343
346
  feature_type = ebm.feature_types_in_[feature_index]
344
- scores = np.array(ebm.term_scores_[feature_index][1:-1], dtype=float) # Drop missing and unknown bins
345
- stds = np.asarray(ebm.standard_deviations_[feature_index][1:-1], dtype=float)
347
+ # the scores are kept by term, and term i is not always feature i
348
+ term = main_term(ebm, feature_index)
349
+ scores = np.array(ebm.term_scores_[term][1:-1], dtype=float) # Drop missing and unknown bins
350
+ stds = np.asarray(ebm.standard_deviations_[term][1:-1], dtype=float)
346
351
  selected = _select_outputs(model_kind(ebm).outputs, feature_name, scores, stds, classes)
347
352
  scores, stds = selected.scores, selected.stds
348
353
 
@@ -88,6 +88,7 @@ class MulticlassClassifier(ModelKind):
88
88
 
89
89
  Softmax does not change when the same constant is added to the scores of all classes, so only the differences
90
90
  between the classes of a bin carry meaning.
91
+ The proof is in ``proofs/papers/multiclass-scores/paper.typ``.
91
92
 
92
93
  Examples
93
94
  --------
@@ -0,0 +1,58 @@
1
+ """The term of an EBM that holds the main effect of each feature.
2
+
3
+ interpret keeps the scores, the standard deviations, the bin weights and the importances by term, and the names, the
4
+ types and the bins by feature. Term ``i`` is not always feature ``i``: a feature that ``exclude`` leaves out at fit
5
+ time, or that ``remove_terms`` removes later, has no term, and the terms after it move. So other code finds the term
6
+ of a feature here, and does not index the term attributes with the index of a feature.
7
+ """
8
+
9
+ from ebaml.core.custom_types import ExplainableBoostingModel
10
+ from ebaml.core.exceptions import UnsupportedModelError
11
+
12
+
13
+ def main_term(ebm: ExplainableBoostingModel, feature_index: int) -> int:
14
+ """Find the term that holds the main effect of a feature.
15
+
16
+ Parameters
17
+ ----------
18
+ ebm: ExplainableBoostingModel
19
+ The fitted EBM.
20
+ feature_index: int
21
+ The index of the feature in ``feature_names_in_``.
22
+
23
+ Returns
24
+ -------
25
+ int
26
+ The index of the term in ``term_features_``, ``term_scores_`` and the other term attributes.
27
+
28
+ Raises
29
+ ------
30
+ UnsupportedModelError
31
+ If the feature has no main-effect term, because ``exclude`` or ``remove_terms`` left it out.
32
+
33
+ """
34
+ for term_index, features in enumerate(ebm.term_features_):
35
+ if tuple(features) == (feature_index,):
36
+ return term_index
37
+ msg = (
38
+ f"The feature {ebm.feature_names_in_[feature_index]!r} has no main-effect term in the EBM,"
39
+ " because exclude or remove_terms left it out."
40
+ )
41
+ raise UnsupportedModelError(msg)
42
+
43
+
44
+ def main_effect_features(ebm: ExplainableBoostingModel) -> list[int]:
45
+ """List the features that have a main-effect term.
46
+
47
+ Parameters
48
+ ----------
49
+ ebm: ExplainableBoostingModel
50
+ The fitted EBM.
51
+
52
+ Returns
53
+ -------
54
+ list[int]
55
+ The index of each such feature in ``feature_names_in_``, in increasing order.
56
+
57
+ """
58
+ return sorted(features[0] for features in ebm.term_features_ if len(features) == 1)
@@ -16,6 +16,7 @@ from baml_bridge.errors import BamlError
16
16
  from ebaml.core.custom_types import Audience, ExplainableBoostingModel, FeatureValue, coerce_enum
17
17
  from ebaml.core.exceptions import InvalidOptionError
18
18
  from ebaml.graphs.ebm_graph import EBMGraph
19
+ from ebaml.graphs.terms import main_effect_features, main_term
19
20
  from ebaml.llm.options import GraphOptions, ModelOptions, PromptOptions
20
21
  from ebaml.llm.provider_errors import provider_errors
21
22
  from ebaml.llm.retry import call_with_shrinking_graph
@@ -38,7 +39,7 @@ _DEFAULT_PROMPT_OPTIONS = PromptOptions()
38
39
 
39
40
 
40
41
  def _feature_importances_to_text(ebm: ExplainableBoostingModel) -> str:
41
- """Convert the feature importances of an EBM to text.
42
+ """Convert the importances of the main-effect terms of an EBM to text, one line per feature.
42
43
 
43
44
  Parameters
44
45
  ----------
@@ -50,10 +51,11 @@ def _feature_importances_to_text(ebm: ExplainableBoostingModel) -> str:
50
51
  str: Textual representation of the feature importances.
51
52
 
52
53
  """
54
+ # the importances are kept by term, and term i is not always feature i
53
55
  importances = ebm.term_importances()
54
56
  return "\n".join(
55
- f"{feature_name}: {importances[feature_idx]:.2f}"
56
- for feature_idx, feature_name in enumerate(ebm.feature_names_in_)
57
+ f"{ebm.feature_names_in_[feature_idx]}: {importances[main_term(ebm, feature_idx)]:.2f}"
58
+ for feature_idx in main_effect_features(ebm)
57
59
  )
58
60
 
59
61
 
@@ -374,6 +376,7 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
374
376
  Each feature graph is described like in ``describe_graph`` (concurrently, at most ``max_concurrency`` at a time,
375
377
  each retried with a simplified graph if the reply is cut off by ``max_tokens``), and then the LLM summarizes the
376
378
  descriptions. The descriptions skip the interaction terms, and an ``interactions_skipped`` warning names them.
379
+ They also skip a feature that ``exclude`` or ``remove_terms`` left out, because it has no graph.
377
380
  The logged usage leaves out the cut-off attempts, because the provider error carries no token count. It is a lower
378
381
  bound, and the ``usage`` log event has the number of those attempts in ``truncated_attempts``.
379
382
 
@@ -401,10 +404,12 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
401
404
  """
402
405
  # Convert all objects to text and check the model before prompting the LLM the first time, so that errors in
403
406
  # processing one of the graphs or in the model surface before any LLM call is paid for.
404
- feature_names = list(ebm.feature_names_in_)
405
- _warn_skipped_interactions(ebm, range(len(feature_names)))
407
+ # a feature that exclude or remove_terms left out has no graph to describe
408
+ features = main_effect_features(ebm)
409
+ feature_names = [ebm.feature_names_in_[feature_index] for feature_index in features]
410
+ _warn_skipped_interactions(ebm, features)
406
411
  feature_importances = _feature_importances_to_text(ebm)
407
- graph_texts = [_graph_text(ebm, feature_index, graph) for feature_index in range(len(feature_names))]
412
+ graph_texts = [_graph_text(ebm, feature_index, graph) for feature_index in features]
408
413
  model_spec = _model_spec(model)
409
414
  opts = _prompt_options(prompt)
410
415
 
@@ -419,7 +424,7 @@ def describe_ebm( # ruff: ignore[too-many-arguments] -- the model, two limits,
419
424
  opts=opts,
420
425
  model=model_spec,
421
426
  ),
422
- range(len(graph_texts)),
427
+ features,
423
428
  graph_texts,
424
429
  ),
425
430
  )
@@ -33,6 +33,7 @@ from ebaml.core.custom_types import ClassLabel, ExplainableBoostingModel, Featur
33
33
  from ebaml.core.exceptions import InvalidInstanceError, OptionRangeError, UnsupportedModelError
34
34
  from ebaml.graphs.ebm_graph import EBMGraph
35
35
  from ebaml.graphs.model_kinds import BinaryClassifier, model_kind
36
+ from ebaml.graphs.terms import main_effect_features, main_term
36
37
 
37
38
 
38
39
  @attrs.frozen
@@ -366,22 +367,27 @@ def _features(
366
367
  Raises
367
368
  ------
368
369
  UnsupportedModelError
369
- If the model has interactions.
370
+ If the model has interactions, or a feature has no main-effect term.
370
371
  InvalidInstanceError
371
372
  If the instance lacks a feature, a value is missing, or a category was not seen in training.
372
373
 
373
374
  """
374
- # one term of one feature per feature; comparing the lists also rejects a missing term and an interaction term
375
- if [len(term) for term in ebm.term_features_] != [1] * len(ebm.feature_names_in_):
375
+ if any(len(term) > 1 for term in ebm.term_features_):
376
376
  msg = "Local explanations need an EBM without interactions (fit with interactions=0)."
377
377
  raise UnsupportedModelError(msg)
378
+ # a feature that exclude or remove_terms left out has no score, so the prediction cannot be split by feature
379
+ with_term = main_effect_features(ebm)
380
+ if with_term != list(range(len(ebm.feature_names_in_))):
381
+ missing = [name for index, name in enumerate(ebm.feature_names_in_) if index not in with_term]
382
+ msg = f"Local explanations need a main-effect term for every feature. These features have none: {missing}."
383
+ raise UnsupportedModelError(msg)
378
384
  features = []
379
385
  for index, name in enumerate(ebm.feature_names_in_):
380
386
  if name not in instance:
381
387
  msg = f"The instance has no value for feature {name!r}."
382
388
  raise InvalidInstanceError(msg)
383
389
  graph = EBMGraph.from_ebm(ebm, index)
384
- weights = np.asarray(ebm.bin_weights_[index][1:-1], dtype=float)
390
+ weights = np.asarray(ebm.bin_weights_[main_term(ebm, index)][1:-1], dtype=float)
385
391
  bin_index = _bin_index(ebm, index, graph, instance[name])
386
392
  plausible = _plausible_bins(weights, continuous=graph.feature_type == "continuous", min_support=min_support)
387
393
  plausible[bin_index] = True
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes