kalibr 1.1.1a0__tar.gz → 1.1.3a0__tar.gz

kalibr-1.1.3a0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: kalibr
+Version: 1.1.3a0
+Summary: Unified LLM Observability & Multi-Model AI Integration Framework - Deploy to GPT, Claude, Gemini, Copilot with full telemetry.
+Author-email: Kalibr Team <team@kalibr.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/kalibr-ai/kalibr-sdk-python
+Project-URL: Documentation, https://docs.kalibr.systems
+Project-URL: Repository, https://github.com/kalibr-ai/kalibr-sdk-python
+Project-URL: Issues, https://github.com/kalibr-ai/kalibr-sdk-python/issues
+Keywords: ai,mcp,gpt,claude,gemini,copilot,openai,anthropic,google,microsoft,observability,telemetry,tracing,llm,schema-generation,api,multi-model,langchain,crewai
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: tiktoken>=0.8.0
+Requires-Dist: fastapi>=0.110.1
+Requires-Dist: uvicorn>=0.25.0
+Requires-Dist: pydantic>=2.6.4
+Requires-Dist: typer>=0.9.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: rich>=10.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain"
+Provides-Extra: langchain-openai
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain-openai"
+Requires-Dist: langchain-openai>=0.1.0; extra == "langchain-openai"
+Provides-Extra: langchain-anthropic
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain-anthropic"
+Requires-Dist: langchain-anthropic>=0.1.0; extra == "langchain-anthropic"
+Provides-Extra: langchain-google
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain-google"
+Requires-Dist: langchain-google-genai>=0.0.10; extra == "langchain-google"
+Provides-Extra: langchain-all
+Requires-Dist: langchain-core>=0.1.0; extra == "langchain-all"
+Requires-Dist: langchain-openai>=0.1.0; extra == "langchain-all"
+Requires-Dist: langchain-anthropic>=0.1.0; extra == "langchain-all"
+Requires-Dist: langchain-google-genai>=0.0.10; extra == "langchain-all"
+Provides-Extra: crewai
+Requires-Dist: crewai>=0.28.0; extra == "crewai"
+Provides-Extra: openai-agents
+Requires-Dist: openai-agents>=0.0.3; extra == "openai-agents"
+Provides-Extra: integrations
+Requires-Dist: langchain-core>=0.1.0; extra == "integrations"
+Requires-Dist: crewai>=0.28.0; extra == "integrations"
+Requires-Dist: openai-agents>=0.0.3; extra == "integrations"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+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"
+Dynamic: license-file
+
+# Kalibr Python SDK
+
+Production-grade observability for LLM applications. Automatically instrument OpenAI, Anthropic, and Google AI SDKs with zero code changes.
+
+## Features
+
+- **Zero-code instrumentation** - Automatic tracing for OpenAI, Anthropic, and Google AI
+- **Cost tracking** - Real-time cost calculation for all LLM calls
+- **Token monitoring** - Track input/output tokens across providers
+- **Parent-child traces** - Automatic trace relationship management
+- **Multi-provider support** - Works with GPT-4, Claude, Gemini, and more
+
+## Installation
+
+```bash
+pip install kalibr
+```
+
+## Quick Start
+
+### Auto-instrumentation (Recommended)
+
+Simply import `kalibr` at the start of your application - all LLM calls are automatically traced:
+
+```python
+import kalibr  # Enable auto-instrumentation
+import openai
+
+# Set your Kalibr API key
+import os
+os.environ["KALIBR_API_KEY"] = "your-kalibr-api-key"
+
+# All OpenAI calls are now automatically traced
+client = openai.OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Manual Tracing with Decorator
+
+For more control, use the `@trace` decorator:
+
+```python
+from kalibr import trace
+import openai
+
+@trace(operation="summarize", provider="openai", model="gpt-4o")
+def summarize_text(text: str) -> str:
+    client = openai.OpenAI()
+    response = client.chat.completions.create(
+        model="gpt-4o",
+        messages=[
+            {"role": "system", "content": "Summarize the following text."},
+            {"role": "user", "content": text}
+        ]
+    )
+    return response.choices[0].message.content
+
+result = summarize_text("Your long text here...")
+```
+
+### Multi-Provider Example
+
+```python
+import kalibr
+import openai
+import anthropic
+
+# OpenAI call - automatically traced
+openai_client = openai.OpenAI()
+gpt_response = openai_client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Explain quantum computing"}]
+)
+
+# Anthropic call - automatically traced
+anthropic_client = anthropic.Anthropic()
+claude_response = anthropic_client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "Explain machine learning"}]
+)
+```
+
+## Configuration
+
+Configure the SDK using environment variables:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KALIBR_API_KEY` | API key for authentication | *Required* |
+| `KALIBR_COLLECTOR_URL` | Collector endpoint URL | `http://localhost:8001/api/ingest` |
+| `KALIBR_TENANT_ID` | Tenant identifier for multi-tenant setups | `default` |
+| `KALIBR_WORKFLOW_ID` | Workflow identifier for grouping traces | `default` |
+| `KALIBR_SERVICE_NAME` | Service name for OpenTelemetry spans | `kalibr-app` |
+| `KALIBR_ENVIRONMENT` | Environment (prod, staging, dev) | `prod` |
+| `KALIBR_AUTO_INSTRUMENT` | Enable/disable auto-instrumentation | `true` |
+| `KALIBR_CONSOLE_EXPORT` | Enable console span export for debugging | `false` |
+
+## CLI Tools
+
+The SDK includes command-line tools for running and deploying applications:
+
+```bash
+# Run your app locally with tracing
+kalibr serve myapp.py
+
+# Run with managed runtime lifecycle
+kalibr run myapp.py --port 8000
+
+# Deploy to cloud platforms
+kalibr deploy myapp.py --runtime fly.io
+
+# Fetch trace data by ID
+kalibr capsule <trace-id>
+```
+
+## Supported Providers
+
+| Provider | Models | Auto-Instrumentation |
+|----------|--------|---------------------|
+| OpenAI | GPT-4, GPT-4o, GPT-3.5 | Yes |
+| Anthropic | Claude 3 Opus, Sonnet, Haiku | Yes |
+| Google | Gemini Pro, Gemini Flash | Yes |
+
+## Examples
+
+See the [`examples/`](./examples) directory for complete examples:
+
+- `basic_example.py` - Simple tracing example
+- `basic_agent.py` - Agent with auto-instrumentation
+- `advanced_example.py` - Advanced tracing patterns
+- `cross_vendor.py` - Multi-provider workflows
+- `test_mas.py` - Multi-agent system demonstration
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/kalibr-ai/kalibr-sdk-python.git
+cd kalibr-sdk-python
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black kalibr/
+ruff check kalibr/
+```
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+## Links
+
+- [Documentation](https://docs.kalibr.systems)
+- [GitHub Issues](https://github.com/kalibr-ai/kalibr-sdk-python/issues)
+- [PyPI Package](https://pypi.org/project/kalibr/)

kalibr-1.1.3a0/README.md

@@ -0,0 +1,168 @@
+# Kalibr Python SDK
+
+Production-grade observability for LLM applications. Automatically instrument OpenAI, Anthropic, and Google AI SDKs with zero code changes.
+
+## Features
+
+- **Zero-code instrumentation** - Automatic tracing for OpenAI, Anthropic, and Google AI
+- **Cost tracking** - Real-time cost calculation for all LLM calls
+- **Token monitoring** - Track input/output tokens across providers
+- **Parent-child traces** - Automatic trace relationship management
+- **Multi-provider support** - Works with GPT-4, Claude, Gemini, and more
+
+## Installation
+
+```bash
+pip install kalibr
+```
+
+## Quick Start
+
+### Auto-instrumentation (Recommended)
+
+Simply import `kalibr` at the start of your application - all LLM calls are automatically traced:
+
+```python
+import kalibr  # Enable auto-instrumentation
+import openai
+
+# Set your Kalibr API key
+import os
+os.environ["KALIBR_API_KEY"] = "your-kalibr-api-key"
+
+# All OpenAI calls are now automatically traced
+client = openai.OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Manual Tracing with Decorator
+
+For more control, use the `@trace` decorator:
+
+```python
+from kalibr import trace
+import openai
+
+@trace(operation="summarize", provider="openai", model="gpt-4o")
+def summarize_text(text: str) -> str:
+    client = openai.OpenAI()
+    response = client.chat.completions.create(
+        model="gpt-4o",
+        messages=[
+            {"role": "system", "content": "Summarize the following text."},
+            {"role": "user", "content": text}
+        ]
+    )
+    return response.choices[0].message.content
+
+result = summarize_text("Your long text here...")
+```
+
+### Multi-Provider Example
+
+```python
+import kalibr
+import openai
+import anthropic
+
+# OpenAI call - automatically traced
+openai_client = openai.OpenAI()
+gpt_response = openai_client.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Explain quantum computing"}]
+)
+
+# Anthropic call - automatically traced
+anthropic_client = anthropic.Anthropic()
+claude_response = anthropic_client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=1024,
+    messages=[{"role": "user", "content": "Explain machine learning"}]
+)
+```
+
+## Configuration
+
+Configure the SDK using environment variables:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `KALIBR_API_KEY` | API key for authentication | *Required* |
+| `KALIBR_COLLECTOR_URL` | Collector endpoint URL | `http://localhost:8001/api/ingest` |
+| `KALIBR_TENANT_ID` | Tenant identifier for multi-tenant setups | `default` |
+| `KALIBR_WORKFLOW_ID` | Workflow identifier for grouping traces | `default` |
+| `KALIBR_SERVICE_NAME` | Service name for OpenTelemetry spans | `kalibr-app` |
+| `KALIBR_ENVIRONMENT` | Environment (prod, staging, dev) | `prod` |
+| `KALIBR_AUTO_INSTRUMENT` | Enable/disable auto-instrumentation | `true` |
+| `KALIBR_CONSOLE_EXPORT` | Enable console span export for debugging | `false` |
+
+## CLI Tools
+
+The SDK includes command-line tools for running and deploying applications:
+
+```bash
+# Run your app locally with tracing
+kalibr serve myapp.py
+
+# Run with managed runtime lifecycle
+kalibr run myapp.py --port 8000
+
+# Deploy to cloud platforms
+kalibr deploy myapp.py --runtime fly.io
+
+# Fetch trace data by ID
+kalibr capsule <trace-id>
+```
+
+## Supported Providers
+
+| Provider | Models | Auto-Instrumentation |
+|----------|--------|---------------------|
+| OpenAI | GPT-4, GPT-4o, GPT-3.5 | Yes |
+| Anthropic | Claude 3 Opus, Sonnet, Haiku | Yes |
+| Google | Gemini Pro, Gemini Flash | Yes |
+
+## Examples
+
+See the [`examples/`](./examples) directory for complete examples:
+
+- `basic_example.py` - Simple tracing example
+- `basic_agent.py` - Agent with auto-instrumentation
+- `advanced_example.py` - Advanced tracing patterns
+- `cross_vendor.py` - Multi-provider workflows
+- `test_mas.py` - Multi-agent system demonstration
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/kalibr-ai/kalibr-sdk-python.git
+cd kalibr-sdk-python
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black kalibr/
+ruff check kalibr/
+```
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+## Links
+
+- [Documentation](https://docs.kalibr.systems)
+- [GitHub Issues](https://github.com/kalibr-ai/kalibr-sdk-python/issues)
+- [PyPI Package](https://pypi.org/project/kalibr/)

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/__init__.py

@@ -1,36 +1,24 @@
-"""Kalibr SDK v1.1.0 - Unified LLM Observability & Multi-Model AI Integration Framework
-
-This SDK combines:
-1. Full LLM Observability with tracing, cost tracking, and analytics
-2. Multi-Model AI Integration (GPT, Claude, Gemini, Copilot)
-3. One-line deployment with Docker and runtime router
-4. Schema generation for all major AI platforms
-5. **NEW in 1.1.0**: Auto-instrumentation of LLM SDKs (OpenAI, Anthropic, Google)
+"""Kalibr SDK v1.1.0 - LLM Observability & Tracing Framework
 
 Features:
 - **Auto-Instrumentation**: Zero-config tracing of OpenAI, Anthropic, Google SDK calls
 - **OpenTelemetry**: OTel-compatible spans with OTLP export
 - **Tracing**: Complete telemetry with @trace decorator
 - **Cost Tracking**: Multi-vendor cost calculation (OpenAI, Anthropic, etc.)
-- **Deployment**: One-command deployment to Fly.io, Render, or local
-- **Schema Generation**: Auto-generate schemas for GPT Actions, Claude MCP, Gemini, Copilot
 - **Error Handling**: Automatic error capture with stack traces
 - **Analytics**: ClickHouse-backed analytics and alerting
 
-Usage - Auto-Instrumentation (NEW):
-    from kalibr import Kalibr
+Usage - Auto-Instrumentation:
+    from kalibr import auto_instrument
     import openai  # Automatically instrumented!
 
-    app = Kalibr(title="My API")
+    auto_instrument(["openai", "anthropic", "google"])
 
-    @app.action("chat", "Chat with GPT")
-    def chat(message: str):
-        # This OpenAI call is automatically traced!
-        response = openai.chat.completions.create(
-            model="gpt-4",
-            messages=[{"role": "user", "content": message}]
-        )
-        return response.choices[0].message.content
+    # All LLM calls are now traced automatically
+    response = openai.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": "Hello!"}]
+    )
 
 Usage - Manual Tracing:
     from kalibr import trace
@@ -44,8 +32,6 @@ Usage - Manual Tracing:
         return response
 
 CLI Usage:
-    kalibr serve my_app.py              # Run locally
-    kalibr deploy my_app.py --runtime fly  # Deploy to Fly.io
     kalibr run my_app.py                # Run with auto-tracing
     kalibr version                       # Show version
 """
@@ -79,23 +65,10 @@ from .cost_adapter import (
 )
 from .instrumentation import auto_instrument, get_instrumented_providers
 
-# ============================================================================
-# SDK & DEPLOYMENT (from 1.0.30)
-# ============================================================================
-from .kalibr import Kalibr
-from .kalibr_app import KalibrApp
 from .models import EventData, TraceConfig
-from .schemas import (
-    generate_copilot_schema,
-    generate_gemini_schema,
-    generate_mcp_schema,
-    get_base_url,
-    get_supported_models,
-)
 from .simple_tracer import trace
 from .trace_capsule import TraceCapsule, get_or_create_capsule
 from .tracer import SpanContext, Tracer
-from .types import FileUpload, Session
 from .utils import load_config_from_env
 
 if os.getenv("KALIBR_AUTO_INSTRUMENT", "true").lower() == "true":
@@ -145,21 +118,6 @@ __all__ = [
     # Utils
     "load_config_from_env",
     # ========================================================================
-    # SDK & DEPLOYMENT
-    # ========================================================================
-    # SDK Classes
-    "Kalibr",
-    "KalibrApp",
-    # Types
-    "FileUpload",
-    "Session",
-    # Schema Generation
-    "get_base_url",
-    "generate_mcp_schema",
-    "generate_gemini_schema",
-    "generate_copilot_schema",
-    "get_supported_models",
-    # ========================================================================
     # PHASE 1: SDK INSTRUMENTATION & OPENTELEMETRY (v1.1.0)
     # ========================================================================
     # Auto-instrumentation

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/cli/capsule_cmd.py

@@ -23,7 +23,7 @@ def capsule(
         None,
         "--api-url",
         "-u",
-        help="Kalibr API base URL (default: from env KALIBR_API_URL or http://localhost:8001)",
+        help="Kalibr API base URL (default: from env KALIBR_API_URL or https://api.kalibr.systems)",
         envvar="KALIBR_API_URL",
     ),
     output: Optional[Path] = typer.Option(
@@ -66,7 +66,7 @@ def capsule(
         kalibr capsule abc-123-def -u https://api.kalibr.io
     """
     # Determine API base URL
-    base_url = api_url or "http://localhost:8001"
+    base_url = api_url or "https://api.kalibr.systems"
     base_url = base_url.rstrip("/")
 
     # Build endpoint URL

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/cli/run.py

@@ -56,8 +56,11 @@ def run(
         raise typer.Exit(1)
 
     # Configure backend
-    backend = backend_url or os.getenv("KALIBR_BACKEND_URL", "http://localhost:8001")
-    api_key = os.getenv("KALIBR_API_KEY", "test_key_12345")
+    backend = backend_url or os.getenv("KALIBR_BACKEND_URL", "https://api.kalibr.systems")
+    api_key = os.getenv("KALIBR_API_KEY")
+    if not api_key:
+        console.print("[yellow]⚠️  KALIBR_API_KEY not set. Set it for trace authentication.[/yellow]")
+        api_key = ""
 
     # Generate runtime metadata
     runtime_id = str(uuid.uuid4())

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/client.py

@@ -70,7 +70,7 @@ class KalibrClient:
 
         self.api_key = api_key or env_config.get("auth_token", "")
         self.endpoint = endpoint or env_config.get(
-            "api_endpoint", "http://localhost:8001/api/v1/traces"
+            "api_endpoint", "https://api.kalibr.systems/api/v1/traces"
         )
         self.tenant_id = tenant_id or env_config.get("tenant_id", "default")
         self.environment = environment or env_config.get("environment", "prod")

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/middleware/auto_tracer.py

@@ -54,7 +54,7 @@ class AutoTracerMiddleware(BaseHTTPMiddleware):
 
         # Collector config
         self.collector_url = collector_url or os.getenv(
-            "KALIBR_COLLECTOR_URL", "http://localhost:8001/api/ingest"
+            "KALIBR_COLLECTOR_URL", "https://api.kalibr.systems/api/ingest"
         )
         self.api_key = api_key or os.getenv("KALIBR_API_KEY", "")
         self.tenant_id = tenant_id or os.getenv("KALIBR_TENANT_ID", "default")

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/simple_tracer.py

@@ -53,8 +53,11 @@ def send_event(payload: dict):
         print("[Kalibr SDK] ❌ requests library not available")
         return
 
-    url = os.getenv("KALIBR_COLLECTOR_URL", "http://localhost:8001/api/ingest")
-    api_key = os.getenv("KALIBR_API_KEY", "test_key_12345")
+    url = os.getenv("KALIBR_COLLECTOR_URL", "https://api.kalibr.systems/api/ingest")
+    api_key = os.getenv("KALIBR_API_KEY")
+    if not api_key:
+        print("[Kalibr SDK] ⚠️  KALIBR_API_KEY not set, traces will not be sent")
+        return
 
     format_pref = os.getenv("KALIBR_COLLECTOR_FORMAT", "ndjson").lower()
     use_json_envelope = format_pref == "json"
@@ -120,7 +123,7 @@ def trace(
             parent_span_id = kwargs.pop("parent_span_id", None)  # None or base62 string
 
             # Load environment config
-            tenant_id = os.getenv("KALIBR_TENANT_ID", "emergent")
+            tenant_id = os.getenv("KALIBR_TENANT_ID", "default")
             workflow_id = os.getenv("KALIBR_WORKFLOW_ID", "multi_agent_demo")
             sandbox_id = os.getenv("SANDBOX_ID", "vercel_vm_001")
             runtime_env = os.getenv("RUNTIME_ENV", "vercel_vm")

{kalibr-1.1.1a0 → kalibr-1.1.3a0}/kalibr/utils.py

@@ -38,8 +38,8 @@ def load_config_from_env() -> Dict[str, str]:
         "workflow_id": os.getenv("KALIBR_WORKFLOW_ID", "default-workflow"),
         "sandbox_id": os.getenv("SANDBOX_ID", "local"),
         "runtime_env": os.getenv("RUNTIME_ENV", "local"),
-        "api_endpoint": os.getenv("KALIBR_API_ENDPOINT", "http://localhost:8001/api/v1/traces"),
-        "collector_url": os.getenv("KALIBR_COLLECTOR_URL", "http://localhost:8080/api/ingest"),
+        "api_endpoint": os.getenv("KALIBR_API_ENDPOINT", "https://api.kalibr.systems/api/v1/traces"),
+        "collector_url": os.getenv("KALIBR_COLLECTOR_URL", "https://api.kalibr.systems/api/ingest"),
     }
     return config