kalibr 0.1.28__tar.gz → 1.1.2a0__tar.gz

kalibr-1.1.2a0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kalibr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kalibr-1.1.2a0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: kalibr
+Version: 1.1.2a0
+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-systems/kalibr-sdk-python
+Project-URL: Documentation, https://docs.kalibr.systems
+Project-URL: Repository, https://github.com/kalibr-systems/kalibr-sdk-python
+Project-URL: Issues, https://github.com/kalibr-systems/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-systems/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-systems/kalibr-sdk-python/issues)
+- [PyPI Package](https://pypi.org/project/kalibr/)

kalibr-1.1.2a0/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-systems/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-systems/kalibr-sdk-python/issues)
+- [PyPI Package](https://pypi.org/project/kalibr/)

kalibr-1.1.2a0/kalibr/__init__.py

@@ -0,0 +1,172 @@
+"""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)
+
+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
+    import openai  # Automatically instrumented!
+
+    app = Kalibr(title="My API")
+
+    @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
+
+Usage - Manual Tracing:
+    from kalibr import trace
+
+    @trace(operation="chat_completion", vendor="openai", model="gpt-4")
+    def call_openai(prompt):
+        response = openai.chat.completions.create(
+            model="gpt-4",
+            messages=[{"role": "user", "content": prompt}]
+        )
+        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
+"""
+
+__version__ = "1.1.0-alpha"
+
+# Auto-instrument LLM SDKs on import (can be disabled via env var)
+import os
+
+# ============================================================================
+# OBSERVABILITY & TRACING (from 1023)
+# ============================================================================
+from .client import KalibrClient
+
+# ============================================================================
+# PHASE 1: SDK INSTRUMENTATION & OPENTELEMETRY (v1.1.0)
+# ============================================================================
+from .collector import (
+    get_tracer_provider,
+)
+from .collector import is_configured as is_collector_configured
+from .collector import (
+    setup_collector,
+)
+from .context import get_parent_span_id, get_trace_id, new_trace_id, trace_context
+from .cost_adapter import (
+    AnthropicCostAdapter,
+    BaseCostAdapter,
+    CostAdapterFactory,
+    OpenAICostAdapter,
+)
+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":
+    # Setup OpenTelemetry collector
+    try:
+        setup_collector(
+            service_name=os.getenv("KALIBR_SERVICE_NAME", "kalibr"),
+            file_export=True,
+            console_export=os.getenv("KALIBR_CONSOLE_EXPORT", "false").lower() == "true",
+        )
+    except Exception as e:
+        print(f"⚠️  Failed to setup OpenTelemetry collector: {e}")
+
+    # Auto-instrument available SDKs
+    try:
+        auto_instrument(["openai", "anthropic", "google"])
+    except Exception as e:
+        print(f"⚠️  Failed to auto-instrument SDKs: {e}")
+
+__all__ = [
+    # ========================================================================
+    # OBSERVABILITY & TRACING
+    # ========================================================================
+    # Simple tracing API (recommended)
+    "trace",
+    # Capsule propagation (Phase 6)
+    "TraceCapsule",
+    "get_or_create_capsule",
+    # Client
+    "KalibrClient",
+    # Context
+    "trace_context",
+    "get_trace_id",
+    "get_parent_span_id",
+    "new_trace_id",
+    # Tracer
+    "Tracer",
+    "SpanContext",
+    # Cost Adapters
+    "BaseCostAdapter",
+    "OpenAICostAdapter",
+    "AnthropicCostAdapter",
+    "CostAdapterFactory",
+    # Models
+    "TraceConfig",
+    "EventData",
+    # 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
+    "auto_instrument",
+    "get_instrumented_providers",
+    # OpenTelemetry collector
+    "setup_collector",
+    "get_tracer_provider",
+    "is_collector_configured",
+]

kalibr-1.1.2a0/kalibr/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for python -m kalibr"""
+
+from kalibr.cli.main import app
+
+if __name__ == "__main__":
+    app()