langtrace-python-sdk 2.0.12__tar.gz → 2.1.0__tar.gz

{langtrace_python_sdk-2.0.12 → langtrace_python_sdk-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: langtrace-python-sdk
-Version: 2.0.12
+Version: 2.1.0
 Summary: Python SDK for LangTrace
 Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
 Author-email: Scale3 Labs <engineering@scale3labs.com>
@@ -17,7 +17,8 @@ Requires-Dist: opentelemetry-instrumentation
 Requires-Dist: opentelemetry-sdk
 Requires-Dist: pinecone-client
 Requires-Dist: tiktoken
-Requires-Dist: trace-attributes>=3.0.5
+Requires-Dist: trace-attributes>=4.0.2
+Requires-Dist: weaviate-client
 Provides-Extra: dev
 Requires-Dist: anthropic; extra == 'dev'
 Requires-Dist: chromadb; extra == 'dev'
@@ -25,10 +26,10 @@ Requires-Dist: cohere; extra == 'dev'
 Requires-Dist: langchain; extra == 'dev'
 Requires-Dist: langchain-community; extra == 'dev'
 Requires-Dist: langchain-openai; extra == 'dev'
-Requires-Dist: llama-index; extra == 'dev'
 Requires-Dist: openai; extra == 'dev'
 Requires-Dist: python-dotenv; extra == 'dev'
 Requires-Dist: qdrant-client; extra == 'dev'
+Requires-Dist: weaviate-client; extra == 'dev'
 Provides-Extra: test
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: pytest-asyncio; extra == 'test'
@@ -65,24 +66,25 @@ To use the managed SaaS version of Langtrace, follow the steps below:
 
 Get started by adding simply three lines to your code!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```python
 from langtrace_python_sdk import langtrace # Must precede any llm module imports
 langtrace.init(api_key=<your_api_key>)
 ```
 
 OR
 
-``` python
+```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
+
+Initialize FastAPI project and add this inside the `main.py` file
 
 ```python
 from fastapi import FastAPI
@@ -104,7 +106,9 @@ def root():
 ```
 
 ## Django Quick Start
-Initialize django project and add this inside the ```__init.py__``` file
+
+Initialize django project and add this inside the `__init.py__` file
+
 ```python
 from langtrace_python_sdk import langtrace
 from openai import OpenAI
@@ -122,7 +126,9 @@ client.chat.completions.create(
 ```
 
 ## Flask Quick Start
-Initialize flask project and this inside ```app.py``` file
+
+Initialize flask project and this inside `app.py` file
+
 ```python
 from flask import Flask
 from langtrace_python_sdk import langtrace
@@ -147,11 +153,11 @@ def main():
 
 Get started by adding simply two lines to your code and see traces being logged to the console!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```python
 from langtrace_python_sdk import langtrace # Must precede any llm module imports
 langtrace.init(write_spans_to_console=True)
 ```
@@ -160,15 +166,26 @@ langtrace.init(write_spans_to_console=True)
 
 Get started by adding simply three lines to your code and see traces being exported to your remote location!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```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']}`
+
 ### 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.
@@ -186,7 +203,6 @@ def example():
     return response
 ```
 
-
 - `with_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
@@ -223,7 +239,6 @@ def chat_completion():
 
 - `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
 

{langtrace_python_sdk-2.0.12 → langtrace_python_sdk-2.1.0}/README.md

@@ -28,24 +28,25 @@ To use the managed SaaS version of Langtrace, follow the steps below:
 
 Get started by adding simply three lines to your code!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```python
 from langtrace_python_sdk import langtrace # Must precede any llm module imports
 langtrace.init(api_key=<your_api_key>)
 ```
 
 OR
 
-``` python
+```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
+
+Initialize FastAPI project and add this inside the `main.py` file
 
 ```python
 from fastapi import FastAPI
@@ -67,7 +68,9 @@ def root():
 ```
 
 ## Django Quick Start
-Initialize django project and add this inside the ```__init.py__``` file
+
+Initialize django project and add this inside the `__init.py__` file
+
 ```python
 from langtrace_python_sdk import langtrace
 from openai import OpenAI
@@ -85,7 +88,9 @@ client.chat.completions.create(
 ```
 
 ## Flask Quick Start
-Initialize flask project and this inside ```app.py``` file
+
+Initialize flask project and this inside `app.py` file
+
 ```python
 from flask import Flask
 from langtrace_python_sdk import langtrace
@@ -110,11 +115,11 @@ def main():
 
 Get started by adding simply two lines to your code and see traces being logged to the console!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```python
 from langtrace_python_sdk import langtrace # Must precede any llm module imports
 langtrace.init(write_spans_to_console=True)
 ```
@@ -123,15 +128,26 @@ langtrace.init(write_spans_to_console=True)
 
 Get started by adding simply three lines to your code and see traces being exported to your remote location!
 
-``` python
+```python
 pip install langtrace-python-sdk
 ```
 
-``` python
+```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']}`
+
 ### 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.
@@ -149,7 +165,6 @@ def example():
     return response
 ```
 
-
 - `with_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
@@ -186,7 +201,6 @@ def chat_completion():
 
 - `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
 

{langtrace_python_sdk-2.0.12 → langtrace_python_sdk-2.1.0}/pyproject.toml

@@ -18,15 +18,15 @@ classifiers=[
     "Operating System :: OS Independent",
 ]
 dependencies = [
-  'trace-attributes>=3.0.5',
+  'trace-attributes>=4.0.2',
   'opentelemetry-api',
   'opentelemetry-sdk',
   'opentelemetry-instrumentation',
   'pinecone-client',
   'tiktoken',
   'opentelemetry-exporter-otlp-proto-http>=1.24.0',
-  'opentelemetry-exporter-otlp-proto-grpc>=1.24.0'
-
+  'opentelemetry-exporter-otlp-proto-grpc>=1.24.0',
+  'weaviate-client',
 ]
 
 requires-python = ">=3.9"
@@ -35,15 +35,17 @@ requires-python = ">=3.9"
 dev = [
     "openai",
     "anthropic",
+    "chromadb",
+    'qdrant-client',
     "python-dotenv",
     "langchain",
     'langchain-community',
     "langchain-openai",
-    "llama-index",
     "langchain-openai",
     "chromadb",
     "cohere",
-    'qdrant-client'
+    "qdrant_client",
+    "weaviate-client",
 ]
 
 test = [

{langtrace_python_sdk-2.0.12 → langtrace_python_sdk-2.1.0}/src/examples/pinecone_example/basic.py

@@ -7,7 +7,8 @@ from dotenv import find_dotenv, load_dotenv
 from openai import OpenAI
 from pinecone import Pinecone
 
-from langtrace_python_sdk.utils.with_root_span import with_langtrace_root_span
+
+from langtrace_python_sdk import with_langtrace_root_span, send_user_feedback
 
 _ = load_dotenv(find_dotenv())
 
@@ -18,7 +19,8 @@ pinecone = Pinecone()
 
 
 @with_langtrace_root_span()
-def basic():
+def basic(span_id, trace_id):
+
     result = client.embeddings.create(
         model="text-embedding-ada-002",
         input="Some random text string goes here",
@@ -37,4 +39,7 @@ def basic():
     resp = index.query(
         vector=embedding, top_k=1, include_values=False, namespace="test-namespace"
     )
+    send_user_feedback(
+        {"spanId": span_id, "traceId": trace_id, "userScore": 1, "userId": "123"}
+    )
     print(resp)