genai-otel-instrument 0.1.9.dev0__tar.gz → 0.1.12.dev0__tar.gz

{genai_otel_instrument-0.1.9.dev0 → genai_otel_instrument-0.1.12.dev0}/CHANGELOG.md

@@ -6,7 +6,84 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.1.8] - 2025-01-27
+## [0.1.11] - 2025-10-29
+
+### Added
+
+- **Enhanced README Documentation**
+  - Added professional project logo centered at the top of README
+  - Added landing page hero image showcasing the project overview
+  - Added comprehensive Screenshots section with 5 embedded demonstration images:
+    - OpenAI instrumentation with token usage, costs, and latency metrics
+    - Ollama (local LLM) zero-code instrumentation
+    - HuggingFace Transformers with automatic token counting
+    - SmolAgents framework with complete agent workflow tracing
+    - GPU metrics collection dashboard
+  - Added links to additional screenshots (Token Cost Breakdown, OpenSearch Dashboard)
+  - Added Demo Video section with placeholder for future video content
+  - All images follow OSS documentation standards with professional formatting
+
+### Changed
+
+- **Roadmap Section Cleanup**
+  - Removed Phase 4 implementation details from roadmap (Session & User Tracking, RAG/Embedding Attributes)
+  - Phase 4 features are now fully implemented and documented in the Advanced Features section
+  - Roadmap now focuses exclusively on future releases (v0.2.0 onwards)
+
+### Improved
+
+- **Comprehensive Model Pricing Database Update**
+  - Expanded pricing coverage from 145+ to 240+ models across 15+ providers
+  - **OpenAI GPT-5 Series** (4 new models):
+    - `gpt-5` - $1.25/$10 per 1M tokens
+    - `gpt-5-2025-08-07` - $1.25/$10 per 1M tokens
+    - `gpt-5-mini` - $0.25/$2 per 1M tokens
+    - `gpt-5-nano` - $0.10/$0.40 per 1M tokens
+  - **Anthropic Claude 4/3.5 Variants** (13 new models):
+    - Claude 4 Opus series: `claude-4-opus`, `claude-opus-4`, `claude-opus-4-1`, `claude-opus-4.1` - $15/$75 per 1M tokens
+    - Claude 3.5 Sonnet: `claude-3-5-sonnet-20240620`, `claude-3-5-sonnet-20241022`, `claude-sonnet-4-5`, `claude-sonnet-4-5-20250929`, `claude-3-7-sonnet` - $3/$15 per 1M tokens
+    - Claude 3.5 Haiku: `claude-3-5-haiku-20241022` - $0.80/$4 per 1M tokens
+    - Claude Haiku 4.5: `claude-haiku-4-5` - $1/$5 per 1M tokens
+  - **XAI Grok Models** (10 new models):
+    - Grok 2: `grok-2-1212`, `grok-2-vision-1212` - $2/$10 per 1M tokens
+    - Grok 3: `grok-3` - $3/$15 per 1M tokens, `grok-3-mini` - $0.30/$0.50 per 1M tokens
+    - Grok 3 Fast: `grok-3-fast` - $5/$25 per 1M tokens, `grok-3-mini-fast` - $0.60/$4 per 1M tokens
+    - Grok 4: `grok-4` - $3/$15 per 1M tokens, `grok-4-fast` - $0.20/$0.50 per 1M tokens
+    - Image models: `grok-image`, `xai-grok-image` - $0.07 per image
+  - **Google Gemini Variants** (2 new models):
+    - `gemini-2-5-flash-image` - $0.30/$30 per 1M tokens
+    - `nano-banana` - $0.30/$30 per 1M tokens
+  - **Qwen Series** (6 new models):
+    - `qwen3-next-80b-a3b-instruct` - $0.525/$2.10 per 1M tokens
+    - `qwen3-next-80b-a3b-thinking` - $0.525/$6.30 per 1M tokens
+    - `qwen3-coder-480b-a35b-instruct` - $1/$5 per 1M tokens
+    - `qwen3-max`, `qwen-qwen3-max` - $1.20/$6 per 1M tokens
+  - **Meta Llama 4 Scout & Maverick** (6 models with updated pricing):
+    - `llama-4-scout`, `llama-4-scout-17bx16e-128k`, `meta-llama/Llama-4-Scout` - $0.15/$0.50 per 1M tokens
+    - `llama-4-maverick`, `llama-4-maverick-17bx128e-128k`, `meta-llama/Llama-4-Maverick` - $0.22/$0.85 per 1M tokens
+  - **IBM Granite Models** (13 new models):
+    - Granite 3 series: `ibm-granite-3-1-8b-instruct`, `ibm-granite-3-8b-instruct`, `granite-3-8b-instruct` - $0.20/$0.20 per 1M tokens
+    - Granite 4 series: `granite-4-0-h-small`, `granite-4-0-h-tiny`, `granite-4-0-h-micro`, `granite-4-0-micro` - $0.20/$0.20 per 1M tokens
+    - Embeddings: `granite-embedding-107m-multilingual`, `granite-embedding-278m-multilingual` - $0.10/$0.10 per 1M tokens
+    - Ollama variants: `granite:3b`, `granite:8b` - $0.20/$0.20 per 1M tokens
+  - **Mistral AI Updates** (10 new models):
+    - `mistral-large-24-11`, `mistral-large-2411` - $8/$24 per 1M tokens
+    - `mistral-small-3-1`, `mistral-small-3.1` - $1/$3 per 1M tokens
+    - `mistral-medium-3`, `mistral-medium-2025` - $0.40/$2 per 1M tokens
+    - Magistral series: `magistral-small` - $1/$3, `magistral-medium` - $3/$9 per 1M tokens
+    - Codestral: `codestral-25-01`, `codestral-2501` - $1/$3 per 1M tokens
+  - **Additional Providers**:
+    - **Sarvam AI**: `sarvam-m`, `sarvamai/sarvam-m`, `sarvam-chat` - Free (Open source)
+    - **Liquid AI**: `lfm-7b`, `liquid/lfm-7b` - $0.30/$0.60 per 1M tokens
+    - **Snowflake**: `snowflake-arctic`, `snowflake-arctic-instruct` - $0.80/$2.40 per 1M tokens, `snowflake-arctic-embed-l-v2.0` - $0.05/$0.05 per 1M tokens
+    - **NVIDIA Nemotron**: `nvidia-nemotron-4-340b-instruct` - $3/$9 per 1M tokens, `nvidia-nemotron-mini` - $0.20/$0.40 per 1M tokens, `nvidia/llama-3.1-nemotron-70b-instruct` - $0.80/$0.80 per 1M tokens
+    - **ServiceNow**: `servicenow-now-assist` - $1/$3 per 1M tokens
+  - **Pricing Corrections**:
+    - `deepseek-v3.1`: Updated to $0.56/$1.68 per 1M tokens (from $1.20/$1.20)
+    - `qwen3:3b`: Renamed to `qwen3:4b` (4B parameter model)
+  - All pricing reflects official provider rates as of October 2025
+
+## [0.1.9] - 2025-01-27
 
 ### Added
 

{genai_otel_instrument-0.1.9.dev0/genai_otel_instrument.egg-info → genai_otel_instrument-0.1.12.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: genai-otel-instrument
-Version: 0.1.9.dev0
+Version: 0.1.12.dev0
 Summary: Comprehensive OpenTelemetry auto-instrumentation for LLM/GenAI applications
 Author-email: Kshitij Thakkar <kshitijthakkar@rocketmail.com>
 License: Apache-2.0
@@ -180,6 +180,12 @@ Dynamic: license-file
 
 # GenAI OpenTelemetry Auto-Instrumentation
 
+<div align="center">
+  <img src=".github/images/Logo.jpg" alt="GenAI OpenTelemetry Instrumentation Logo" width="400"/>
+</div>
+
+<br/>
+
 [![PyPI version](https://badge.fury.io/py/genai-otel-instrument.svg)](https://badge.fury.io/py/genai-otel-instrument)
 [![Python Versions](https://img.shields.io/pypi/pyversions/genai-otel-instrument.svg)](https://pypi.org/project/genai-otel-instrument/)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -200,6 +206,14 @@ Dynamic: license-file
 [![Semantic Conventions](https://img.shields.io/badge/OTel%20Semconv-GenAI%20v1.28-orange)](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
 [![CI/CD](https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-2088FF?logo=github-actions&logoColor=white)](https://github.com/Mandark-droid/genai_otel_instrument/actions)
 
+---
+
+<div align="center">
+  <img src=".github/images/Landing_Page.jpg" alt="GenAI OpenTelemetry Instrumentation Overview" width="800"/>
+</div>
+
+---
+
 Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with zero-code setup.
 
 ## Features
@@ -289,6 +303,65 @@ The processor supports OpenInference semantic conventions:
 pip install genai-otel-instrument[openinference]
 ```
 
+## Screenshots
+
+See the instrumentation in action across different LLM providers and observability backends.
+
+### OpenAI Instrumentation
+Full trace capture for OpenAI API calls with token usage, costs, and latency metrics.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_OpenAI.png" alt="OpenAI Traces" width="900"/>
+</div>
+
+### Ollama (Local LLM) Instrumentation
+Zero-code instrumentation for local models running on Ollama with comprehensive observability.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_Ollama.png" alt="Ollama Traces" width="900"/>
+</div>
+
+### HuggingFace Transformers
+Direct instrumentation of HuggingFace Transformers with automatic token counting and cost estimation.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Trace_HuggingFace_Transformer_Models.png" alt="HuggingFace Transformer Traces" width="900"/>
+</div>
+
+### SmolAgents Framework
+Complete agent workflow tracing with tool calls, iterations, and cost breakdown.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_SmolAgent_with_tool_calls.png" alt="SmolAgent Traces with Tool Calls" width="900"/>
+</div>
+
+### GPU Metrics Collection
+Real-time GPU utilization, memory, temperature, and power consumption metrics.
+
+<div align="center">
+  <img src=".github/images/Screenshots/GPU_Metrics.png" alt="GPU Metrics Dashboard" width="900"/>
+</div>
+
+### Additional Screenshots
+
+- **[Token Cost Breakdown](.github/images/Screenshots/Traces_SmolAgent_Token_Cost_breakdown.png)** - Detailed token usage and cost analysis for SmolAgent workflows
+- **[OpenSearch Dashboard](.github/images/Screenshots/GENAI_OpenSearch_output.png)** - GenAI metrics visualization in OpenSearch/Kibana
+
+---
+
+## Demo Video
+
+Watch a comprehensive walkthrough of GenAI OpenTelemetry Auto-Instrumentation in action, demonstrating setup, configuration, and real-time observability across multiple LLM providers.
+
+<div align="center">
+
+  **🎥 [Watch Demo Video](https://youtu.be/YOUR_VIDEO_ID_HERE)**
+  *(Coming Soon)*
+
+</div>
+
+---
+
 ## Cost Tracking Coverage
 
 The library includes comprehensive cost tracking with pricing data for **145+ models** across **11 providers**:
@@ -840,38 +913,6 @@ genai_otel.instrument(
 - `gen_ai.eval.bias_categories` - Detected bias types (array)
 - `gen_ai.eval.toxicity_categories` - Toxicity categories (array)
 
-#### 📊 Enhanced OpenTelemetry Compliance
-
-Completing remaining items from [OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md](OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md):
-
-**Phase 4: Optional Enhancements (✅ COMPLETED)**
-
-All Phase 4 features are now available! See the [Advanced Features](#advanced-features) section for detailed documentation.
-
-- ✅ **Session & User Tracking** - Track sessions and users across requests with custom extractor functions
-  - Configurable via `session_id_extractor` and `user_id_extractor` in `OTelConfig`
-  - Automatically adds `session.id` and `user.id` span attributes
-  - See [Session and User Tracking](#session-and-user-tracking) for usage examples
-
-- ✅ **RAG/Embedding Attributes** - Enhanced observability for retrieval-augmented generation
-  - Helper methods: `add_embedding_attributes()` and `add_retrieval_attributes()`
-  - Embedding attributes: `embedding.model_name`, `embedding.text`, `embedding.vector.dimension`
-  - Retrieval attributes: `retrieval.query`, `retrieval.document_count`, `retrieval.documents.{i}.document.*`
-  - See [RAG and Embedding Attributes](#rag-and-embedding-attributes) for usage examples
-  - Complete example: `examples/phase4_session_rag_tracking.py`
-
-**Note on Agent Workflow Tracking:**
-
-Agent workflow observability is already provided by the OpenInference Smolagents instrumentor (included when `smolagents` is in `enabled_instrumentors`). This is not a new Phase 4 feature, but an existing capability:
-
-- `openinference.span.kind: "AGENT"` - Identifies agent spans
-- `agent.name` - Agent identifier (via OpenInference)
-- `agent.iteration` - Current iteration number (via OpenInference)
-- `agent.action` - Action taken (via OpenInference)
-- `agent.observation` - Observation received (via OpenInference)
-
-Agent tracking requires Python >= 3.10 and the `smolagents` library. See [OpenInference Integration](#openinference-optional---python-310-only) for details.
-
 #### 🔄 Migration Support
 
 **Backward Compatibility:**

{genai_otel_instrument-0.1.9.dev0 → genai_otel_instrument-0.1.12.dev0}/README.md

@@ -1,5 +1,11 @@
 # GenAI OpenTelemetry Auto-Instrumentation
 
+<div align="center">
+  <img src=".github/images/Logo.jpg" alt="GenAI OpenTelemetry Instrumentation Logo" width="400"/>
+</div>
+
+<br/>
+
 [![PyPI version](https://badge.fury.io/py/genai-otel-instrument.svg)](https://badge.fury.io/py/genai-otel-instrument)
 [![Python Versions](https://img.shields.io/pypi/pyversions/genai-otel-instrument.svg)](https://pypi.org/project/genai-otel-instrument/)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -20,6 +26,14 @@
 [![Semantic Conventions](https://img.shields.io/badge/OTel%20Semconv-GenAI%20v1.28-orange)](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
 [![CI/CD](https://img.shields.io/badge/CI%2FCD-GitHub%20Actions-2088FF?logo=github-actions&logoColor=white)](https://github.com/Mandark-droid/genai_otel_instrument/actions)
 
+---
+
+<div align="center">
+  <img src=".github/images/Landing_Page.jpg" alt="GenAI OpenTelemetry Instrumentation Overview" width="800"/>
+</div>
+
+---
+
 Production-ready OpenTelemetry instrumentation for GenAI/LLM applications with zero-code setup.
 
 ## Features
@@ -109,6 +123,65 @@ The processor supports OpenInference semantic conventions:
 pip install genai-otel-instrument[openinference]
 ```
 
+## Screenshots
+
+See the instrumentation in action across different LLM providers and observability backends.
+
+### OpenAI Instrumentation
+Full trace capture for OpenAI API calls with token usage, costs, and latency metrics.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_OpenAI.png" alt="OpenAI Traces" width="900"/>
+</div>
+
+### Ollama (Local LLM) Instrumentation
+Zero-code instrumentation for local models running on Ollama with comprehensive observability.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_Ollama.png" alt="Ollama Traces" width="900"/>
+</div>
+
+### HuggingFace Transformers
+Direct instrumentation of HuggingFace Transformers with automatic token counting and cost estimation.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Trace_HuggingFace_Transformer_Models.png" alt="HuggingFace Transformer Traces" width="900"/>
+</div>
+
+### SmolAgents Framework
+Complete agent workflow tracing with tool calls, iterations, and cost breakdown.
+
+<div align="center">
+  <img src=".github/images/Screenshots/Traces_SmolAgent_with_tool_calls.png" alt="SmolAgent Traces with Tool Calls" width="900"/>
+</div>
+
+### GPU Metrics Collection
+Real-time GPU utilization, memory, temperature, and power consumption metrics.
+
+<div align="center">
+  <img src=".github/images/Screenshots/GPU_Metrics.png" alt="GPU Metrics Dashboard" width="900"/>
+</div>
+
+### Additional Screenshots
+
+- **[Token Cost Breakdown](.github/images/Screenshots/Traces_SmolAgent_Token_Cost_breakdown.png)** - Detailed token usage and cost analysis for SmolAgent workflows
+- **[OpenSearch Dashboard](.github/images/Screenshots/GENAI_OpenSearch_output.png)** - GenAI metrics visualization in OpenSearch/Kibana
+
+---
+
+## Demo Video
+
+Watch a comprehensive walkthrough of GenAI OpenTelemetry Auto-Instrumentation in action, demonstrating setup, configuration, and real-time observability across multiple LLM providers.
+
+<div align="center">
+
+  **🎥 [Watch Demo Video](https://youtu.be/YOUR_VIDEO_ID_HERE)**
+  *(Coming Soon)*
+
+</div>
+
+---
+
 ## Cost Tracking Coverage
 
 The library includes comprehensive cost tracking with pricing data for **145+ models** across **11 providers**:
@@ -660,38 +733,6 @@ genai_otel.instrument(
 - `gen_ai.eval.bias_categories` - Detected bias types (array)
 - `gen_ai.eval.toxicity_categories` - Toxicity categories (array)
 
-#### 📊 Enhanced OpenTelemetry Compliance
-
-Completing remaining items from [OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md](OTEL_SEMANTIC_GAP_ANALYSIS_AND_IMPLEMENTATION_PLAN.md):
-
-**Phase 4: Optional Enhancements (✅ COMPLETED)**
-
-All Phase 4 features are now available! See the [Advanced Features](#advanced-features) section for detailed documentation.
-
-- ✅ **Session & User Tracking** - Track sessions and users across requests with custom extractor functions
-  - Configurable via `session_id_extractor` and `user_id_extractor` in `OTelConfig`
-  - Automatically adds `session.id` and `user.id` span attributes
-  - See [Session and User Tracking](#session-and-user-tracking) for usage examples
-
-- ✅ **RAG/Embedding Attributes** - Enhanced observability for retrieval-augmented generation
-  - Helper methods: `add_embedding_attributes()` and `add_retrieval_attributes()`
-  - Embedding attributes: `embedding.model_name`, `embedding.text`, `embedding.vector.dimension`
-  - Retrieval attributes: `retrieval.query`, `retrieval.document_count`, `retrieval.documents.{i}.document.*`
-  - See [RAG and Embedding Attributes](#rag-and-embedding-attributes) for usage examples
-  - Complete example: `examples/phase4_session_rag_tracking.py`
-
-**Note on Agent Workflow Tracking:**
-
-Agent workflow observability is already provided by the OpenInference Smolagents instrumentor (included when `smolagents` is in `enabled_instrumentors`). This is not a new Phase 4 feature, but an existing capability:
-
-- `openinference.span.kind: "AGENT"` - Identifies agent spans
-- `agent.name` - Agent identifier (via OpenInference)
-- `agent.iteration` - Current iteration number (via OpenInference)
-- `agent.action` - Action taken (via OpenInference)
-- `agent.observation` - Observation received (via OpenInference)
-
-Agent tracking requires Python >= 3.10 and the `smolagents` library. See [OpenInference Integration](#openinference-optional---python-310-only) for details.
-
 #### 🔄 Migration Support
 
 **Backward Compatibility:**

{genai_otel_instrument-0.1.9.dev0 → genai_otel_instrument-0.1.12.dev0}/examples/anthropic/example.py

@@ -15,7 +15,7 @@ client = Anthropic()
 
 # Make a simple message request
 message = client.messages.create(
-    model="claude-3-5-sonnet-20241022",
+    model="claude-haiku-4-5",
     max_tokens=150,
     messages=[{"role": "user", "content": "Explain OpenTelemetry in one sentence."}],
 )

{genai_otel_instrument-0.1.9.dev0 → genai_otel_instrument-0.1.12.dev0}/genai_otel/__version__.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.9.dev0'
-__version_tuple__ = version_tuple = (0, 1, 9, 'dev0')
+__version__ = version = '0.1.12.dev0'
+__version_tuple__ = version_tuple = (0, 1, 12, 'dev0')
 
-__commit_id__ = commit_id = 'gf4ccb18e4'
+__commit_id__ = commit_id = 'gf2822240c'