kalibr 1.2.6__py3-none-any.whl → 1.2.8__py3-none-any.whl

{kalibr-1.2.6.dist-info → kalibr-1.2.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: kalibr
-Version: 1.2.6
+Version: 1.2.8
 Summary: Adaptive routing for AI agents. Learns which models work best and routes automatically.
 Author-email: Kalibr Team <support@kalibr.systems>
 License: Apache-2.0
@@ -67,7 +67,7 @@ Requires-Dist: ruff>=0.1.0; extra == "dev"
 
 # Kalibr
 
-Adaptive routing for AI agents. Kalibr learns which models, tools, and configs work best for each task and routes automatically.
+Adaptive routing for AI agents. Kalibr learns which models work best for your tasks and routes automatically.
 
 [![PyPI](https://img.shields.io/pypi/v/kalibr)](https://pypi.org/project/kalibr/)
 [![Python](https://img.shields.io/pypi/pyversions/kalibr)](https://pypi.org/project/kalibr/)
@@ -83,24 +83,32 @@ pip install kalibr
 from kalibr import Router
 
 router = Router(
-    goal="book_meeting",
-    paths=["gpt-4o", "claude-sonnet-4-20250514", "gpt-4o-mini"],
-    success_when=lambda output: "confirmed" in output.lower()
+    goal="extract_company",
+    paths=["gpt-4o", "claude-sonnet-4-20250514"]
 )
 
 response = router.completion(
-    messages=[{"role": "user", "content": "Book a meeting with John tomorrow"}]
+    messages=[{"role": "user", "content": "Extract the company: Hi, I'm Sarah from Stripe."}]
 )
+
+router.report(success=True)
 ```
 
-Kalibr picks the best model, makes the call, checks success, and learns for next time.
+Kalibr picks the best model, makes the call, and learns from the outcome.
+
+## How It Works
+
+1. **You define paths** - models (and optionally tools/params) that can handle your task
+2. **Kalibr picks** - uses Thompson Sampling to balance exploration vs exploitation
+3. **You report outcomes** - tell Kalibr if it worked
+4. **Kalibr learns** - routes more traffic to what works
 
 ## Paths
 
 A path is a model + optional tools + optional params:
 ```python
 # Just models
-paths = ["gpt-4o", "claude-sonnet-4-20250514"]
+paths = ["gpt-4o", "claude-sonnet-4-20250514", "gpt-4o-mini"]
 
 # With tools
 paths = [
@@ -115,7 +123,78 @@ paths = [
 ]
 ```
 
-## Manual Outcome Reporting
+## Advanced Path Configuration
+
+### Routing Between Parameters
+
+Kalibr can route between different parameter configurations of the same model:
+```python
+from kalibr import Router
+
+router = Router(
+    goal="creative_writing",
+    paths=[
+        {"model": "gpt-4o", "params": {"temperature": 0.3}},
+        {"model": "gpt-4o", "params": {"temperature": 0.9}},
+        {"model": "claude-sonnet-4-20250514", "params": {"temperature": 0.7}}
+    ]
+)
+
+response = router.completion(messages=[...])
+router.report(success=True)
+```
+
+Each unique `(model, params)` combination is tracked separately. Kalibr learns which configuration works best for your specific goal.
+
+### Routing Between Tools
+```python
+router = Router(
+    goal="research_task",
+    paths=[
+        {"model": "gpt-4o", "tools": ["web_search"]},
+        {"model": "gpt-4o", "tools": ["code_interpreter"]},
+        {"model": "claude-sonnet-4-20250514"}
+    ]
+)
+```
+
+### When to Use get_policy() Instead of Router
+
+For most use cases, use `Router`. It handles provider dispatching and response conversion automatically.
+
+Use `get_policy()` for advanced scenarios:
+- Integrating with frameworks like LangChain that wrap LLM calls
+- Custom retry logic or provider-specific features
+- Building tools that need fine-grained control
+```python
+from kalibr import get_policy, report_outcome
+
+policy = get_policy(goal="summarize")
+model = policy["recommended_model"]
+
+# You call the provider yourself
+if model.startswith("gpt"):
+    client = OpenAI()
+    response = client.chat.completions.create(model=model, messages=[...])
+
+report_outcome(trace_id=trace_id, goal="summarize", success=True)
+```
+
+## Outcome Reporting
+
+### Automatic (with success_when)
+```python
+router = Router(
+    goal="summarize",
+    paths=["gpt-4o", "claude-sonnet-4-20250514"],
+    success_when=lambda output: len(output) > 100
+)
+
+response = router.completion(messages=[...])
+# Outcome reported automatically based on success_when
+```
+
+### Manual
 ```python
 router = Router(goal="book_meeting", paths=["gpt-4o", "claude-sonnet-4-20250514"])
 response = router.completion(messages=[...])
@@ -139,7 +218,7 @@ chain = prompt | llm | parser
 
 ## Auto-Instrumentation
 
-Kalibr auto-instruments OpenAI, Anthropic, and Google SDKs when imported:
+Kalibr auto-instruments OpenAI, Anthropic, and Google SDKs on import:
 ```python
 import kalibr  # Must be first import
 from openai import OpenAI
@@ -151,19 +230,39 @@ response = client.chat.completions.create(model="gpt-4o", messages=[...])
 
 Disable with `KALIBR_AUTO_INSTRUMENT=false`.
 
+## Low-Level API
+
+For advanced use cases, you can use the intelligence API directly:
+```python
+from kalibr import register_path, decide, report_outcome
+
+# Register paths
+register_path(goal="book_meeting", model_id="gpt-4o")
+register_path(goal="book_meeting", model_id="claude-sonnet-4-20250514")
+
+# Get routing decision
+decision = decide(goal="book_meeting")
+model = decision["model_id"]
+
+# Make your own LLM call, then report
+report_outcome(trace_id="...", goal="book_meeting", success=True)
+```
+
 ## Other Integrations
 ```bash
 pip install kalibr[crewai]        # CrewAI
 pip install kalibr[openai-agents] # OpenAI Agents SDK
+pip install kalibr[langchain-all] # LangChain with all providers
 ```
 
 ## Configuration
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `KALIBR_API_KEY` | API key | Required |
-| `KALIBR_TENANT_ID` | Tenant ID | `default` |
-| `KALIBR_AUTO_INSTRUMENT` | Auto-instrument SDKs | `true` |
+| `KALIBR_API_KEY` | API key from dashboard | Required |
+| `KALIBR_TENANT_ID` | Tenant ID from dashboard | Required |
+| `KALIBR_AUTO_INSTRUMENT` | Auto-instrument LLM SDKs | `true` |
+| `KALIBR_INTELLIGENCE_URL` | Intelligence service URL | `https://kalibr-intelligence.fly.dev` |
 
 ## Development
 ```bash
@@ -183,5 +282,6 @@ Apache-2.0
 
 ## Links
 
-- [Docs](https://kalibr.systems/docs)
+- [Docs](https://kalibr.dev/docs)
 - [Dashboard](https://dashboard.kalibr.systems)
+- [GitHub](https://github.com/kalibr-ai/kalibr-sdk-python)

{kalibr-1.2.6.dist-info → kalibr-1.2.8.dist-info}/RECORD

@@ -1,39 +1,40 @@
-kalibr/__init__.py,sha256=_Aq0ZfsOGbLC-GMB43br5CPprmjwLfmeBZuuVHUOQOY,5189
+kalibr/__init__.py,sha256=XyXmJHqHs3-bW8pbAMlJDrVjOD0X6-KvqcoI7YmGtPA,5189
 kalibr/__main__.py,sha256=jO96I4pqinwHg7ONRvNVKbySBh5pSIhOAiNrgSQrNlY,110
 kalibr/capsule_middleware.py,sha256=pXG_wORgCqo3wHjtkn_zY4doLyiDmTwJtB7XiZNnbPk,3163
-kalibr/client.py,sha256=6D1paakE6zgWJStaow3ak9t0R8afodQhSSpUO3WTs_8,9732
-kalibr/collector.py,sha256=rtTKQLe6NkDSblBIfFooQ-ESFcP0Q1HUp4Bcqqg8JFo,5818
+kalibr/client.py,sha256=oiGN4DrdLuNVLFC_KEUjEYACcLAlcErAcB9dSyx2wYA,9736
+kalibr/collector.py,sha256=2iQ_NQgO-rZHirwlWbfDWf_4koGSRoa_56ngattWvaU,12817
 kalibr/context.py,sha256=FgN9-WyMQMDgg2Vqwje4r2_jKRvnMeI8t4fIE1VRn_8,4777
-kalibr/cost_adapter.py,sha256=NerJ7ywaJjBn97gVFr7qKX7318e3Kmy2qqeNlGl9nPE,6439
+kalibr/cost_adapter.py,sha256=uHcJpndNx895EcY68YFSZisRnO8j4i13L3iskg4bIco,4484
 kalibr/decorators.py,sha256=m-XBXxWMDVrzaNsljACiGmeGhgiHj_MqSfj6OGK3L5I,4380
-kalibr/intelligence.py,sha256=JOckaykWrMloZV_MH1e9kvVxPRQKavIgLSdgqiJjxC4,22158
+kalibr/intelligence.py,sha256=Pky43AMB2VW4FogRvTtc2JXjvD2Ov9_TazHHb2byVXE,22865
 kalibr/kalibr.py,sha256=cNXC3W_TX5SvGsy1lRopkwFqsHOpyd1kkVjEMOz1Yr4,6084
 kalibr/kalibr_app.py,sha256=ItZwEh0FZPx9_BE-zPQajC2yxI2y9IHYwJD0k9tbHvY,2773
 kalibr/models.py,sha256=HwD_-iysZMSnCzMQYO1Qcf0aeXySupY7yJeBwl_dLS0,1024
+kalibr/pricing.py,sha256=wY0GzcrZdXuHlZoq2e74RkX0scd6somk_KYbr-RSHdE,8844
 kalibr/redaction.py,sha256=XibxX4Lv1Ci0opE6Tb5ZI2GLbO0a8E9U66MAg60llnc,1139
-kalibr/router.py,sha256=Z_LYvRxfLK5bQD-VUc1arqfAoC_CqOwJR8yoz_sGmvY,13234
+kalibr/router.py,sha256=ari4XOogl3tzvcVlGc1Qg3hOnYI2hGaCweLXx07f_fU,17820
 kalibr/schemas.py,sha256=XLZNLkXca6jbj9AF6gDIyGVnIcr1SVOsNYaKvW-wbgE,3669
-kalibr/simple_tracer.py,sha256=VAhqxGhCMBz9rVFXfpJtRmt6SrM_cpUBKE5ygP9PC9Y,9779
+kalibr/simple_tracer.py,sha256=oiwXtiYaIqZxqCNV-b79_dsiJT0D3XvKhNT_LF6bRD4,9736
 kalibr/tokens.py,sha256=istjgaxi9S4dMddjuGtoQaTnZYcWLCqdnxRjV86yNXA,1297
-kalibr/trace_capsule.py,sha256=CPMUz5D-fVfao-MozNtSDbgOQKdDAJxTN5KQL6w2Xp8,10154
+kalibr/trace_capsule.py,sha256=SEfTE-GXvM9kcGCOZ5uEQSD8AnbmRRA0UUu0X8c8isw,10492
 kalibr/trace_models.py,sha256=9o7VJQk3gCrvdfXPrNh3Ptkq5sRgA9_qrLLE3jNkSBg,7304
 kalibr/tracer.py,sha256=jwWBpZbGXn6fEv4pw25BLFCH-22QUbyzofPWp1Iwdkk,11911
 kalibr/types.py,sha256=cna4-akpdwfHXfOJCtVIq5lO_jaoG2Am3BRrXi0Vo34,895
-kalibr/utils.py,sha256=DJ9Mp6IPzyQTKboVV0utnfFBMT7LbJ9vAs0gOOPCpvw,5052
+kalibr/utils.py,sha256=NQbC9ygJJWZUNfkUW7FheftraBs8QT6sDzwuNeQklxM,5060
 kalibr/cli/__init__.py,sha256=FmRGaDMhM9DhrKg1ONkF0emIrJcjFWjlFBl_oenvpsk,77
-kalibr/cli/capsule_cmd.py,sha256=fHhC7-VpPskVxJiIbpSe7eVPNq0xIWeXCBVUOWGcqrw,6097
+kalibr/cli/capsule_cmd.py,sha256=I3vm5-V0T36ykiKunIxhbCdmxG4xMwFrFFC2pBfKD_0,6109
 kalibr/cli/deploy_cmd.py,sha256=kV4uqCN2IdQev1vPBY5qqIHsEhjGBZ7y_rLx8RGAL_4,5178
 kalibr/cli/main.py,sha256=FrOSIACNARkrvq-J2SZhyPNWNCdNEMZlD69PEV3uCMA,1924
-kalibr/cli/run.py,sha256=bkdyNGrzUdcHg8XVvvWD7w8zV8Q4eQwUSFR-Bd_Asd0,6433
+kalibr/cli/run.py,sha256=ZbfJB2TtsLi-T2noKkAaRJMm6xfO6ytwTGAWEolqKE8,6441
 kalibr/cli/serve.py,sha256=71Xha35qrBNkcQxuUkwC-ixbOriHGUIEgxl7C_qERQo,2085
 kalibr/instrumentation/__init__.py,sha256=YnUJ4gUH8WNxdVv5t1amn0l2WUULJG2MuQIL2ZZhn04,354
-kalibr/instrumentation/anthropic_instr.py,sha256=ozXHr8BPMafIbvgaxunskQi9YX5_Gpoiekye77oRc2E,10058
-kalibr/instrumentation/base.py,sha256=eMFBTIQXtG2bZD5st6vzN72ooeHCANZ3SapYzrdijgk,3109
-kalibr/instrumentation/google_instr.py,sha256=f2um7MB2QCT2u9CFV4-vKke-8M0dSXSpZHTcbdxMZyI,10476
-kalibr/instrumentation/openai_instr.py,sha256=UU0Pi1Gq1FqgetYWDacQhNFdjemuPrc0hRTKd-LIDHI,9250
-kalibr/instrumentation/registry.py,sha256=sfQnXhbPOI5LVon2kFhe8KcXQwWmuKW1XUe50B2AaBc,4749
+kalibr/instrumentation/anthropic_instr.py,sha256=ChH4-0PSALwXl_UJnXzf1KsuyjpKjmxDepmP60AfAVs,9601
+kalibr/instrumentation/base.py,sha256=EW3kRJo11HzuiOwgvJESSzk_Roo1r2oKz51c-PZH3KM,3666
+kalibr/instrumentation/google_instr.py,sha256=hfczy4ofNtdqPujD7yUCWf-T3TztaNnK-vUajIVBxZo,10073
+kalibr/instrumentation/openai_instr.py,sha256=qIXNzCZtco7kfWTL1u6fMojtLerZ0K_ilr8noj-wDkQ,9287
+kalibr/instrumentation/registry.py,sha256=uOlbEDHmrlItFYV69ANSRzD_722Ym5cZ57dyejuDY1E,5645
 kalibr/middleware/__init__.py,sha256=qyDUn_irAX67MS-IkuDVxg4RmFnJHDf_BfIT3qfGoBI,115
-kalibr/middleware/auto_tracer.py,sha256=ZBSBM0O3a6rwVzfik1n5NUmQDah8_iaf86rU64aPYT4,13037
+kalibr/middleware/auto_tracer.py,sha256=pFwGiwDhaEQ6x35TpMX8Y0DD2tjajO2JZADvkzlMVR0,13041
 kalibr_crewai/__init__.py,sha256=b0HFTiE80eArtSMBOIEKu1JM6KU0tCjEylKCVVVF29Q,1796
 kalibr_crewai/callbacks.py,sha256=_d1M4J-6XfKqrVIxnOgOQu57jpFKVv-VIsmPV0HNgZ4,20419
 kalibr_crewai/instrumentor.py,sha256=-G_-xaqE3Op70MSEIaZjPYioGDxKRagwLbZmcmmvzFg,26793
@@ -43,9 +44,9 @@ kalibr_langchain/callback.py,sha256=SNM1aHOXdG55grHmGyTwbXOeM6hjZTub2REiZD2H-d8,
 kalibr_langchain/chat_model.py,sha256=Y4xsZGx9gZpDUF8NP-edJuYam4k0NBySdA6B5484MKk,3190
 kalibr_openai_agents/__init__.py,sha256=wL59LzGstptKigfQDrKKt_7hcMO1JGVQtVAsE0lz-Zw,1367
 kalibr_openai_agents/processor.py,sha256=F550sdRf3rpguP1yOlgAUQWDLPBy4hSACV3-zOyCpOU,18257
-kalibr-1.2.6.dist-info/LICENSE,sha256=5mwAnB38l3_PjmOQn6_L6cZnJvus143DUjMBPIH1yso,10768
-kalibr-1.2.6.dist-info/METADATA,sha256=PCOvSw7-xPDTz4tRIGjbs4-5WG60Mnw-cVfUl-JY_q4,6074
-kalibr-1.2.6.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
-kalibr-1.2.6.dist-info/entry_points.txt,sha256=Kojlc6WRX8V1qS9lOMdDPZpTUVHCtzGtHqXusErgmLY,47
-kalibr-1.2.6.dist-info/top_level.txt,sha256=dIfBOWUnnHGFDwgz5zfIx5_0bU3wOUgAbYr4JcFHZmo,59
-kalibr-1.2.6.dist-info/RECORD,,
+kalibr-1.2.8.dist-info/LICENSE,sha256=5mwAnB38l3_PjmOQn6_L6cZnJvus143DUjMBPIH1yso,10768
+kalibr-1.2.8.dist-info/METADATA,sha256=DR_yUR8AmRmGL3Wgp9EhMaIkGIvzh9es5S_1v7b8vEM,9014
+kalibr-1.2.8.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
+kalibr-1.2.8.dist-info/entry_points.txt,sha256=Kojlc6WRX8V1qS9lOMdDPZpTUVHCtzGtHqXusErgmLY,47
+kalibr-1.2.8.dist-info/top_level.txt,sha256=dIfBOWUnnHGFDwgz5zfIx5_0bU3wOUgAbYr4JcFHZmo,59
+kalibr-1.2.8.dist-info/RECORD,,