langtrace-python-sdk 3.3.6__py3-none-any.whl → 3.3.8__py3-none-any.whl

langtrace_python_sdk/instrumentation/milvus/patch.py

@@ -1,8 +1,10 @@
+from langtrace_python_sdk.constants.instrumentation.common import SERVICE_PROVIDERS
 from langtrace_python_sdk.utils.silently_fail import silently_fail
 from opentelemetry.trace import Tracer
 from opentelemetry.trace import SpanKind
 from langtrace_python_sdk.utils import handle_span_error, set_span_attribute
 from langtrace_python_sdk.utils.llm import (
+    get_langtrace_attributes,
     get_extra_attributes,
     set_span_attributes,
 )
@@ -16,6 +18,11 @@ def generic_patch(api, version: str, tracer: Tracer):
         with tracer.start_as_current_span(span_name, kind=SpanKind.CLIENT) as span:
             try:
                 span_attributes = {
+                    **get_langtrace_attributes(
+                        service_provider=SERVICE_PROVIDERS["MILVUS"],
+                        version=version,
+                        vendor_type="Vector Database",
+                    ),
                     "db.system": "milvus",
                     "db.operation": operation,
                     "db.name": kwargs.get("collection_name", None),

langtrace_python_sdk/utils/with_root_span.py

@@ -14,6 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 """
 
+import base64
 import asyncio
 import os
 from deprecated import deprecated
@@ -145,7 +146,9 @@ class SendUserFeedback:
     _langtrace_api_key: str
 
     def __init__(self):
-        self._langtrace_host = os.environ.get("LANGTRACE_API_HOST", LANGTRACE_REMOTE_URL)
+        self._langtrace_host = os.environ.get(
+            "LANGTRACE_API_HOST", LANGTRACE_REMOTE_URL
+        )
         # When the host is set to /api/trace, remove the /api/trace
         if self._langtrace_host.endswith("/api/trace"):
             self._langtrace_host = self._langtrace_host.replace("/api/trace", "")
@@ -162,14 +165,13 @@ class SendUserFeedback:
                 print(Fore.RESET)
                 return
 
-            # convert spanId and traceId to hexadecimals
-            span_hex_number = hex(int(data["spanId"], 10))[2:]  # Convert to hex and remove the '0x' prefix
-            formatted_span_hex_number = span_hex_number.zfill(16)  # Pad with zeros to 16 characters
-            data["spanId"] = f"0x{formatted_span_hex_number}"
+            # convert spanId and traceId to Base64
+            span_bytes = int(data["spanId"], 10).to_bytes(8, "big")
+            data["spanId"] = base64.b64encode(span_bytes).decode("ascii")
 
-            trace_hex_number = hex(int(data["traceId"], 10))[2:]  # Convert to hex and remove the '0x' prefix
-            formatted_trace_hex_number = trace_hex_number.zfill(32)  # Pad with zeros to 32 characters
-            data["traceId"] = f"0x{formatted_trace_hex_number}"
+            # Convert traceId to base64
+            trace_bytes = int(data["traceId"], 10).to_bytes(16, "big")
+            data["traceId"] = base64.b64encode(trace_bytes).decode("ascii")
 
             evaluation = self.get_evaluation(data["spanId"])
             headers = {"x-api-key": self._langtrace_api_key}

langtrace_python_sdk/version.py

@@ -1 +1 @@
-__version__ = "3.3.6"
+__version__ = "3.3.8"

langtrace_python_sdk-3.3.8.dist-info/METADATA

@@ -0,0 +1,493 @@
+Metadata-Version: 2.3
+Name: langtrace-python-sdk
+Version: 3.3.8
+Summary: Python SDK for LangTrace
+Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
+Author-email: Scale3 Labs <engineering@scale3labs.com>
+License: Apache-2.0
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: fsspec>=2024.6.0
+Requires-Dist: opentelemetry-api>=1.25.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.25.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.25.0
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.46b0
+Requires-Dist: opentelemetry-instrumentation>=0.47b0
+Requires-Dist: opentelemetry-sdk>=1.25.0
+Requires-Dist: sentry-sdk>=2.14.0
+Requires-Dist: sqlalchemy
+Requires-Dist: tiktoken>=0.1.1
+Requires-Dist: trace-attributes==7.1.0
+Requires-Dist: transformers>=4.11.3
+Requires-Dist: ujson>=5.10.0
+Provides-Extra: dev
+Requires-Dist: anthropic; extra == 'dev'
+Requires-Dist: boto3; extra == 'dev'
+Requires-Dist: chromadb; extra == 'dev'
+Requires-Dist: cohere; extra == 'dev'
+Requires-Dist: embedchain; extra == 'dev'
+Requires-Dist: google-cloud-aiplatform; extra == 'dev'
+Requires-Dist: google-generativeai; extra == 'dev'
+Requires-Dist: groq; extra == 'dev'
+Requires-Dist: langchain; extra == 'dev'
+Requires-Dist: langchain-community; extra == 'dev'
+Requires-Dist: langchain-openai; extra == 'dev'
+Requires-Dist: litellm==1.48.7; extra == 'dev'
+Requires-Dist: mistralai; extra == 'dev'
+Requires-Dist: ollama; extra == 'dev'
+Requires-Dist: openai==1.45.0; extra == 'dev'
+Requires-Dist: pinecone-client; extra == 'dev'
+Requires-Dist: python-dotenv; extra == 'dev'
+Requires-Dist: qdrant-client; extra == 'dev'
+Requires-Dist: setuptools; extra == 'dev'
+Requires-Dist: weaviate-client; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-asyncio; extra == 'test'
+Requires-Dist: pytest-vcr; extra == 'test'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <h1>Langtrace Python SDK</h1>
+  <p>Open Source & Open Telemetry(OTEL) Observability for LLM Applications</p>
+
+  ![Static Badge](https://img.shields.io/badge/License-Apache--2.0-blue)
+  ![Static Badge](https://img.shields.io/badge/pip_langtrace--python--sdk-1.2.8-green)
+  ![Static Badge](https://img.shields.io/badge/Development_status-Active-green)
+  [![Downloads](https://static.pepy.tech/badge/langtrace-python-sdk)](https://static.pepy.tech/badge/langtrace-python-sdk)
+  [![Deploy](https://railway.app/button.svg)](https://railway.app/template/8dNq1c?referralCode=MA2S9H)
+</div>
+
+---
+
+## 📚 Table of Contents
+- [✨ Features](#-features)
+- [🚀 Quick Start](#-quick-start)
+- [🔗 Integrations](#-supported-integrations)
+- [🌐 Getting Started](#-getting-started)
+- [⚙️ Configuration](#-configuration)
+- [🔧 Advanced Features](#-advanced-features)
+- [📐 Examples](#-examples)
+- [🏠 Self Hosting](#-langtrace-self-hosted)
+- [🤝 Contributing](#-contributions)
+- [🔒 Security](#-security)
+- [❓ FAQ](#-frequently-asked-questions)
+- [📜 License](#-license)
+
+Langtrace is an open source observability software which lets you capture, debug and analyze traces and metrics from all your applications that leverages LLM APIs, Vector Databases and LLM based Frameworks.
+
+## ✨ Features
+
+- 📊 **Open Telemetry Support**: Built on OTEL standards for comprehensive tracing
+- 🔄 **Real-time Monitoring**: Track LLM API calls, vector operations, and framework usage
+- 🎯 **Performance Insights**: Analyze latency, costs, and usage patterns
+- 🔍 **Debug Tools**: Trace and debug your LLM application workflows
+- 📈 **Analytics**: Get detailed metrics and visualizations
+- 🛠️ **Framework Support**: Extensive integration with popular LLM frameworks
+- 🔌 **Vector DB Integration**: Support for major vector databases
+- 🎨 **Flexible Configuration**: Customizable tracing and monitoring options
+
+## 🚀 Quick Start
+
+```bash
+pip install langtrace-python-sdk
+```
+
+```python
+from langtrace_python_sdk import langtrace
+langtrace.init(api_key='<your_api_key>') # Get your API key at langtrace.ai
+```
+
+## 🔗 Supported Integrations
+
+Langtrace automatically captures traces from the following vendors:
+
+### LLM Providers
+| Provider | TypeScript SDK | Python SDK |
+|----------|:-------------:|:----------:|
+| OpenAI | ✅ | ✅ |
+| Anthropic | ✅ | ✅ |
+| Azure OpenAI | ✅ | ✅ |
+| Cohere | ✅ | ✅ |
+| Groq | ✅ | ✅ |
+| Perplexity | ✅ | ✅ |
+| Gemini | ❌ | ✅ |
+| Mistral | ❌ | ✅ |
+| AWS Bedrock | ✅ | ✅ |
+| Ollama | ❌ | ✅ |
+| Cerebras | ❌ | ✅ |
+
+### Frameworks
+| Framework | TypeScript SDK | Python SDK |
+|-----------|:-------------:|:----------:|
+| Langchain | ❌ | ✅ |
+| LlamaIndex | ✅ | ✅ |
+| Langgraph | ❌ | ✅ |
+| LiteLLM | ❌ | ✅ |
+| DSPy | ❌ | ✅ |
+| CrewAI | ❌ | ✅ |
+| VertexAI | ✅ | ✅ |
+| EmbedChain | ❌ | ✅ |
+| Autogen | ❌ | ✅ |
+| HiveAgent | ❌ | ✅ |
+| Inspect AI | ❌ | ✅ |
+
+### Vector Databases
+| Database | TypeScript SDK | Python SDK |
+|----------|:-------------:|:----------:|
+| Pinecone | ✅ | ✅ |
+| ChromaDB | ✅ | ✅ |
+| QDrant | ✅ | ✅ |
+| Weaviate | ✅ | ✅ |
+| PGVector | ✅ | ✅ (SQLAlchemy) |
+| MongoDB | ❌ | ✅ |
+| Milvus | ❌ | ✅ |
+
+## 🌐 Getting Started
+
+### Langtrace Cloud ☁️
+
+<!-- Original cloud setup instructions -->
+1. Sign up by going to [this link](https://langtrace.ai).
+2. Create a new Project after signing up. Projects are containers for storing traces and metrics generated by your application. If you have only one application, creating 1 project will do.
+3. Generate an API key by going inside the project.
+4. In your application, install the Langtrace SDK and initialize it with the API key you generated in the step 3.
+5. The code for installing and setting up the SDK is shown below
+
+### Framework Quick Starts
+
+#### FastAPI
+```python
+from fastapi import FastAPI
+from langtrace_python_sdk import langtrace
+from openai import OpenAI
+
+langtrace.init()
+app = FastAPI()
+client = OpenAI()
+
+@app.get("/")
+def root():
+    client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": "Say this is a test"}],
+        stream=False,
+    )
+    return {"Hello": "World"}
+```
+
+#### Django
+```python
+# settings.py
+from langtrace_python_sdk import langtrace
+langtrace.init()
+
+# views.py
+from django.http import JsonResponse
+from openai import OpenAI
+
+client = OpenAI()
+
+def chat_view(request):
+    response = client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": request.GET.get('message', '')}]
+    )
+    return JsonResponse({"response": response.choices[0].message.content})
+```
+
+#### Flask
+```python
+from flask import Flask
+from langtrace_python_sdk import langtrace
+from openai import OpenAI
+
+app = Flask(__name__)
+langtrace.init()
+client = OpenAI()
+
+@app.route('/')
+def chat():
+    response = client.chat.completions.create(
+        model="gpt-4",
+        messages=[{"role": "user", "content": "Hello!"}]
+    )
+    return {"response": response.choices[0].message.content}
+```
+
+#### LangChain
+```python
+from langtrace_python_sdk import langtrace
+from langchain.chat_models import ChatOpenAI
+from langchain.prompts import ChatPromptTemplate
+
+langtrace.init()
+
+# LangChain operations are automatically traced
+chat = ChatOpenAI()
+prompt = ChatPromptTemplate.from_messages([
+    ("system", "You are a helpful assistant."),
+    ("user", "{input}")
+])
+chain = prompt | chat
+response = chain.invoke({"input": "Hello!"})
+```
+
+#### LlamaIndex
+```python
+from langtrace_python_sdk import langtrace
+from llama_index import VectorStoreIndex, SimpleDirectoryReader
+
+langtrace.init()
+
+# Document loading and indexing are automatically traced
+documents = SimpleDirectoryReader('data').load_data()
+index = VectorStoreIndex.from_documents(documents)
+
+# Queries are traced with metadata
+query_engine = index.as_query_engine()
+response = query_engine.query("What's in the documents?")
+```
+
+#### DSPy
+```python
+from langtrace_python_sdk import langtrace
+import dspy
+from dspy.teleprompt import BootstrapFewShot
+
+langtrace.init()
+
+# DSPy operations are automatically traced
+lm = dspy.OpenAI(model="gpt-4")
+dspy.settings.configure(lm=lm)
+
+class SimpleQA(dspy.Signature):
+    """Answer questions with short responses."""
+    question = dspy.InputField()
+    answer = dspy.OutputField(desc="short answer")
+
+compiler = BootstrapFewShot(metric=dspy.metrics.Answer())
+program = compiler.compile(SimpleQA)
+```
+
+#### CrewAI
+```python
+from langtrace_python_sdk import langtrace
+from crewai import Agent, Task, Crew
+
+langtrace.init()
+
+# Agents and tasks are automatically traced
+researcher = Agent(
+    role="Researcher",
+    goal="Research and analyze data",
+    backstory="Expert data researcher",
+    allow_delegation=False
+)
+
+task = Task(
+    description="Analyze market trends",
+    agent=researcher
+)
+
+crew = Crew(
+    agents=[researcher],
+    tasks=[task]
+)
+
+result = crew.kickoff()
+```
+
+For more detailed examples and framework-specific features, visit our [documentation](https://docs.langtrace.ai).
+
+## ⚙️ Configuration
+
+### Initialize Options
+
+The SDK can be initialized with various configuration options to customize its behavior:
+
+```python
+langtrace.init(
+    api_key: Optional[str] = None,          # API key for authentication
+    batch: bool = True,                     # Enable/disable batch processing
+    write_spans_to_console: bool = False,   # Console logging
+    custom_remote_exporter: Optional[Any] = None,  # Custom exporter
+    api_host: Optional[str] = None,         # Custom API host
+    disable_instrumentations: Optional[Dict] = None,  # Disable specific integrations
+    service_name: Optional[str] = None,     # Custom service name
+    disable_logging: bool = False,          # Disable all logging
+    headers: Dict[str, str] = {},           # Custom headers
+)
+```
+
+#### Configuration Details
+
+| Parameter | Type | Default Value | Description |
+|-----------|------|---------------|-------------|
+| `api_key` | `str` | `LANGTRACE_API_KEY` or `None` | The API key for authentication. Can be set via environment variable |
+| `batch` | `bool` | `True` | Whether to batch spans before sending them to reduce API calls |
+| `write_spans_to_console` | `bool` | `False` | Enable console logging for debugging purposes |
+| `custom_remote_exporter` | `Optional[Exporter]` | `None` | Custom exporter for sending traces to your own backend |
+| `api_host` | `Optional[str]` | `https://langtrace.ai/` | Custom API endpoint for self-hosted deployments |
+| `disable_instrumentations` | `Optional[Dict]` | `None` | Disable specific vendor instrumentations (e.g., `{'only': ['openai']}`) |
+| `service_name` | `Optional[str]` | `None` | Custom service name for trace identification |
+| `disable_logging` | `bool` | `False` | Disable SDK logging completely |
+| `headers` | `Dict[str, str]` | `{}` | Custom headers for API requests |
+
+### Environment Variables
+
+Configure Langtrace behavior using these environment variables:
+
+| Variable | Description | Default | Impact |
+|----------|-------------|---------|---------|
+| `LANGTRACE_API_KEY` | Primary authentication method | Required* | Required if not passed to init() |
+| `TRACE_PROMPT_COMPLETION_DATA` | Control prompt/completion tracing | `true` | Set to 'false' to opt out of prompt/completion data collection |
+| `TRACE_DSPY_CHECKPOINT` | Control DSPy checkpoint tracing | `true` | Set to 'false' to disable checkpoint tracing |
+| `LANGTRACE_ERROR_REPORTING` | Control error reporting | `true` | Set to 'false' to disable Sentry error reporting |
+| `LANGTRACE_API_HOST` | Custom API endpoint | `https://langtrace.ai/` | Override default API endpoint for self-hosted deployments |
+
+> **Performance Note**: Setting `TRACE_DSPY_CHECKPOINT=false` is recommended in production environments as checkpoint tracing involves state serialization which can impact latency.
+
+> **Security Note**: When `TRACE_PROMPT_COMPLETION_DATA=false`, no prompt or completion data will be collected, ensuring sensitive information remains private.
+
+## 🔧 Advanced Features
+
+### Root Span Decorator
+
+Use the root span decorator to create custom trace hierarchies:
+
+```python
+from langtrace_python_sdk import langtrace
+
+@langtrace.with_langtrace_root_span(name="custom_operation")
+def my_function():
+    # Your code here
+    pass
+```
+
+### Additional Attributes
+
+Inject custom attributes into your traces:
+
+```python
+# Using decorator
+@langtrace.with_additional_attributes({"custom_key": "custom_value"})
+def my_function():
+    pass
+
+# Using context manager
+with langtrace.inject_additional_attributes({"custom_key": "custom_value"}):
+    # Your code here
+    pass
+```
+
+### Prompt Registry
+
+Register and manage prompts for better traceability:
+
+```python
+from langtrace_python_sdk import langtrace
+
+# Register a prompt template
+langtrace.register_prompt("greeting", "Hello, {name}!")
+
+# Use registered prompt
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": langtrace.get_prompt("greeting", name="Alice")}]
+)
+```
+
+### User Feedback System
+
+Collect and analyze user feedback:
+
+```python
+from langtrace_python_sdk import langtrace
+
+# Record user feedback for a trace
+langtrace.record_feedback(
+    trace_id="your_trace_id",
+    rating=5,
+    feedback_text="Great response!",
+    metadata={"user_id": "123"}
+)
+```
+
+### DSPy Checkpointing
+
+Manage DSPy checkpoints for workflow tracking:
+
+```python
+from langtrace_python_sdk import langtrace
+
+# Enable checkpoint tracing (disabled by default in production)
+langtrace.init(
+    api_key="your_api_key",
+    dspy_checkpoint_tracing=True
+)
+```
+
+### Vector Database Operations
+
+Track vector database operations:
+
+```python
+from langtrace_python_sdk import langtrace
+
+# Vector operations are automatically traced
+with langtrace.inject_additional_attributes({"operation_type": "similarity_search"}):
+    results = vector_db.similarity_search("query", k=5)
+```
+
+For more detailed examples and use cases, visit our [documentation](https://docs.langtrace.ai).
+
+<!-- Will be expanded in step 007 with comprehensive documentation of advanced features -->
+
+## 📐 Examples
+
+<!-- Will be added in step 008: Framework-specific examples and usage patterns -->
+
+## 🏠 Langtrace Self Hosted
+
+<!-- Original self-hosted documentation -->
+Get started with self-hosted Langtrace:
+
+```python
+from langtrace_python_sdk import langtrace
+langtrace.init(write_spans_to_console=True)  # For console logging
+# OR
+langtrace.init(custom_remote_exporter=<your_exporter>, batch=<True or False>)  # For custom exporter
+```
+
+## 🤝 Contributing
+
+We welcome contributions! To get started:
+
+1. Fork this repository and start developing
+2. Join our [Discord](https://discord.langtrace.ai) workspace
+3. Run examples:
+   ```python
+   # In run_example.py, set ENABLED_EXAMPLES flag to True for desired example
+   python src/run_example.py
+   ```
+4. Run tests:
+   ```python
+   pip install '.[test]' && pip install '.[dev]'
+   pytest -v
+   ```
+
+## 🔒 Security
+
+To report security vulnerabilities, email us at <security@scale3labs.com>. You can read more on security [here](https://github.com/Scale3-Labs/langtrace/blob/development/SECURITY.md).
+
+## ❓ Frequently Asked Questions
+
+<!-- Will be populated during content addition steps -->
+
+## 📜 License
+
+Langtrace Python SDK is licensed under the Apache 2.0 License. You can read about this license [here](https://www.apache.org/licenses/LICENSE-2.0).

{langtrace_python_sdk-3.3.6.dist-info → langtrace_python_sdk-3.3.8.dist-info}/RECORD

@@ -105,7 +105,7 @@ examples/weaviate_example/__init__.py,sha256=8JMDBsRSEV10HfTd-YC7xb4txBjD3la56sn
 examples/weaviate_example/query_text.py,sha256=wPHQTc_58kPoKTZMygVjTj-2ZcdrIuaausJfMxNQnQc,127162
 langtrace_python_sdk/__init__.py,sha256=VZM6i71NR7pBQK6XvJWRelknuTYUhqwqE7PlicKa5Wg,1166
 langtrace_python_sdk/langtrace.py,sha256=TtRWuUiWUB0S7JiQpUsF9lZsiyqPG3m9mMDX-QlDgAw,12601
-langtrace_python_sdk/version.py,sha256=GblPlLThspLCrtYLx-68Q7tG3E2pz1nlwTjMxZYJOYo,22
+langtrace_python_sdk/version.py,sha256=pQATGDyqrNBUFj1qQmGoPCfn2udX5OQy6wvCOuVPUfg,22
 langtrace_python_sdk/constants/__init__.py,sha256=3CNYkWMdd1DrkGqzLUgNZXjdAlM6UFMlf_F-odAToyc,146
 langtrace_python_sdk/constants/exporter/langtrace_exporter.py,sha256=d-3Qn5C_NTy1NkmdavZvy-6vePwTC5curN6QMy2haHc,50
 langtrace_python_sdk/constants/instrumentation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -186,7 +186,7 @@ langtrace_python_sdk/instrumentation/llamaindex/instrumentation.py,sha256=8iAg-O
 langtrace_python_sdk/instrumentation/llamaindex/patch.py,sha256=548hzPyT_k-2wmt9AArv4JzTT4j4AGKJq5Ar2bWv7o8,4615
 langtrace_python_sdk/instrumentation/milvus/__init__.py,sha256=gGb0xdMrpX_IEHdTplMt_U5A2IrKRc7lf5VU0WAsgVY,88
 langtrace_python_sdk/instrumentation/milvus/instrumentation.py,sha256=bpf6uRIJ44F1H2ncIgjjrVSwHMs1EiX7kTOy-urMDu0,928
-langtrace_python_sdk/instrumentation/milvus/patch.py,sha256=_sasB17CnBCufxtY3AzeTZFBo3449bn6iHsPmyAire4,4378
+langtrace_python_sdk/instrumentation/milvus/patch.py,sha256=0yY5aQz0x7hpQZ8U-0qfyk_KIizW60s0e2CZrXe3FNk,4729
 langtrace_python_sdk/instrumentation/mistral/__init__.py,sha256=mkGALBQvq0jSfwDl6TU09SFwnVs6O4zkUi-yVmd3SNg,90
 langtrace_python_sdk/instrumentation/mistral/instrumentation.py,sha256=qtCkHCSOaiicUChbmTID4lcK1rbeW8oRSbpda2ogbgM,2328
 langtrace_python_sdk/instrumentation/mistral/patch.py,sha256=1peU0vqt9BGYn2PFNyKAMKNRVMEujXNyZGzgttPJrTQ,6580
@@ -221,7 +221,7 @@ langtrace_python_sdk/utils/prompt_registry.py,sha256=n5dQMVLBw8aJZY8Utvf67bncc25
 langtrace_python_sdk/utils/sdk_version_checker.py,sha256=F-VVVH7Fmhr5LcY0IIe-34zIi5RQcx26uuxFpPzZesM,1782
 langtrace_python_sdk/utils/silently_fail.py,sha256=wzmvRDZppaRZgVP8C1xpq2GlWXYCwubhaeWvEbQP1SI,1196
 langtrace_python_sdk/utils/types.py,sha256=l-N6o7cnWUyrD6dBvW7W3Pf5CkPo5QaoT__k1XLbrQg,383
-langtrace_python_sdk/utils/with_root_span.py,sha256=2iWu8XD1NOFqSFgDZDJiMHZ1JB4HzmYPLr_F3Ugul2k,8480
+langtrace_python_sdk/utils/with_root_span.py,sha256=EW0WQfxESntf23dJt0E0rFdHV-7BRniW1Ce6nrCoEPY,8291
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/conftest.py,sha256=0Jo6iCZTXbdvyJVhG9UpYGkLabL75378oauCzmt-Sa8,603
 tests/utils.py,sha256=8ZBYvxBH6PynipT1sqenfyjTGLhEV7SORQH1NJjnpsM,2500
@@ -264,8 +264,8 @@ tests/pinecone/cassettes/test_query.yaml,sha256=b5v9G3ssUy00oG63PlFUR3JErF2Js-5A
 tests/pinecone/cassettes/test_upsert.yaml,sha256=neWmQ1v3d03V8WoLl8FoFeeCYImb8pxlJBWnFd_lITU,38607
 tests/qdrant/conftest.py,sha256=9n0uHxxIjWk9fbYc4bx-uP8lSAgLBVx-cV9UjnsyCHM,381
 tests/qdrant/test_qdrant.py,sha256=pzjAjVY2kmsmGfrI2Gs2xrolfuaNHz7l1fqGQCjp5_o,3353
-langtrace_python_sdk-3.3.6.dist-info/METADATA,sha256=dXfiYaLZTVt9ZFTeAUyGT__kD6njegfpMoiwoC_0Cig,16005
-langtrace_python_sdk-3.3.6.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-langtrace_python_sdk-3.3.6.dist-info/entry_points.txt,sha256=1_b9-qvf2fE7uQNZcbUei9vLpFZBbbh9LrtGw95ssAo,70
-langtrace_python_sdk-3.3.6.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
-langtrace_python_sdk-3.3.6.dist-info/RECORD,,
+langtrace_python_sdk-3.3.8.dist-info/METADATA,sha256=sfFy68YkEQs8-KFe2u4oLkL7tn1KohguWPdWBzC5uPs,15642
+langtrace_python_sdk-3.3.8.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+langtrace_python_sdk-3.3.8.dist-info/entry_points.txt,sha256=1_b9-qvf2fE7uQNZcbUei9vLpFZBbbh9LrtGw95ssAo,70
+langtrace_python_sdk-3.3.8.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+langtrace_python_sdk-3.3.8.dist-info/RECORD,,

langtrace_python_sdk-3.3.6.dist-info/METADATA

@@ -1,371 +0,0 @@
-Metadata-Version: 2.3
-Name: langtrace-python-sdk
-Version: 3.3.6
-Summary: Python SDK for LangTrace
-Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
-Author-email: Scale3 Labs <engineering@scale3labs.com>
-License: Apache-2.0
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.9
-Requires-Dist: colorama>=0.4.6
-Requires-Dist: fsspec>=2024.6.0
-Requires-Dist: opentelemetry-api>=1.25.0
-Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.25.0
-Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.25.0
-Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.46b0
-Requires-Dist: opentelemetry-instrumentation>=0.47b0
-Requires-Dist: opentelemetry-sdk>=1.25.0
-Requires-Dist: sentry-sdk>=2.14.0
-Requires-Dist: sqlalchemy
-Requires-Dist: tiktoken>=0.1.1
-Requires-Dist: trace-attributes==7.1.0
-Requires-Dist: transformers>=4.11.3
-Requires-Dist: ujson>=5.10.0
-Provides-Extra: dev
-Requires-Dist: anthropic; extra == 'dev'
-Requires-Dist: boto3; extra == 'dev'
-Requires-Dist: chromadb; extra == 'dev'
-Requires-Dist: cohere; extra == 'dev'
-Requires-Dist: embedchain; extra == 'dev'
-Requires-Dist: google-cloud-aiplatform; extra == 'dev'
-Requires-Dist: google-generativeai; extra == 'dev'
-Requires-Dist: groq; extra == 'dev'
-Requires-Dist: langchain; extra == 'dev'
-Requires-Dist: langchain-community; extra == 'dev'
-Requires-Dist: langchain-openai; extra == 'dev'
-Requires-Dist: litellm==1.48.7; extra == 'dev'
-Requires-Dist: mistralai; extra == 'dev'
-Requires-Dist: ollama; extra == 'dev'
-Requires-Dist: openai==1.45.0; extra == 'dev'
-Requires-Dist: pinecone-client; extra == 'dev'
-Requires-Dist: python-dotenv; extra == 'dev'
-Requires-Dist: qdrant-client; extra == 'dev'
-Requires-Dist: setuptools; extra == 'dev'
-Requires-Dist: weaviate-client; extra == 'dev'
-Provides-Extra: test
-Requires-Dist: pytest; extra == 'test'
-Requires-Dist: pytest-asyncio; extra == 'test'
-Requires-Dist: pytest-vcr; extra == 'test'
-Description-Content-Type: text/markdown
-
-# [Langtrace](https://www.langtrace.ai)
-
-## Open Source & Open Telemetry(OTEL) Observability for LLM applications
-
-![Static Badge](https://img.shields.io/badge/License-Apache--2.0-blue) ![Static Badge](https://img.shields.io/badge/npm_@langtrase/typescript--sdk-1.2.9-green) ![Static Badge](https://img.shields.io/badge/pip_langtrace--python--sdk-1.2.8-green) ![Static Badge](https://img.shields.io/badge/Development_status-Active-green)
-
----
-
-Langtrace is an open source observability software which lets you capture, debug and analyze traces and metrics from all your applications that leverages LLM APIs, Vector Databases and LLM based Frameworks.
-
-## Open Telemetry Support
-
-The traces generated by Langtrace adhere to [Open Telemetry Standards(OTEL)](https://opentelemetry.io/docs/concepts/signals/traces/). We are developing [semantic conventions](https://opentelemetry.io/docs/concepts/semantic-conventions/) for the traces generated by this project. You can checkout the current definitions in [this repository](https://github.com/Scale3-Labs/langtrace-trace-attributes/tree/main/schemas). Note: This is an ongoing development and we encourage you to get involved and welcome your feedback.
-
----
-
-## Langtrace Cloud ☁️
-
-To use the managed SaaS version of Langtrace, follow the steps below:
-
-1. Sign up by going to [this link](https://langtrace.ai).
-2. Create a new Project after signing up. Projects are containers for storing traces and metrics generated by your application. If you have only one application, creating 1 project will do.
-3. Generate an API key by going inside the project.
-4. In your application, install the Langtrace SDK and initialize it with the API key you generated in the step 3.
-5. The code for installing and setting up the SDK is shown below
-
-## Getting Started
-
-Get started by adding simply three lines to your code!
-
-```python
-pip install langtrace-python-sdk
-```
-
-```python
-from langtrace_python_sdk import langtrace # Must precede any llm module imports
-langtrace.init(api_key=<your_api_key>)
-```
-
-OR
-
-```python
-from langtrace_python_sdk import langtrace # Must precede any llm module imports
-langtrace.init() # LANGTRACE_API_KEY as an ENVIRONMENT variable
-```
-
-## FastAPI Quick Start
-
-Initialize FastAPI project and add this inside the `main.py` file
-
-```python
-from fastapi import FastAPI
-from langtrace_python_sdk import langtrace
-from openai import OpenAI
-
-langtrace.init()
-app = FastAPI()
-client = OpenAI()
-
-@app.get("/")
-def root():
-    client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return {"Hello": "World"}
-```
-
-## Django Quick Start
-
-Initialize django project and add this inside the `__init.py__` file
-
-```python
-from langtrace_python_sdk import langtrace
-from openai import OpenAI
-
-
-langtrace.init()
-client = OpenAI()
-
-client.chat.completions.create(
-    model="gpt-4",
-    messages=[{"role": "user", "content": "Say this is a test three times"}],
-    stream=False,
-)
-
-```
-
-## Flask Quick Start
-
-Initialize flask project and this inside `app.py` file
-
-```python
-from flask import Flask
-from langtrace_python_sdk import langtrace
-from openai import OpenAI
-
-langtrace.init()
-client = OpenAI()
-app = Flask(__name__)
-
-
-@app.route("/")
-def main():
-    client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return "Hello, World!"
-```
-
-## Langtrace Self Hosted
-
-Get started by adding simply two lines to your code and see traces being logged to the console!
-
-```python
-pip install langtrace-python-sdk
-```
-
-```python
-from langtrace_python_sdk import langtrace # Must precede any llm module imports
-langtrace.init(write_spans_to_console=True)
-```
-
-## Langtrace self hosted custom exporter
-
-Get started by adding simply three lines to your code and see traces being exported to your remote location!
-
-```python
-pip install langtrace-python-sdk
-```
-
-```python
-from langtrace_python_sdk import langtrace # Must precede any llm module imports
-langtrace.init(custom_remote_exporter=<your_exporter>, batch=<True or False>)
-```
-
-### Configure Langtrace
-
-| Parameter                  | Type                                | Default Value                 | Description                                                                                                                       |
-| -------------------------- | ----------------------------------- | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
-| `api_key`                  | `str`                               | `LANGTRACE_API_KEY` or `None` | The API key for authentication.                                                                                                   |
-| `batch`                    | `bool`                              | `True`                        | Whether to batch spans before sending them.                                                                                       |
-| `write_spans_to_console`   | `bool`                              | `False`                       | Whether to write spans to the console.                                                                                            |
-| `custom_remote_exporter`   | `Optional[Exporter]`                | `None`                        | Custom remote exporter. If `None`, a default `LangTraceExporter` will be used.                                                    |
-| `api_host`                 | `Optional[str]`                     | `https://langtrace.ai/`       | The API host for the remote exporter.                                                                                             |
-| `disable_instrumentations` | `Optional[DisableInstrumentations]` | `None`                        | You can pass an object to disable instrumentation for specific vendors ex: `{'only': ['openai']}` or `{'all_except': ['openai']}` |
-
-### Error Reporting to Langtrace
-
-By default all sdk errors are reported to langtrace via Sentry. This can be disabled by setting the following enviroment variable to `False` like so `LANGTRACE_ERROR_REPORTING=False`
-
-### Additional Customization
-
-- `@with_langtrace_root_span` - this decorator is designed to organize and relate different spans, in a hierarchical manner. When you're performing multiple operations that you want to monitor together as a unit, this function helps by establishing a "parent" (`LangtraceRootSpan` or whatever is passed to `name`) span. Then, any calls to the LLM APIs made within the given function (fn) will be considered "children" of this parent span. This setup is especially useful for tracking the performance or behavior of a group of operations collectively, rather than individually.
-
-```python
-from langtrace_python_sdk import with_langtrace_root_span
-
-@with_langtrace_root_span()
-def example():
-    response = client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return response
-```
-
-- `inject_additional_attributes` - this function is designed to enhance the traces by adding custom attributes to the current context. These custom attributes provide extra details about the operations being performed, making it easier to analyze and understand their behavior.
-
-```python
-from langtrace_python_sdk import inject_additional_attributes
-
-
-
-def do_llm_stuff(name=""):
-    response = client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return response
-
-
-def main():
-  response = inject_additional_attributes(lambda: do_llm_stuff(name="llm"), {'user.id': 'userId'})
-
-  # if the function do not take arguments then this syntax will work
-  response = inject_additional_attributes(do_llm_stuff, {'user.id': 'userId'})
-```
-
-- `with_additional_attributes` - is behaving the same as `inject_additional_attributes` but as a decorator, this will be deprecated soon.
-
-```python
-from langtrace_python_sdk import with_langtrace_root_span, with_additional_attributes
-
-
-@with_additional_attributes({"user.id": "1234"})
-def api_call1():
-    response = client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return response
-
-
-@with_additional_attributes({"user.id": "5678"})
-def api_call2():
-    response = client.chat.completions.create(
-        model="gpt-4",
-        messages=[{"role": "user", "content": "Say this is a test three times"}],
-        stream=False,
-    )
-    return response
-
-
-@with_langtrace_root_span()
-def chat_completion():
-   api_call1()
-   api_call2()
-```
-
-- `get_prompt_from_registry` - this function is designed to fetch the desired prompt from the `Prompt Registry`. You can pass two options for filtering `prompt_version` & `variables`.
-
-```python
-from langtrace_python_sdk import get_prompt_from_registry
-
-prompt = get_prompt_from_registry(<Registry ID>, options={"prompt_version": 1, "variables": {"foo": "bar"} })
-```
-
-### Opt out of tracing prompt and completion data
-
-By default, prompt and completion data are captured. If you would like to opt out of it, set the following env var,
-
-`TRACE_PROMPT_COMPLETION_DATA=false`
-
-### Enable/Disable checkpoint tracing for DSPy
-
-By default, checkpoints are traced for DSPy pipelines. If you would like to disable it, set the following env var,
-
-`TRACE_DSPY_CHECKPOINT=false`
-
-Note: Checkpoint tracing will increase the latency of executions as the state is serialized. Please disable it in production.
-
-## Supported integrations
-
-Langtrace automatically captures traces from the following vendors:
-
-| Vendor        | Type            | Typescript SDK     | Python SDK                      |
-| ------------- | --------------- | ------------------ | ------------------------------- |
-| OpenAI        | LLM             | :white_check_mark: | :white_check_mark:              |
-| Anthropic     | LLM             | :white_check_mark: | :white_check_mark:              |
-| Azure OpenAI  | LLM             | :white_check_mark: | :white_check_mark:              |
-| Cohere        | LLM             | :white_check_mark: | :white_check_mark:              |
-| Groq          | LLM             | :x:                | :white_check_mark:              |
-| Perplexity    | LLM             | :white_check_mark: | :white_check_mark:              |
-| Gemini        | LLM             | :x:                | :white_check_mark:              |
-| Mistral       | LLM             | :x:                | :white_check_mark:              |
-| Langchain     | Framework       | :x:                | :white_check_mark:              |
-| Langgraph     | Framework       | :x:                | :white_check_mark:              |
-| LlamaIndex    | Framework       | :white_check_mark: | :white_check_mark:              |
-| AWS Bedrock   | Framework       | :white_check_mark: | :white_check_mark:              |
-| LiteLLM       | Framework       | :x:                | :white_check_mark:              |
-| DSPy          | Framework       | :x:                | :white_check_mark:              |
-| CrewAI        | Framework       | :x:                | :white_check_mark:              |
-| Ollama        | Framework       | :x:                | :white_check_mark:              |
-| VertexAI      | Framework       | :x:                | :white_check_mark:              |
-| Vercel AI SDK | Framework       | :white_check_mark: | :x:                             |
-| EmbedChain    | Framework       | :x:                | :white_check_mark:              |
-| Autogen       | Framework       | :x:                | :white_check_mark:              |
-| Pinecone      | Vector Database | :white_check_mark: | :white_check_mark:              |
-| ChromaDB      | Vector Database | :white_check_mark: | :white_check_mark:              |
-| QDrant        | Vector Database | :white_check_mark: | :white_check_mark:              |
-| Weaviate      | Vector Database | :white_check_mark: | :white_check_mark:              |
-| PGVector      | Vector Database | :white_check_mark: | :white_check_mark: (SQLAlchemy) |
-
----
-
-## Feature Requests and Issues
-
-- To request for features, head over [here to start a discussion](https://github.com/Scale3-Labs/langtrace/discussions/categories/feature-requests).
-- To raise an issue, head over [here and create an issue](https://github.com/Scale3-Labs/langtrace/issues).
-
----
-
-## Contributions
-
-We welcome contributions to this project. To get started, fork this repository and start developing. To get involved, join our [Discord](https://discord.langtrace.ai) workspace.
-
-- If you want to run any of the examples go to `run_example.py` file, you will find `ENABLED_EXAMPLES`. choose the example you want to run and just toggle the flag to `True` and run the file using `python src/run_example.py`
-
-- If you want to run tests, make sure to install dev & test dependencies:
-
-  ```python
-  pip install '.[test]' && pip install '.[dev]'
-  ```
-
-  then run `pytest` using:
-
-  ```python
-  pytest -v
-  ```
-
----
-
-## Security
-
-To report security vulnerabilites, email us at <security@scale3labs.com>. You can read more on security [here](https://github.com/Scale3-Labs/langtrace/blob/development/SECURITY.md).
-
----
-
-## License
-
-- Langtrace application is [licensed](https://github.com/Scale3-Labs/langtrace/blob/development/LICENSE) under the AGPL 3.0 License. You can read about this license [here](https://www.gnu.org/licenses/agpl-3.0.en.html).
-- Langtrace SDKs are licensed under the Apache 2.0 License. You can read about this license [here](https://www.apache.org/licenses/LICENSE-2.0).