langtrace-python-sdk 1.2.9__py3-none-any.whl → 1.2.11__py3-none-any.whl

langtrace_python_sdk/constants/exporter/langtrace_exporter.py

@@ -1 +1 @@
-LANGTRACE_REMOTE_URL = "https://app.langtrace.ai/api/trace"
+LANGTRACE_REMOTE_URL = "https://langtrace.ai/api/trace"

langtrace_python_sdk/version.py

@@ -1 +1 @@
-__version__ = "1.2.9"
+__version__ = "1.2.11"

langtrace_python_sdk-1.2.11.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.3
+Name: langtrace-python-sdk
+Version: 1.2.11
+Summary: Python SDK for LangTrace
+Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
+Author-email: Scale3 Labs <engineering@scale3labs.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Requires-Dist: opentelemetry-api
+Requires-Dist: opentelemetry-instrumentation
+Requires-Dist: opentelemetry-sdk
+Requires-Dist: pinecone-client
+Requires-Dist: tiktoken
+Requires-Dist: trace-attributes
+Provides-Extra: dev
+Requires-Dist: anthropic; extra == 'dev'
+Requires-Dist: chromadb; extra == 'dev'
+Requires-Dist: langchain; 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'
+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-AGPL--3.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
+```
+
+## 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_to_langtrace_cloud=False, batch=False)
+```
+
+## 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>)
+```
+
+### 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.utils.with_root_span 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
+```
+
+
+- `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
+from langtrace_python_sdk.utils.with_root_span import (
+    with_langtrace_root_span,
+    with_additional_attributes,
+)
+
+@with_additional_attributes({"user.id": "1234", "user.feedback.rating": 1})
+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", "user.feedback.rating": -1})
+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()
+```
+
+## 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: |
+| Langchain | Framework | :x: | :white_check_mark: |
+| LlamaIndex | Framework | :white_check_mark: | :white_check_mark: |
+| Pinecone | Vector Database | :white_check_mark: | :white_check_mark: |
+| ChromaDB | Vector Database | :white_check_mark: | :white_check_mark: |
+
+---
+
+## 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 Slack workspace.
+
+---
+
+## 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(this repository) 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).

{langtrace_python_sdk-1.2.9.dist-info → langtrace_python_sdk-1.2.11.dist-info}/RECORD

@@ -18,9 +18,9 @@ examples/pinecone_example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 examples/pinecone_example/basic.py,sha256=hdV6-5Fmol9zeyFzDtdabD62vkqUJ4lCHG2YcVNpIpI,933
 langtrace_python_sdk/__init__.py,sha256=SlHg447-nQBbw8exRNJP_OyHUZ39Sldb7aaQ35hIRm8,262
 langtrace_python_sdk/langtrace.py,sha256=sWC7WqbOdOUB1sZ_hzLZVp0_Q8fBTRJRMUvOPyO6f20,3170
-langtrace_python_sdk/version.py,sha256=Oh3Y6CIypkhAjW-aquBTyP3_cA-gKgKTwq9EpcWpjps,22
+langtrace_python_sdk/version.py,sha256=aBWZsCYiXXcSUsUJr3tOTQWsH7ZDqJzyMYdQbOd5Qtc,23
 langtrace_python_sdk/constants/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langtrace_python_sdk/constants/exporter/langtrace_exporter.py,sha256=qicGmyWf0aCb9ki2wmkHOv8rb7TF5o61_rJhjrbHJzs,60
+langtrace_python_sdk/constants/exporter/langtrace_exporter.py,sha256=OfgvphRBPENwsAizqzka9lFu9aDw-A7ErYJ0atl3bpI,56
 langtrace_python_sdk/constants/instrumentation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langtrace_python_sdk/constants/instrumentation/anthropic.py,sha256=YX3llt3zwDY6XrYk3CB8WEVqgrzRXEw_ffyk56JoF3k,126
 langtrace_python_sdk/constants/instrumentation/chroma.py,sha256=hiPGYdHS0Yj4Kh3eaYBbuCAl_swqIygu80yFqkOgdak,955
@@ -57,7 +57,7 @@ langtrace_python_sdk/instrumentation/pinecone/patch.py,sha256=lvWL_xM7mxTQ1D-eY5
 langtrace_python_sdk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 langtrace_python_sdk/utils/llm.py,sha256=4z2e-md_ELXCEuOIRVWracR6qH2pmsOxCqpkuF9_3Nw,1589
 langtrace_python_sdk/utils/with_root_span.py,sha256=N7ONrcF0myZbHBy5gpQffDbX-Kf63Crsz9szG0i3m08,1889
-langtrace_python_sdk-1.2.9.dist-info/METADATA,sha256=7GGOwhP1JxHec8hQl-Mte5gq2nacyflwXFKIsAh1Q9s,4727
-langtrace_python_sdk-1.2.9.dist-info/WHEEL,sha256=uNdcs2TADwSd5pVaP0Z_kcjcvvTUklh2S7bxZMF8Uj0,87
-langtrace_python_sdk-1.2.9.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
-langtrace_python_sdk-1.2.9.dist-info/RECORD,,
+langtrace_python_sdk-1.2.11.dist-info/METADATA,sha256=8uVY2vORbVzc3bYx29FnJTZmUW9GUYfdymEsvbbqX44,7661
+langtrace_python_sdk-1.2.11.dist-info/WHEEL,sha256=uNdcs2TADwSd5pVaP0Z_kcjcvvTUklh2S7bxZMF8Uj0,87
+langtrace_python_sdk-1.2.11.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+langtrace_python_sdk-1.2.11.dist-info/RECORD,,

langtrace_python_sdk-1.2.9.dist-info/METADATA

@@ -1,130 +0,0 @@
-Metadata-Version: 2.3
-Name: langtrace-python-sdk
-Version: 1.2.9
-Summary: Python SDK for LangTrace
-Project-URL: Homepage, https://github.com/Scale3-Labs/langtrace-python-sdk
-Author-email: Scale3 Labs <engineering@scale3labs.com>
-License-Expression: Apache-2.0
-License-File: LICENSE
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.9
-Requires-Dist: opentelemetry-api
-Requires-Dist: opentelemetry-instrumentation
-Requires-Dist: opentelemetry-sdk
-Requires-Dist: pinecone-client
-Requires-Dist: tiktoken
-Requires-Dist: trace-attributes
-Provides-Extra: dev
-Requires-Dist: anthropic; extra == 'dev'
-Requires-Dist: chromadb; extra == 'dev'
-Requires-Dist: langchain; 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'
-Description-Content-Type: text/markdown
-
-# What is Langtrace?
-
-Langtrace stands as a developer-centric, open-source solution, fully compatible with OpenTelemetry. It enables developers to effortlessly trace, monitor, and debug their LLM applications, offering robust support for automatic instrumentation.
-
-## Supported LLM Modules
-
-Langtrace supports a comprehensive range of LLMs, VectorDBs, and frameworks, ensuring wide coverage for your development needs:
-
-### LLMs
-
-1. OpenAI
-2. Anthropic
-3. Azure OpenAI
-
-### VectorDBs
-
-1. Pinecone
-2. Chromadb
-
-### Frameworks
-
-1. LangChain
-2. LlamaIndex
-3. Haystack
-
-We are actively working to extend our support to additional libraries!
-
-## Getting Started
-
-To begin utilizing Langtrace, follow these straightforward steps:
-
-1. Install the package using `pip install langtrace-python-sdk`.
-2. Incorporate Langtrace into your project with `from langtrace_python_sdk import langtrace`.
-   - This import should precede any other LLM module imports (such as OpenAI, LlamaIndex, etc.) to ensure proper functionality.
-3. Initialize Langtrace by adding `langtrace.init(write_to_langtrace_cloud=false)` to your code.
-4. Congratulations, you've completed the basic setup! You will now begin to see traces from your LLM modules logged directly to the console.
-
-
-## Exporting Traces to Langtrace
-
-To configure trace exporting, you have two options:
-
-You'll need a Langtrace `api_key`, which can be acquired by logging into your Langtrace account.
-
-1. Direct Initialization: Utilize `langtrace.init(api_key=<YOUR_API_KEY>)`.
-2. Environment Variables: Set `LANGTRACE_API_KEY`, then add `langtrace.init()` at the beginning of your file.
-
-### 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.utils.with_root_span 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
-```
-
-
-- `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
-from langtrace_python_sdk.utils.with_root_span import (
-    with_langtrace_root_span,
-    with_additional_attributes,
-)
-
-@with_additional_attributes({"user.id": "1234", "user.feedback.rating": 1})
-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", "user.feedback.rating": -1})
-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()
-```
-
-## Langtrace Cloud
-
-Currently under development 🚧