kalibr 1.0.25__py3-none-any.whl → 1.1.2a0__py3-none-any.whl

kalibr/utils.py

@@ -0,0 +1,198 @@
+"""Utility functions for Kalibr SDK.
+
+Helper functions for:
+- Environment configuration
+- Event validation
+- JSON serialization
+- Logging
+"""
+
+import json
+import os
+from datetime import date, datetime, time
+from typing import Any, Dict, Optional
+
+
+def load_config_from_env() -> Dict[str, str]:
+    """Load Kalibr configuration from environment variables.
+
+    Returns:
+        Configuration dict with keys:
+        - clickhouse_url: ClickHouse connection URL
+        - project_name: Project/service name
+        - auth_token: API authentication token
+        - environment: Environment (prod/staging/dev)
+        - tenant_id: Tenant identifier
+        - workflow_id: Workflow identifier
+        - sandbox_id: Sandbox/VM identifier
+        - runtime_env: Runtime environment
+        - collector_url: Collector endpoint URL
+    """
+    config = {
+        "clickhouse_url": os.getenv("CLICKHOUSE_URL", "http://localhost:8123"),
+        "project_name": os.getenv("KALIBR_PROJECT_NAME", "kalibr-app"),
+        "auth_token": os.getenv("KALIBR_AUTH_TOKEN", ""),
+        "api_key": os.getenv("KALIBR_API_KEY", ""),
+        "environment": os.getenv("KALIBR_ENVIRONMENT", "prod"),
+        "tenant_id": os.getenv("KALIBR_TENANT_ID", "default"),
+        "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"),
+    }
+    return config
+
+
+def validate_event(event: Dict[str, Any]) -> bool:
+    """Validate that event has required fields.
+
+    Args:
+        event: Event dictionary
+
+    Returns:
+        True if valid, False otherwise
+    """
+    required_fields = [
+        "trace_id",
+        "span_id",
+        "timestamp",
+        "service",
+        "vendor",
+        "operation",
+        "latency_ms",
+        "status",
+    ]
+
+    for field in required_fields:
+        if field not in event:
+            return False
+
+    return True
+
+
+def serialize_event(event: Dict[str, Any]) -> str:
+    """Serialize event to JSON string.
+
+    Handles special types like datetime, date, time.
+
+    Args:
+        event: Event dictionary
+
+    Returns:
+        JSON string
+    """
+
+    def default_handler(obj):
+        """Handle non-serializable types."""
+        if isinstance(obj, (datetime, date, time)):
+            return obj.isoformat()
+        raise TypeError(f"Object of type {type(obj)} is not JSON serializable")
+
+    return json.dumps(event, default=default_handler)
+
+
+def safe_get_nested(data: Dict, keys: list, default: Any = None) -> Any:
+    """Safely get nested dictionary value.
+
+    Args:
+        data: Dictionary to query
+        keys: List of nested keys
+        default: Default value if key path doesn't exist
+
+    Returns:
+        Value at nested key path, or default
+
+    Example:
+        >>> data = {"a": {"b": {"c": 123}}}
+        >>> safe_get_nested(data, ["a", "b", "c"])
+        123
+        >>> safe_get_nested(data, ["a", "x", "y"], default=0)
+        0
+    """
+    current = data
+    for key in keys:
+        if isinstance(current, dict) and key in current:
+            current = current[key]
+        else:
+            return default
+    return current
+
+
+def truncate_string(s: str, max_length: int = 1000) -> str:
+    """Truncate string to max length with ellipsis.
+
+    Args:
+        s: String to truncate
+        max_length: Maximum length
+
+    Returns:
+        Truncated string
+    """
+    if len(s) <= max_length:
+        return s
+    return s[: max_length - 3] + "..."
+
+
+def format_cost(cost_usd: float) -> str:
+    """Format cost in USD for display.
+
+    Args:
+        cost_usd: Cost in USD
+
+    Returns:
+        Formatted string (e.g., "$0.0123")
+    """
+    if cost_usd < 0.0001:
+        return "$0.0000"
+    elif cost_usd < 0.01:
+        return f"${cost_usd:.4f}"
+    elif cost_usd < 1.0:
+        return f"${cost_usd:.3f}"
+    else:
+        return f"${cost_usd:.2f}"
+
+
+def format_latency(latency_ms: int) -> str:
+    """Format latency for display.
+
+    Args:
+        latency_ms: Latency in milliseconds
+
+    Returns:
+        Formatted string (e.g., "420ms" or "2.3s")
+    """
+    if latency_ms < 1000:
+        return f"{latency_ms}ms"
+    else:
+        seconds = latency_ms / 1000
+        return f"{seconds:.1f}s"
+
+
+def get_log_prefix() -> str:
+    """Get log prefix for Kalibr SDK messages.
+
+    Returns:
+        Log prefix string
+    """
+    return "[Kalibr SDK]"
+
+
+def log_info(message: str):
+    """Log info message."""
+    print(f"{get_log_prefix()} ℹ️  {message}")
+
+
+def log_warning(message: str):
+    """Log warning message."""
+    print(f"{get_log_prefix()} ⚠️  {message}")
+
+
+def log_error(message: str):
+    """Log error message."""
+    print(f"{get_log_prefix()} ❌ {message}")
+
+
+def log_success(message: str):
+    """Log success message."""
+    print(f"{get_log_prefix()} ✅ {message}")

kalibr-1.1.2a0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,48 @@
+kalibr/__init__.py,sha256=V65LyTow2l1RHR7RVDclJ6kWYypmleu3K1hV-shz7g0,5912
+kalibr/__main__.py,sha256=jO96I4pqinwHg7ONRvNVKbySBh5pSIhOAiNrgSQrNlY,110
+kalibr/capsule_middleware.py,sha256=pXG_wORgCqo3wHjtkn_zY4doLyiDmTwJtB7XiZNnbPk,3163
+kalibr/client.py,sha256=t6_vZn_juHrsCg-7QFrkl-pzlqV7ZesQLCh8fnF808Q,9727
+kalibr/collector.py,sha256=rtTKQLe6NkDSblBIfFooQ-ESFcP0Q1HUp4Bcqqg8JFo,5818
+kalibr/context.py,sha256=hBxWXZx0gcmeGqDMS1rstke_DmrujoRBIsfrG26WKUY,3755
+kalibr/cost_adapter.py,sha256=NerJ7ywaJjBn97gVFr7qKX7318e3Kmy2qqeNlGl9nPE,6439
+kalibr/decorators.py,sha256=m-XBXxWMDVrzaNsljACiGmeGhgiHj_MqSfj6OGK3L5I,4380
+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/redaction.py,sha256=XibxX4Lv1Ci0opE6Tb5ZI2GLbO0a8E9U66MAg60llnc,1139
+kalibr/schemas.py,sha256=XLZNLkXca6jbj9AF6gDIyGVnIcr1SVOsNYaKvW-wbgE,3669
+kalibr/simple_tracer.py,sha256=XwVI7h25vUok7I3AIiFm1TGBvDM--lzl-xAhTiv7d4o,9775
+kalibr/tokens.py,sha256=istjgaxi9S4dMddjuGtoQaTnZYcWLCqdnxRjV86yNXA,1297
+kalibr/trace_capsule.py,sha256=CPMUz5D-fVfao-MozNtSDbgOQKdDAJxTN5KQL6w2Xp8,10154
+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=IbAgw-Bwxdy9Kc0fm2yIDt2RxWU0gRCzffuz3GRUSnE,5042
+kalibr/cli/__init__.py,sha256=FmRGaDMhM9DhrKg1ONkF0emIrJcjFWjlFBl_oenvpsk,77
+kalibr/cli/capsule_cmd.py,sha256=htxUtRpos_dLs-LnJm6WeGtLYCCc1h7H3WXz7i6DVWc,6082
+kalibr/cli/deploy_cmd.py,sha256=kV4uqCN2IdQev1vPBY5qqIHsEhjGBZ7y_rLx8RGAL_4,5178
+kalibr/cli/main.py,sha256=Ob0Vpg8KPnHluP_23pgbEZpDb_iKnjoN7mW52-2Qr44,1939
+kalibr/cli/run.py,sha256=T3oQ0aSfBMyOlwjJ8hGojmkrAr6EuzpzPXDUNK4amW0,6423
+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/middleware/__init__.py,sha256=qyDUn_irAX67MS-IkuDVxg4RmFnJHDf_BfIT3qfGoBI,115
+kalibr/middleware/auto_tracer.py,sha256=oevrhWBAM4el_F5jFc28ZBFLEklx7XGd40dNFe5VQ8Q,13032
+kalibr-1.1.2a0.dist-info/licenses/LICENSE,sha256=BYlEPoDdYD3iHuAjt2JYGoxDYQaI1gxab2pR4acoz04,1063
+kalibr_crewai/__init__.py,sha256=ClbyRwZ9K3VabYg3RnjnCNQtv1z7UNyCAlMSo0tCGYQ,1791
+kalibr_crewai/callbacks.py,sha256=jP-eJcLzk9gpdG5uDwn_XVhZbUUV8GtUQc3qHSgpm3A,17152
+kalibr_crewai/instrumentor.py,sha256=IbKVTlxrZhFP8ykqyS4w7RfS3zGMA1K80dEUGaWBlNg,19460
+kalibr_langchain/__init__.py,sha256=BPj6JZgWDh3wNQCnIfdC24gupzBjVPxbq3zBsfn7yCY,1368
+kalibr_langchain/async_callback.py,sha256=sAJIhysNGDz53R5ueoNmgElfSr8_V97eW-0-8dVaqik,27743
+kalibr_langchain/callback.py,sha256=NW6pWtd9j9RBSN4v69Rhmo6RN1lsYYo_QTPYz7HJ65c,34260
+kalibr_openai_agents/__init__.py,sha256=ToKJ1Krwc38ADZO0HCWo1_ZMGi4VRIEgym2Avkg0CyQ,1362
+kalibr_openai_agents/processor.py,sha256=CT7llzbljrIYeVbUWM9N5yXCnPJMujB_AmhA__Xte9Q,18252
+kalibr-1.1.2a0.dist-info/METADATA,sha256=W7T3HAPs441LUIdTINo20KTQNAFUHYwRoPSjCnLVqFg,7864
+kalibr-1.1.2a0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kalibr-1.1.2a0.dist-info/entry_points.txt,sha256=Kojlc6WRX8V1qS9lOMdDPZpTUVHCtzGtHqXusErgmLY,47
+kalibr-1.1.2a0.dist-info/top_level.txt,sha256=dIfBOWUnnHGFDwgz5zfIx5_0bU3wOUgAbYr4JcFHZmo,59
+kalibr-1.1.2a0.dist-info/RECORD,,

kalibr-1.1.2a0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+kalibr = kalibr.cli.main:app

kalibr-1.1.2a0.dist-info/licenses/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.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+kalibr
+kalibr_crewai
+kalibr_langchain
+kalibr_openai_agents

kalibr_crewai/__init__.py

@@ -0,0 +1,65 @@
+"""Kalibr CrewAI Integration - Observability for CrewAI applications.
+
+This package provides callbacks and auto-instrumentation for CrewAI,
+capturing:
+- Agent step execution with tool calls
+- Task completion with outputs
+- Crew execution lifecycle
+- Token usage and costs
+- Error tracking
+
+Usage with Callbacks:
+    from kalibr_crewai import KalibrAgentCallback, KalibrTaskCallback
+    from crewai import Agent, Task, Crew
+
+    # Create callbacks
+    agent_callback = KalibrAgentCallback(tenant_id="my-tenant")
+    task_callback = KalibrTaskCallback(tenant_id="my-tenant")
+
+    # Use with Agent
+    agent = Agent(
+        role="Researcher",
+        goal="Find information",
+        step_callback=agent_callback,
+    )
+
+    # Use with Task
+    task = Task(
+        description="Research AI trends",
+        agent=agent,
+        callback=task_callback,
+    )
+
+Usage with Auto-Instrumentation:
+    from kalibr_crewai import KalibrCrewAIInstrumentor
+
+    # Instrument CrewAI (call before creating crews)
+    instrumentor = KalibrCrewAIInstrumentor(tenant_id="my-tenant")
+    instrumentor.instrument()
+
+    # Now all CrewAI operations are automatically traced
+    crew = Crew(agents=[...], tasks=[...])
+    result = crew.kickoff()
+
+    # Optionally uninstrument
+    instrumentor.uninstrument()
+
+Environment Variables:
+    KALIBR_API_KEY: API key for authentication
+    KALIBR_ENDPOINT: Backend endpoint URL
+    KALIBR_TENANT_ID: Tenant identifier
+    KALIBR_ENVIRONMENT: Environment (prod/staging/dev)
+    KALIBR_SERVICE: Service name
+"""
+
+__version__ = "0.1.0"
+
+from .callbacks import KalibrAgentCallback, KalibrTaskCallback
+from .instrumentor import KalibrCrewAIInstrumentor
+
+__all__ = [
+    "KalibrAgentCallback",
+    "KalibrTaskCallback",
+    "KalibrCrewAIInstrumentor",
+    "__version__",
+]