kalibr 1.2.4__tar.gz → 1.2.6__tar.gz

{kalibr-1.2.4 → kalibr-1.2.6}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.2
 Name: kalibr
-Version: 1.2.4
-Summary: Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry.
+Version: 1.2.6
+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
 Project-URL: Homepage, https://github.com/kalibr-ai/kalibr-sdk-python
@@ -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.6/README.md

@@ -0,0 +1,120 @@
+# Kalibr
+
+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
+```
+
+## Quick Start
+```python
+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()
+)
+
+response = router.completion(
+    messages=[{"role": "user", "content": "Book a meeting with John tomorrow"}]
+)
+```
+
+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
+# Just models
+paths = ["gpt-4o", "claude-sonnet-4-20250514"]
+
+# With tools
+paths = [
+    {"model": "gpt-4o", "tools": ["web_search"]},
+    {"model": "claude-sonnet-4-20250514", "tools": ["web_search", "browser"]},
+]
+
+# With params
+paths = [
+    {"model": "gpt-4o", "params": {"temperature": 0.7}},
+    {"model": "gpt-4o", "params": {"temperature": 0.2}},
+]
+```
+
+## Manual Outcome Reporting
+```python
+router = Router(goal="book_meeting", paths=["gpt-4o", "claude-sonnet-4-20250514"])
+response = router.completion(messages=[...])
+
+meeting_created = check_calendar_api()
+router.report(success=meeting_created)
+```
+
+## LangChain Integration
+```bash
+pip install kalibr[langchain]
+```
+```python
+from kalibr import Router
+
+router = Router(goal="summarize", paths=["gpt-4o", "claude-sonnet-4-20250514"])
+llm = router.as_langchain()
+
+chain = prompt | llm | parser
+```
+
+## Auto-Instrumentation
+
+Kalibr auto-instruments OpenAI, Anthropic, and Google SDKs when imported:
+```python
+import kalibr  # Must be first import
+from openai import OpenAI
+
+client = OpenAI()
+response = client.chat.completions.create(model="gpt-4o", messages=[...])
+# Traced automatically
+```
+
+Disable with `KALIBR_AUTO_INSTRUMENT=false`.
+
+## Other Integrations
+```bash
+pip install kalibr[crewai]        # CrewAI
+pip install kalibr[openai-agents] # OpenAI Agents SDK
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KALIBR_API_KEY` | API key | Required |
+| `KALIBR_TENANT_ID` | Tenant ID | `default` |
+| `KALIBR_AUTO_INSTRUMENT` | Auto-instrument SDKs | `true` |
+
+## Development
+```bash
+git clone https://github.com/kalibr-ai/kalibr-sdk-python.git
+cd kalibr-sdk-python
+pip install -e ".[dev]"
+pytest
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+Apache-2.0
+
+## Links
+
+- [Docs](https://kalibr.systems/docs)
+- [Dashboard](https://dashboard.kalibr.systems)

{kalibr-1.2.4 → kalibr-1.2.6}/kalibr.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.2
 Name: kalibr
-Version: 1.2.4
-Summary: Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry.
+Version: 1.2.6
+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
 Project-URL: Homepage, https://github.com/kalibr-ai/kalibr-sdk-python
@@ -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 → kalibr-1.2.6}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kalibr"
-version = "1.2.4"
-description = "Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry."
+version = "1.2.6"
+description = "Adaptive routing for AI agents. Learns which models work best and routes automatically."
 authors = [{name = "Kalibr Team", email = "support@kalibr.systems"}]
 readme = "README.md"
 requires-python = ">=3.9"

kalibr-1.2.4/README.md

@@ -1,166 +0,0 @@
-# Kalibr SDK
-
-**Intelligent routing for AI agents.** Kalibr picks the best model for each request, learns from outcomes, and shifts traffic to what works.
-
-## Installation
-```bash
-pip install kalibr
-```
-```bash
-export KALIBR_API_KEY=kal_xxx  # Get from dashboard.kalibr.dev
-```
-
-## Quick Start
-```python
-from kalibr import Router
-
-router = Router(
-    goal="book_meeting",
-    paths=["gpt-4o", "claude-3-sonnet", "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
-
-## Paths
-
-A path is a model + optional tools + optional params:
-```python
-# Simple: just models
-paths = ["gpt-4o", "claude-3-sonnet"]
-
-# With tools
-paths = [
-    {"model": "gpt-4o", "tools": ["web_search"]},
-    {"model": "claude-3-sonnet", "tools": ["web_search", "browser"]},
-]
-
-# With params
-paths = [
-    {"model": "gpt-4o", "params": {"temperature": 0.7}},
-    {"model": "gpt-4o", "params": {"temperature": 0.2}},
-]
-```
-
-## 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
-```python
-router = Router(goal="book_meeting", paths=["gpt-4o", "claude-3-sonnet"])
-
-response = router.completion(messages=[...])
-
-# Your verification logic
-meeting_created = check_calendar_api()
-
-router.report(success=meeting_created)
-```
-
-## Framework Integration
-
-### LangChain
-```python
-from kalibr import Router
-
-router = Router(goal="summarize", paths=["gpt-4o", "claude-3-sonnet"])
-llm = router.as_langchain()
-
-chain = prompt | llm | parser
-result = chain.invoke({"text": "..."})
-```
-
-### CrewAI
-```python
-from kalibr import Router
-
-router = Router(goal="research", paths=["gpt-4o", "claude-3-sonnet"])
-
-agent = Agent(
-    role="Researcher",
-    llm=router.as_langchain(),
-    ...
-)
-```
-
-## Observability (Included)
-
-Every call is automatically traced:
-
-- Token counts and costs
-- Latency (p50, p95, p99)
-- Tool usage
-- Errors with stack traces
-
-View in the [dashboard](https://dashboard.kalibr.dev) or use callback handlers directly:
-```python
-from kalibr_langchain import KalibrCallbackHandler
-
-handler = KalibrCallbackHandler()
-chain.invoke({"input": "..."}, config={"callbacks": [handler]})
-```
-
-## Pricing
-
-| Tier | Routing Decisions | Price |
-|------|-------------------|-------|
-| Free | 1,000/month | $0 |
-| Pro | 50,000/month | $49/month |
-| Enterprise | Unlimited | Custom |
-
-## 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
-)
-```
-
-### 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
-```
-
-## Links
-
-- [Documentation](https://docs.kalibr.dev)
-- [Dashboard](https://dashboard.kalibr.dev)
-- [GitHub](https://github.com/kalibr-ai/kalibr-sdk-python)
-
-## License
-
-MIT