Metadata-Version: 2.4
Name: rag-forge-observability
Version: 0.2.3
Summary: Observability stack: OpenTelemetry tracing, Langfuse integration, and drift detection
Project-URL: Homepage, https://github.com/hallengray/rag-forge
Project-URL: Repository, https://github.com/hallengray/rag-forge
Project-URL: Issues, https://github.com/hallengray/rag-forge/issues
Project-URL: Documentation, https://github.com/hallengray/rag-forge#readme
Author: Femi Adedayo
License-Expression: MIT
Keywords: drift-detection,observability,opentelemetry,rag,tracing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.11
Requires-Dist: opentelemetry-api>=1.20
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.20
Requires-Dist: opentelemetry-sdk>=1.20
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# rag-forge-observability

OpenTelemetry tracing and query drift detection for the RAG-Forge toolkit.

## Installation

```bash
pip install rag-forge-observability
```

## Usage

```python
from rag_forge_observability.drift import DriftDetector, DriftBaseline

baseline = DriftBaseline(embeddings=[[1.0, 0.0, 0.0]])
detector = DriftDetector(threshold=0.15)
report = detector.analyze(current_embeddings=[[0.9, 0.1, 0.0]], baseline=baseline)
print(f"Drift detected: {report.is_drifting}")
```

## Features

- OpenTelemetry tracing for all RAG pipeline stages
- Query drift detection with baseline comparison
- Centroid-based cosine distance analysis

## License

MIT
