voiceeval-sdk 0.1.0__tar.gz

voiceeval_sdk-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build-and-publish:
+    name: Build and Publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - name: Checkout source
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

voiceeval_sdk-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Environments
+.env
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Distribution
+dist/
+build/
+*.egg-info/
+
+# MyPy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# IDE
+.vscode/
+.idea/

voiceeval_sdk-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,49 @@
+# Contributing to VoiceEval SDK
+
+We love your input! We want to make contributing to VoiceEval as easy and transparent as possible, whether it's:
+
+- Reporting a bug
+- Discussing the current state of the code
+- Submitting a fix
+- Proposing new features
+- Becoming a maintainer
+
+## Development Workflow
+
+We use `uv` and `hatch` for dependency management and packaging.
+
+1.  **Clone the repo:**
+
+    ```bash
+    git clone https://github.com/voiceeval/voiceeval-sdk.git
+    cd voiceeval-sdk
+    ```
+
+2.  **Install dependencies:**
+
+    ```bash
+    # Install dev dependencies (includes pytest, etc.)
+    uv sync
+    ```
+
+3.  **Run Tests:**
+
+    ```bash
+    uv run pytest
+    ```
+
+4.  **Linting & Formatting:**
+
+    We recommend using `ruff` (if configured) or standard tools. Ensure your code is pythonic.
+
+## Pull Requests
+
+1.  Fork the repo and create your branch from `main`.
+2.  If you've added code that should be tested, add tests.
+3.  If you've changed APIs, update the documentation.
+4.  Ensure the test suite passes.
+5.  Issue that PR!
+
+## License
+
+By contributing, you agree that your contributions will be licensed under its MIT License.

voiceeval_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VoiceEval
+
+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.

voiceeval_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: voiceeval-sdk
+Version: 0.1.0
+Summary: Enterprise-grade Observability and Evaluation SDK for Voice Agents
+Project-URL: Repository, https://github.com/voiceeval/voiceeval-sdk
+Project-URL: Homepage, https://voiceeval.com
+Author-email: VoiceEval Team <hello@voiceeval.com>
+License: MIT License
+        
+        Copyright (c) 2025 VoiceEval
+        
+        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.
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.127.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: openai>=2.14.0
+Requires-Dist: opentelemetry-api>=1.39.1
+Requires-Dist: opentelemetry-exporter-otlp>=1.39.1
+Requires-Dist: opentelemetry-instrumentation-anthropic>=0.50.1
+Requires-Dist: opentelemetry-instrumentation-google-generativeai>=0.50.1
+Requires-Dist: opentelemetry-instrumentation-openai>=0.50.1
+Requires-Dist: opentelemetry-sdk>=1.39.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: uvicorn>=0.40.0
+Description-Content-Type: text/markdown
+
+# VoiceEval SDK (Python)
+
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-Native-purple)](https://opentelemetry.io/)
+
+**VoiceEval** is an enterprise-grade observability and evaluation SDK designed specifically for Voice Agents and LLM-powered applications. It provides detailed tracing, latency breakdown, and cost analysis with zero configuration.
+
+## 🚀 Key Features
+
+- **🔎 Zero-Config Auto-Instrumentation**: Automatically detects and traces calls from major LLM providers (OpenAI, Anthropic, Google Gemini) without any code changes.
+- **🛡️ Secure Ingestion Proxy**: All traces are sent through a secure proxy (`server/`), separating your application logic from downstream observability backends (like Langfuse). This ensures you maintain full control over your data and API keys.
+- **⚡ High Performance**: Built on top of `OpenTelemetry`, utilizing efficient asynchronous Batch exports (`OTLP/HTTP`) to ensure negligible runtime overhead.
+- **🧩 Standardized Data Model**: Uses standard OTel semantic conventions, making your data portable and interoperable with any OTel-compatible backend.
+
+## 📦 Installation
+
+Install the SDK via `pip` (or `uv`):
+
+```bash
+pip install voiceeval-sdk
+# or
+uv add voiceeval-sdk
+```
+
+For local development:
+```bash
+git clone https://github.com/voiceeval/voiceeval-sdk.git
+cd voiceeval-sdk
+pip install -e .
+```
+
+## 🏁 Quickstart
+
+### 1. Initialize the Client
+
+Initialize the `Client` at the start of your application. This single line sets up the OTel exporter and enables auto-instrumentation for all installed LLM libraries.
+
+```python
+from voiceeval import Client
+
+# Initialize SDK - connects to your local proxy or prod endpoint
+client = Client(
+    api_key="your_voiceeval_api_key",  # or set VOICE_EVAL_API_KEY env var
+    base_url="http://api.voiceeval.com/v1/traces"
+)
+```
+
+### 2. Run Your Agent
+
+That's it! Any calls to supported libraries like `openai` or `anthropic` are now automatically traced.
+
+```python
+from openai import OpenAI
+
+# No manual wrapping needed!
+client_openai = OpenAI()
+response = client_openai.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello world"}]
+)
+```
+
+### 3. Manual Tracing (Optional)
+
+For functions that don't call LLMs (like your business logic or RAG pipeline), use the `@observe` decorator:
+
+```python
+from voiceeval import observe
+
+@observe(name_override="rag_retrieval")
+def retrieve_documents(query: str):
+    # Your complex logic here
+    return docs
+```
+
+## 🔌 Supported Providers
+
+The SDK automatically instruments the following libraries if they are found in your environment:
+
+| Provider | Library | Status |
+| :--- | :--- | :--- |
+| **OpenAI** | `openai` | ✅ Auto-Instrumented |
+| **Anthropic** | `anthropic` | ✅ Auto-Instrumented |
+| **Google Gemini** | `google-generativeai` | ✅ Auto-Instrumented |
+
+*Note: If a library is not installed, the SDK gracefully skips it.*
+
+## 📄 License
+
+MIT

voiceeval_sdk-0.1.0/README.md

@@ -0,0 +1,91 @@
+# VoiceEval SDK (Python)
+
+[![Python](https://img.shields.io/badge/Python-3.11%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-MIT-green)](LICENSE)
+[![OpenTelemetry](https://img.shields.io/badge/OpenTelemetry-Native-purple)](https://opentelemetry.io/)
+
+**VoiceEval** is an enterprise-grade observability and evaluation SDK designed specifically for Voice Agents and LLM-powered applications. It provides detailed tracing, latency breakdown, and cost analysis with zero configuration.
+
+## 🚀 Key Features
+
+- **🔎 Zero-Config Auto-Instrumentation**: Automatically detects and traces calls from major LLM providers (OpenAI, Anthropic, Google Gemini) without any code changes.
+- **🛡️ Secure Ingestion Proxy**: All traces are sent through a secure proxy (`server/`), separating your application logic from downstream observability backends (like Langfuse). This ensures you maintain full control over your data and API keys.
+- **⚡ High Performance**: Built on top of `OpenTelemetry`, utilizing efficient asynchronous Batch exports (`OTLP/HTTP`) to ensure negligible runtime overhead.
+- **🧩 Standardized Data Model**: Uses standard OTel semantic conventions, making your data portable and interoperable with any OTel-compatible backend.
+
+## 📦 Installation
+
+Install the SDK via `pip` (or `uv`):
+
+```bash
+pip install voiceeval-sdk
+# or
+uv add voiceeval-sdk
+```
+
+For local development:
+```bash
+git clone https://github.com/voiceeval/voiceeval-sdk.git
+cd voiceeval-sdk
+pip install -e .
+```
+
+## 🏁 Quickstart
+
+### 1. Initialize the Client
+
+Initialize the `Client` at the start of your application. This single line sets up the OTel exporter and enables auto-instrumentation for all installed LLM libraries.
+
+```python
+from voiceeval import Client
+
+# Initialize SDK - connects to your local proxy or prod endpoint
+client = Client(
+    api_key="your_voiceeval_api_key",  # or set VOICE_EVAL_API_KEY env var
+    base_url="http://api.voiceeval.com/v1/traces"
+)
+```
+
+### 2. Run Your Agent
+
+That's it! Any calls to supported libraries like `openai` or `anthropic` are now automatically traced.
+
+```python
+from openai import OpenAI
+
+# No manual wrapping needed!
+client_openai = OpenAI()
+response = client_openai.chat.completions.create(
+    model="gpt-4o",
+    messages=[{"role": "user", "content": "Hello world"}]
+)
+```
+
+### 3. Manual Tracing (Optional)
+
+For functions that don't call LLMs (like your business logic or RAG pipeline), use the `@observe` decorator:
+
+```python
+from voiceeval import observe
+
+@observe(name_override="rag_retrieval")
+def retrieve_documents(query: str):
+    # Your complex logic here
+    return docs
+```
+
+## 🔌 Supported Providers
+
+The SDK automatically instruments the following libraries if they are found in your environment:
+
+| Provider | Library | Status |
+| :--- | :--- | :--- |
+| **OpenAI** | `openai` | ✅ Auto-Instrumented |
+| **Anthropic** | `anthropic` | ✅ Auto-Instrumented |
+| **Google Gemini** | `google-generativeai` | ✅ Auto-Instrumented |
+
+*Note: If a library is not installed, the SDK gracefully skips it.*
+
+## 📄 License
+
+MIT

voiceeval_sdk-0.1.0/examples/basic_eval.py

@@ -0,0 +1,46 @@
+from voiceeval import Client, observe
+import os
+from openai import OpenAI
+from dotenv import load_dotenv
+
+load_dotenv()
+
+# OpenAI is auto-instrumented by Client()
+
+def main():
+    # 1. Initialize Client pointing to local proxy
+    client = Client(
+        api_key="test_key", 
+        base_url="http://localhost:8000/v1/traces"
+    )
+    print("Client initialized.")
+
+    # 2. Instrument a function calling OpenAI
+    @observe(name_override="voice_agent_transaction")
+    def run_agent_simulation(user_input):
+        print(f"Agent received: {user_input}")
+        
+        client_openai = OpenAI()
+        completion = client_openai.chat.completions.create(
+            model="gpt-4o-mini",
+            messages=[
+                {"role": "system", "content": "You are a helpful voice assistant."},
+                {"role": "user", "content": user_input}
+            ]
+        )
+        response = completion.choices[0].message.content
+        return response
+
+    # 3. Run
+    # Ensure OPENAI_API_KEY is set
+    if "OPENAI_API_KEY" not in os.environ:
+        print("Please set OPENAI_API_KEY environment variable.")
+        return
+
+    print("Running simulation with OpenAI...")
+    response = run_agent_simulation("What is the capital of France?")
+    print(f"Agent response: {response}")
+    print("Trace generated. Check server logs.")
+
+if __name__ == "__main__":
+    main()

voiceeval_sdk-0.1.0/examples/realtime_monitor.py

@@ -0,0 +1,8 @@
+from voiceeval import Client
+
+def main():
+    client = Client(api_key="demo_key")
+    print("Starting realtime monitor... (Not implemented in scaffold)")
+
+if __name__ == "__main__":
+    main()

voiceeval_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "voiceeval-sdk"
+version = "0.1.0"
+description = "Enterprise-grade Observability and Evaluation SDK for Voice Agents"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { file = "LICENSE" }
+authors = [
+    { name = "VoiceEval Team", email = "hello@voiceeval.com" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+urls.Repository = "https://github.com/voiceeval/voiceeval-sdk"
+urls.Homepage = "https://voiceeval.com"
+dependencies = [
+    "fastapi>=0.127.1",
+    "httpx>=0.28.1",
+    "openai>=2.14.0",
+    "opentelemetry-api>=1.39.1",
+    "opentelemetry-exporter-otlp>=1.39.1",
+    "opentelemetry-instrumentation-anthropic>=0.50.1",
+    "opentelemetry-instrumentation-google-generativeai>=0.50.1",
+    "opentelemetry-instrumentation-openai>=0.50.1",
+    "opentelemetry-sdk>=1.39.1",
+    "pydantic>=2.0.0",
+    "python-dotenv>=1.2.1",
+    "uvicorn>=0.40.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/voiceeval"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+]

voiceeval_sdk-0.1.0/server/main.py

@@ -0,0 +1,70 @@
+import os
+import base64
+import httpx
+from fastapi import FastAPI, Request, HTTPException, Depends
+from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials
+
+app = FastAPI()
+security = HTTPBearer()
+
+# Mock Database
+# In production, this would be a Postgres/Redis lookup
+USER_DB = {
+    "test_key": {
+        "langfuse_public": "pk-lf-2753cba8-1965-4a02-ae14-84d119f5cb76",
+        "langfuse_secret": "sk-lf-b9488264-e94e-4d1f-8e40-4ed7b8ca5b4c",
+        "langfuse_host": "https://us.cloud.langfuse.com"
+    }
+}
+
+async def get_api_key(credentials: HTTPAuthorizationCredentials = Depends(security)):
+    token = credentials.credentials
+    if token not in USER_DB:
+        raise HTTPException(status_code=403, detail="Invalid API Key")
+    return token
+
+@app.post("/v1/traces")
+async def ingest_traces(request: Request, api_key: str = Depends(get_api_key)):
+    config = USER_DB[api_key]
+    lf_public = config["langfuse_public"]
+    lf_secret = config["langfuse_secret"]
+    lf_host = config["langfuse_host"]
+
+    body = await request.body()
+    
+    auth_str = f"{lf_public}:{lf_secret}"
+    auth_b64 = base64.b64encode(auth_str.encode()).decode()
+    
+    target_url = f"{lf_host}/api/public/otel/v1/traces"
+    
+    headers = {
+        "Authorization": f"Basic {auth_b64}",
+        "Content-Type": request.headers.get("Content-Type", "application/x-protobuf")
+    }
+
+    async with httpx.AsyncClient(timeout=30.0) as client:
+        try:
+            print(f"DEBUG: Forwarding to {target_url}")
+            print(f"DEBUG: Headers = {headers}")
+            print(f"DEBUG: Body size = {len(body)} bytes")
+            
+            response = await client.post(target_url, content=body, headers=headers)
+            
+            print(f"Langfuse Response Status: {response.status_code}")
+            print(f"Langfuse Response Headers: {response.headers}")
+            print(f"Langfuse Response Body: {response.text[:500] if response.text else '(empty)'}")
+            
+            if response.status_code >= 400:
+                return {"status": "error", "upstream_status": response.status_code, "detail": response.text}
+            
+            return {"status": "success", "upstream_status": response.status_code}
+        except httpx.HTTPError as e:
+            print(f"HTTP Error forwarding to Langfuse: {type(e).__name__}: {e}")
+            raise HTTPException(status_code=502, detail=f"Upstream HTTP error: {str(e)}")
+        except Exception as e:
+            print(f"Unexpected error forwarding to Langfuse: {type(e).__name__}: {e}")
+            raise HTTPException(status_code=502, detail=f"Upstream error: {str(e)}")
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)

voiceeval_sdk-0.1.0/src/voiceeval/__init__.py

@@ -0,0 +1,5 @@
+from voiceeval.client import Client
+from voiceeval.models import Call, Transcript, Span
+from voiceeval.observability import observe
+
+__all__ = ["Client", "Call", "Transcript", "Span", "observe"]

voiceeval_sdk-0.1.0/src/voiceeval/audio/__init__.py

@@ -0,0 +1,5 @@
+from voiceeval.audio.ingestion import AudioIngestor
+from voiceeval.audio.transcription import Transcriber
+from voiceeval.audio.vad import VAD
+
+__all__ = ["AudioIngestor", "Transcriber", "VAD"]

voiceeval_sdk-0.1.0/src/voiceeval/audio/ingestion.py

@@ -0,0 +1,9 @@
+class AudioIngestor:
+    """
+    Handles ingestion of raw audio bytes or streams.
+    """
+    def __init__(self, source: str):
+        self.source = source
+
+    def read(self) -> bytes:
+        raise NotImplementedError

voiceeval_sdk-0.1.0/src/voiceeval/audio/transcription.py

@@ -0,0 +1,9 @@
+from typing import List
+from voiceeval.models import TranscriptSegment
+
+class Transcriber:
+    """
+    Base class for transcription services.
+    """
+    def transcribe(self, audio: bytes) -> List[TranscriptSegment]:
+        raise NotImplementedError

voiceeval_sdk-0.1.0/src/voiceeval/audio/vad.py

@@ -0,0 +1,11 @@
+from typing import List, Tuple
+
+class VAD:
+    """
+    Voice Activity Detection utilities.
+    """
+    def detect_speech(self, audio: bytes) -> List[Tuple[float, float]]:
+        """
+        Returns list of (start_time, end_time) tuples where speech is detected.
+        """
+        return []

voiceeval_sdk-0.1.0/src/voiceeval/client.py

@@ -0,0 +1,87 @@
+import os
+import logging
+from typing import Optional
+from voiceeval.models import Call
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
+from opentelemetry import trace
+
+logger = logging.getLogger(__name__)
+
+class Client:
+    """
+    Main entry point for the VoiceEval SDK.
+    """
+    def __init__(self, api_key: Optional[str] = None, base_url: str = "https://api.voiceeval.com/v1/traces"):
+        self.api_key = api_key or os.environ.get("VOICE_EVAL_API_KEY")
+        if not self.api_key:
+            raise ValueError("API Key is required. Set VOICE_EVAL_API_KEY env var or pass in __init__.")
+            
+        self.ingest_url = base_url
+        self.enable_observability()
+
+    def enable_observability(self):
+        """Auto-configures OTel to send data to VoiceEval Proxy and instruments common libraries."""
+        provider = TracerProvider()
+        exporter = OTLPSpanExporter(
+            endpoint=self.ingest_url,
+            headers={"Authorization": f"Bearer {self.api_key}"}
+        )
+        
+        provider.add_span_processor(BatchSpanProcessor(exporter))
+        trace.set_tracer_provider(provider)
+        
+        # Auto-instrument common libraries
+        self._instrument_libraries()
+
+    def create_call(self, agent_id: str) -> Call:
+        """
+        Initialize a tracking object for a new call.
+        """
+        raise NotImplementedError("create_call is not implemented yet")
+
+    def log_call(self, call: Call) -> None:
+        """
+        Log a completed call to the platform.
+        """
+        tracer = trace.get_tracer("voiceeval.sdk")
+        with tracer.start_as_current_span("log_call") as span:
+            span.set_attribute("call.id", call.call_id)
+            span.set_attribute("agent.id", call.agent_id)
+
+    def _instrument_libraries(self):
+        """
+        Auto-instrument all installed OTel instrumentation packages.
+        This uses the standard 'opentelemetry_instrumentor' entry point.
+        """
+        try:
+            from importlib.metadata import entry_points
+        except ImportError:
+            return
+
+        logger.debug("Auto-instrumenting installed libraries...")
+        # Python 3.10+ supports filtering by group
+        eps = entry_points(group="opentelemetry_instrumentor")
+        
+        for entry_point in eps:
+            try:
+                instrumentor = entry_point.load()()
+                if not instrumentor.is_instrumented_by_opentelemetry:
+                    instrumentor.instrument()
+                    logger.debug(f"Instrumented: {entry_point.name}")
+            except Exception as e:
+                # Silently fail (debug log only)
+                logger.debug(f"Failed to instrument {entry_point.name}: {e}")
+
+if __name__ == "__main__":
+    # Configure logging to see output when running this script directly
+    # logging.basicConfig(level=logging.DEBUG)
+    
+    # Client() automatically enables observability and instruments libraries
+    # Using a dummy key for testing initialization
+    try:
+        client = Client(api_key="test_key")
+        print("Client initialized and libraries instrumented.")
+    except Exception as e:
+        print(f"Initialization failed: {e}")