kalibr 1.2.4__py3-none-any.whl → 1.2.5__py3-none-any.whl

{kalibr-1.2.4.dist-info → kalibr-1.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: kalibr
-Version: 1.2.4
+Version: 1.2.5
 Summary: Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry.
 Author-email: Kalibr Team <support@kalibr.systems>
 License: Apache-2.0
@@ -65,17 +65,18 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 Requires-Dist: black>=23.0.0; extra == "dev"
 Requires-Dist: ruff>=0.1.0; extra == "dev"
 
-# Kalibr SDK
+# Kalibr
 
-**Intelligent routing for AI agents.** Kalibr picks the best model for each request, learns from outcomes, and shifts traffic to what works.
+Adaptive routing for AI agents. Kalibr learns which models, tools, and configs work best for each task 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/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 
 ## Installation
 ```bash
 pip install kalibr
 ```
-```bash
-export KALIBR_API_KEY=kal_xxx  # Get from dashboard.kalibr.dev
-```
 
 ## Quick Start
 ```python
@@ -83,42 +84,28 @@ from kalibr import Router
 
 router = Router(
     goal="book_meeting",
-    paths=["gpt-4o", "claude-3-sonnet", "gpt-4o-mini"],
+    paths=["gpt-4o", "claude-sonnet-4-20250514", "gpt-4o-mini"],
     success_when=lambda output: "confirmed" in output.lower()
 )
 
 response = router.completion(
     messages=[{"role": "user", "content": "Book a meeting with John tomorrow"}]
 )
-
-print(response.choices[0].message.content)
 ```
 
-That's it. Kalibr handles:
-- ✅ Picking the best model (Thompson Sampling)
-- ✅ Making the API call
-- ✅ Checking success
-- ✅ Learning for next time
-- ✅ Tracing everything
-
-## How It Works
-
-1. **Define a goal** - What is your agent trying to do?
-2. **Register paths** - Which models/tools can achieve it?
-3. **Report outcomes** - Did it work?
-4. **Kalibr routes** - Traffic shifts to winners
+Kalibr picks the best model, makes the call, checks success, and learns for next time.
 
 ## Paths
 
 A path is a model + optional tools + optional params:
 ```python
-# Simple: just models
-paths = ["gpt-4o", "claude-3-sonnet"]
+# Just models
+paths = ["gpt-4o", "claude-sonnet-4-20250514"]
 
 # With tools
 paths = [
     {"model": "gpt-4o", "tools": ["web_search"]},
-    {"model": "claude-3-sonnet", "tools": ["web_search", "browser"]},
+    {"model": "claude-sonnet-4-20250514", "tools": ["web_search", "browser"]},
 ]
 
 # With params
@@ -128,106 +115,73 @@ paths = [
 ]
 ```
 
-## Success Criteria
-
-### Auto-detect from output
-```python
-router = Router(
-    goal="summarize",
-    paths=["gpt-4o", "claude-3-sonnet"],
-    success_when=lambda output: len(output) > 100
-)
-```
-
-### Manual reporting
+## Manual Outcome Reporting
 ```python
-router = Router(goal="book_meeting", paths=["gpt-4o", "claude-3-sonnet"])
-
+router = Router(goal="book_meeting", paths=["gpt-4o", "claude-sonnet-4-20250514"])
 response = router.completion(messages=[...])
 
-# Your verification logic
 meeting_created = check_calendar_api()
-
 router.report(success=meeting_created)
 ```
 
-## Framework Integration
-
-### LangChain
+## LangChain Integration
+```bash
+pip install kalibr[langchain]
+```
 ```python
 from kalibr import Router
 
-router = Router(goal="summarize", paths=["gpt-4o", "claude-3-sonnet"])
+router = Router(goal="summarize", paths=["gpt-4o", "claude-sonnet-4-20250514"])
 llm = router.as_langchain()
 
 chain = prompt | llm | parser
-result = chain.invoke({"text": "..."})
 ```
 
-### CrewAI
-```python
-from kalibr import Router
+## Auto-Instrumentation
 
-router = Router(goal="research", paths=["gpt-4o", "claude-3-sonnet"])
+Kalibr auto-instruments OpenAI, Anthropic, and Google SDKs when imported:
+```python
+import kalibr  # Must be first import
+from openai import OpenAI
 
-agent = Agent(
-    role="Researcher",
-    llm=router.as_langchain(),
-    ...
-)
+client = OpenAI()
+response = client.chat.completions.create(model="gpt-4o", messages=[...])
+# Traced automatically
 ```
 
-## Observability (Included)
+Disable with `KALIBR_AUTO_INSTRUMENT=false`.
 
-Every call is automatically traced:
+## Other Integrations
+```bash
+pip install kalibr[crewai]        # CrewAI
+pip install kalibr[openai-agents] # OpenAI Agents SDK
+```
 
-- Token counts and costs
-- Latency (p50, p95, p99)
-- Tool usage
-- Errors with stack traces
+## Configuration
 
-View in the [dashboard](https://dashboard.kalibr.dev) or use callback handlers directly:
-```python
-from kalibr_langchain import KalibrCallbackHandler
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KALIBR_API_KEY` | API key | Required |
+| `KALIBR_TENANT_ID` | Tenant ID | `default` |
+| `KALIBR_AUTO_INSTRUMENT` | Auto-instrument SDKs | `true` |
 
-handler = KalibrCallbackHandler()
-chain.invoke({"input": "..."}, config={"callbacks": [handler]})
+## Development
+```bash
+git clone https://github.com/kalibr-ai/kalibr-sdk-python.git
+cd kalibr-sdk-python
+pip install -e ".[dev]"
+pytest
 ```
 
-## Pricing
+## Contributing
 
-| Tier | Routing Decisions | Price |
-|------|-------------------|-------|
-| Free | 1,000/month | $0 |
-| Pro | 50,000/month | $49/month |
-| Enterprise | Unlimited | Custom |
+See [CONTRIBUTING.md](CONTRIBUTING.md).
 
-## API Reference
-
-### Router
-```python
-Router(
-    goal: str,                    # Required: name of the goal
-    paths: List[str | dict],      # Models/tools to route between
-    success_when: Callable,       # Optional: auto-evaluate success
-    exploration_rate: float,      # Optional: 0.0-1.0, default 0.1
-)
-```
+## License
 
-### Methods
-```python
-router.completion(messages, **kwargs)  # Make routed request
-router.report(success, reason=None)    # Report outcome manually
-router.add_path(model, tools=None)     # Add path dynamically
-router.as_langchain()                  # Get LangChain-compatible LLM
-```
+Apache-2.0
 
 ## Links
 
-- [Documentation](https://docs.kalibr.dev)
-- [Dashboard](https://dashboard.kalibr.dev)
-- [GitHub](https://github.com/kalibr-ai/kalibr-sdk-python)
-
-## License
-
-MIT
+- [Docs](https://kalibr.systems/docs)
+- [Dashboard](https://dashboard.kalibr.systems)

{kalibr-1.2.4.dist-info → kalibr-1.2.5.dist-info}/RECORD

@@ -43,9 +43,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.4.dist-info/LICENSE,sha256=5mwAnB38l3_PjmOQn6_L6cZnJvus143DUjMBPIH1yso,10768
-kalibr-1.2.4.dist-info/METADATA,sha256=aXtgLOmzI6z7R1Zb0pFYU2jy2V4PUcUJKVFm0nciSL8,7037
-kalibr-1.2.4.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
-kalibr-1.2.4.dist-info/entry_points.txt,sha256=Kojlc6WRX8V1qS9lOMdDPZpTUVHCtzGtHqXusErgmLY,47
-kalibr-1.2.4.dist-info/top_level.txt,sha256=dIfBOWUnnHGFDwgz5zfIx5_0bU3wOUgAbYr4JcFHZmo,59
-kalibr-1.2.4.dist-info/RECORD,,
+kalibr-1.2.5.dist-info/LICENSE,sha256=5mwAnB38l3_PjmOQn6_L6cZnJvus143DUjMBPIH1yso,10768
+kalibr-1.2.5.dist-info/METADATA,sha256=s8I7uKD4iE8n-JkMQ7kulsLv9uJ0ftWhKJnLJrf7dok,6113
+kalibr-1.2.5.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
+kalibr-1.2.5.dist-info/entry_points.txt,sha256=Kojlc6WRX8V1qS9lOMdDPZpTUVHCtzGtHqXusErgmLY,47
+kalibr-1.2.5.dist-info/top_level.txt,sha256=dIfBOWUnnHGFDwgz5zfIx5_0bU3wOUgAbYr4JcFHZmo,59
+kalibr-1.2.5.dist-info/RECORD,,