langfuse-prompt-library-iauro 0.1.0__tar.gz

langfuse_prompt_library_iauro-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 [Vaibhav Hopal/iauro Systems Pvt Ltd]
+
+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.

langfuse_prompt_library_iauro-0.1.0/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: langfuse-prompt-library-iauro
+Version: 0.1.0
+Summary: A production-ready wrapper for Langfuse prompts and tracing with LLM integrations
+Author-email: Sunny Mane <sunny.mane@iauro.com>
+Maintainer-email: Vaibhav Hopal <vaibhav.hopal@iauro.com>
+License: MIT
+Project-URL: Homepage, https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library
+Project-URL: Documentation, https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library#readme
+Project-URL: Repository, https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library
+Project-URL: Issues, https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library/issues
+Keywords: langfuse,llm,openai,anthropic,prompt-management,tracing,observability,langchain
+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: langfuse>=3.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Dynamic: license-file
+
+# Langfuse Prompt Library
+
+A production-ready Python wrapper for [Langfuse](https://langfuse.com/) prompts and tracing with integrated LLM support (OpenAI, Anthropic).
+
+## Features
+
+- **Prompt Management**: Fetch and manage prompts from Langfuse with built-in caching
+- **Multi-Provider Support**: Works with OpenAI (GPT models) and Anthropic (Claude models)
+- **Automatic Tracing**: Built-in observability and tracing for all LLM calls
+- **Token Tracking**: Automatic token usage tracking and reporting
+- **Retry Logic**: Configurable retry mechanism with exponential backoff
+- **Type Safety**: Full type hints and validation
+- **Thread-Safe Caching**: Efficient prompt caching with TTL support
+- **Error Handling**: Comprehensive error handling and custom exceptions
+- **Production Ready**: Designed for enterprise use with logging, metrics, and cleanup handlers
+
+## Installation
+
+```bash
+pip install langfuse-prompt-library-iauro
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from langfuse_prompt_library import LangfuseManager
+
+# Initialize manager (loads from environment variables)
+lf = LangfuseManager()
+
+# Call LLM with a prompt
+response = lf.call_llm(
+    prompt_name="customer_support_agent",
+    user_input="How do I reset my password?",
+    prompt_label="production",
+    model="gpt-3.5-turbo"
+)
+```
+
+### Using Claude (Anthropic)
+
+```python
+# Claude models are auto-detected
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Explain quantum computing",
+    model="claude-sonnet-4",
+    temperature=0.7
+)
+```
+
+### Advanced Usage
+
+```python
+from langfuse_prompt_library import LangfuseManager, LangfuseConfig
+
+# Custom configuration
+config = LangfuseConfig(
+    secret_key="your-secret-key",
+    public_key="your-public-key",
+    host="https://cloud.langfuse.com",
+    openai_api_key="your-openai-key",
+    enable_caching=True,
+    cache_ttl=3600,
+    request_timeout=60.0
+)
+
+lf = LangfuseManager(config=config)
+
+# Fetch prompt manually
+prompt = lf.get_prompt("my_prompt", label="production")
+messages = lf.compile_prompt(prompt, user_input="Hello")
+
+# Get cache statistics
+stats = lf.get_cache_stats()
+
+# Flush traces before shutdown
+lf.flush()
+```
+
+## Configuration
+
+Set these environment variables or pass them via `LangfuseConfig`:
+
+```bash
+# Required
+LANGFUSE_SECRET_KEY=your-secret-key
+LANGFUSE_PUBLIC_KEY=your-public-key
+
+# Optional
+LANGFUSE_HOST=https://cloud.langfuse.com
+OPENAI_API_KEY=your-openai-key
+ANTHROPIC_API_KEY=your-anthropic-key
+
+# Advanced options
+LANGFUSE_ENABLE_CACHING=true
+LANGFUSE_CACHE_TTL=3600
+LANGFUSE_REQUEST_TIMEOUT=60.0
+LANGFUSE_DEBUG=false
+LANGFUSE_LOG_LEVEL=INFO
+```
+
+## API Reference
+
+### LangfuseManager
+
+Main entry point for the library.
+
+#### Methods
+
+- `call_llm(prompt_name, user_input, ...)` - High-level method to fetch prompt and call LLM
+- `get_prompt(name, version, label, cache)` - Fetch a prompt from Langfuse
+- `compile_prompt(prompt, **variables)` - Compile prompt with variables
+- `flush()` - Flush pending traces to Langfuse
+- `get_cache_stats()` - Get cache statistics
+- `clear_cache()` - Clear the prompt cache
+
+### LLMResponse
+
+Response object containing:
+- `content` - The generated text
+- `model` - Model used
+- `usage` - Token usage dict with 'input', 'output', 'total'
+- `metadata` - Additional metadata
+- `raw_response` - Raw API response
+
+### Exceptions
+
+- `LangfuseLibraryError` - Base exception
+- `ConfigurationError` - Configuration issues
+- `PromptNotFoundError` - Prompt not found
+- `ProviderError` - LLM provider errors
+- `APITimeoutError` - API timeout
+- `RateLimitError` - Rate limit exceeded
+- `ValidationError` - Input validation failed
+
+## Examples
+
+### Error Handling
+
+```python
+from langfuse_prompt_library import (
+    LangfuseManager,
+    PromptNotFoundError,
+    ProviderError
+)
+
+lf = LangfuseManager()
+
+try:
+    response = lf.call_llm(
+        prompt_name="nonexistent_prompt",
+        user_input="Hello"
+    )
+except PromptNotFoundError as e:
+    print(f"Prompt not found: {e}")
+except ProviderError as e:
+    print(f"Provider error: {e}")
+```
+
+### Specific Prompt Version
+
+```python
+# Use specific version
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Hello",
+    prompt_version=5
+)
+
+# Or use label
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Hello",
+    prompt_label="production"
+)
+```
+
+## Requirements
+
+- Python >= 3.8
+- langfuse >= 3.0.0
+- openai >= 1.0.0
+- python-dotenv >= 1.0.0
+- anthropic >= 0.18.0 (optional)
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Support
+
+For issues and questions:
+- GitHub Issues: https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library/issues
+- Langfuse Documentation: https://langfuse.com/docs
+
+## Changelog
+
+### 0.1.0
+- Initial public release
+- Support for OpenAI and Anthropic
+- Automatic tracing and observability
+- Thread-safe caching
+- Comprehensive error handling

langfuse_prompt_library_iauro-0.1.0/README.md

@@ -0,0 +1,210 @@
+# Langfuse Prompt Library
+
+A production-ready Python wrapper for [Langfuse](https://langfuse.com/) prompts and tracing with integrated LLM support (OpenAI, Anthropic).
+
+## Features
+
+- **Prompt Management**: Fetch and manage prompts from Langfuse with built-in caching
+- **Multi-Provider Support**: Works with OpenAI (GPT models) and Anthropic (Claude models)
+- **Automatic Tracing**: Built-in observability and tracing for all LLM calls
+- **Token Tracking**: Automatic token usage tracking and reporting
+- **Retry Logic**: Configurable retry mechanism with exponential backoff
+- **Type Safety**: Full type hints and validation
+- **Thread-Safe Caching**: Efficient prompt caching with TTL support
+- **Error Handling**: Comprehensive error handling and custom exceptions
+- **Production Ready**: Designed for enterprise use with logging, metrics, and cleanup handlers
+
+## Installation
+
+```bash
+pip install langfuse-prompt-library-iauro
+```
+
+## Quick Start
+
+### Basic Usage
+
+```python
+from langfuse_prompt_library import LangfuseManager
+
+# Initialize manager (loads from environment variables)
+lf = LangfuseManager()
+
+# Call LLM with a prompt
+response = lf.call_llm(
+    prompt_name="customer_support_agent",
+    user_input="How do I reset my password?",
+    prompt_label="production",
+    model="gpt-3.5-turbo"
+)
+```
+
+### Using Claude (Anthropic)
+
+```python
+# Claude models are auto-detected
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Explain quantum computing",
+    model="claude-sonnet-4",
+    temperature=0.7
+)
+```
+
+### Advanced Usage
+
+```python
+from langfuse_prompt_library import LangfuseManager, LangfuseConfig
+
+# Custom configuration
+config = LangfuseConfig(
+    secret_key="your-secret-key",
+    public_key="your-public-key",
+    host="https://cloud.langfuse.com",
+    openai_api_key="your-openai-key",
+    enable_caching=True,
+    cache_ttl=3600,
+    request_timeout=60.0
+)
+
+lf = LangfuseManager(config=config)
+
+# Fetch prompt manually
+prompt = lf.get_prompt("my_prompt", label="production")
+messages = lf.compile_prompt(prompt, user_input="Hello")
+
+# Get cache statistics
+stats = lf.get_cache_stats()
+
+# Flush traces before shutdown
+lf.flush()
+```
+
+## Configuration
+
+Set these environment variables or pass them via `LangfuseConfig`:
+
+```bash
+# Required
+LANGFUSE_SECRET_KEY=your-secret-key
+LANGFUSE_PUBLIC_KEY=your-public-key
+
+# Optional
+LANGFUSE_HOST=https://cloud.langfuse.com
+OPENAI_API_KEY=your-openai-key
+ANTHROPIC_API_KEY=your-anthropic-key
+
+# Advanced options
+LANGFUSE_ENABLE_CACHING=true
+LANGFUSE_CACHE_TTL=3600
+LANGFUSE_REQUEST_TIMEOUT=60.0
+LANGFUSE_DEBUG=false
+LANGFUSE_LOG_LEVEL=INFO
+```
+
+## API Reference
+
+### LangfuseManager
+
+Main entry point for the library.
+
+#### Methods
+
+- `call_llm(prompt_name, user_input, ...)` - High-level method to fetch prompt and call LLM
+- `get_prompt(name, version, label, cache)` - Fetch a prompt from Langfuse
+- `compile_prompt(prompt, **variables)` - Compile prompt with variables
+- `flush()` - Flush pending traces to Langfuse
+- `get_cache_stats()` - Get cache statistics
+- `clear_cache()` - Clear the prompt cache
+
+### LLMResponse
+
+Response object containing:
+- `content` - The generated text
+- `model` - Model used
+- `usage` - Token usage dict with 'input', 'output', 'total'
+- `metadata` - Additional metadata
+- `raw_response` - Raw API response
+
+### Exceptions
+
+- `LangfuseLibraryError` - Base exception
+- `ConfigurationError` - Configuration issues
+- `PromptNotFoundError` - Prompt not found
+- `ProviderError` - LLM provider errors
+- `APITimeoutError` - API timeout
+- `RateLimitError` - Rate limit exceeded
+- `ValidationError` - Input validation failed
+
+## Examples
+
+### Error Handling
+
+```python
+from langfuse_prompt_library import (
+    LangfuseManager,
+    PromptNotFoundError,
+    ProviderError
+)
+
+lf = LangfuseManager()
+
+try:
+    response = lf.call_llm(
+        prompt_name="nonexistent_prompt",
+        user_input="Hello"
+    )
+except PromptNotFoundError as e:
+    print(f"Prompt not found: {e}")
+except ProviderError as e:
+    print(f"Provider error: {e}")
+```
+
+### Specific Prompt Version
+
+```python
+# Use specific version
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Hello",
+    prompt_version=5
+)
+
+# Or use label
+response = lf.call_llm(
+    prompt_name="assistant",
+    user_input="Hello",
+    prompt_label="production"
+)
+```
+
+## Requirements
+
+- Python >= 3.8
+- langfuse >= 3.0.0
+- openai >= 1.0.0
+- python-dotenv >= 1.0.0
+- anthropic >= 0.18.0 (optional)
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Support
+
+For issues and questions:
+- GitHub Issues: https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library/issues
+- Langfuse Documentation: https://langfuse.com/docs
+
+## Changelog
+
+### 0.1.0
+- Initial public release
+- Support for OpenAI and Anthropic
+- Automatic tracing and observability
+- Thread-safe caching
+- Comprehensive error handling

langfuse_prompt_library_iauro-0.1.0/pyproject.toml

@@ -0,0 +1,89 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "langfuse-prompt-library-iauro"
+version = "0.1.0"
+description = "A production-ready wrapper for Langfuse prompts and tracing with LLM integrations"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Sunny Mane", email = "sunny.mane@iauro.com"}
+]
+maintainers = [
+    {name = "Vaibhav Hopal", email = "vaibhav.hopal@iauro.com"}
+]
+keywords = [
+    "langfuse",
+    "llm",
+    "openai",
+    "anthropic",
+    "prompt-management",
+    "tracing",
+    "observability",
+    "langchain"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    "langfuse>=3.0.0",
+    "openai>=1.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+anthropic = [
+    "anthropic>=0.18.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "isort>=5.12.0",
+]
+all = [
+    "anthropic>=0.18.0",
+]
+
+[project.urls]
+Homepage = "https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library"
+Documentation = "https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library#readme"
+Repository = "https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library"
+Issues = "https://gitlab.iauro.co/hpe/backend/langfuse-prompt-library/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["langfuse_prompt_library", "utils"]
+
+[tool.setuptools.package-data]
+langfuse_prompt_library = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false

langfuse_prompt_library_iauro-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

langfuse_prompt_library_iauro-0.1.0/src/langfuse_prompt_library/__init__.py

@@ -0,0 +1,54 @@
+"""
+Langfuse Library - A production-ready wrapper for Langfuse prompts and tracing.
+
+This library provides a robust, enterprise-grade interface for:
+- Fetching and managing prompts from Langfuse with caching
+- Calling LLMs with automatic tracing and retry logic
+- Token tracking and observability
+- Error handling and validation
+- Performance metrics
+
+Example:
+    >>> from langfuse_prompt_library import LangfuseManager
+    >>>
+    >>> lf = LangfuseManager()
+    >>> response = lf.call_llm(
+    ...     prompt_name="customer_support_agent",
+    ...     user_input="How do I reset my password?",
+    ...     prompt_label="production"
+    ... )
+    >>> print(response.content)
+"""
+
+from .manager import LangfuseManager
+from .models import LLMResponse
+from .config import LangfuseConfig
+from utils.logger import get_logger
+from .exceptions import (
+    LangfuseLibraryError,
+    ConfigurationError,
+    PromptNotFoundError,
+    ProviderError,
+    APITimeoutError,
+    RateLimitError,
+    CacheError,
+    ValidationError,
+    TracingError
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    "LangfuseManager",
+    "LLMResponse",
+    "LangfuseConfig",
+    "get_logger",
+    "LangfuseLibraryError",
+    "ConfigurationError",
+    "PromptNotFoundError",
+    "ProviderError",
+    "APITimeoutError",
+    "RateLimitError",
+    "CacheError",
+    "ValidationError",
+    "TracingError"
+]