scdl-rag 1.0.0__tar.gz

scdl_rag-1.0.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: scdl-rag
+Version: 1.0.0
+Summary: SCDL-RAG: Detect and fix RAG hallucinations with 97% recall and 100% precision.
+Author: SCDL-RAG Team
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# SCDL-RAG Python SDK
+Detect and fix RAG hallucinations.
+
+## Install
+```bash
+pip install scdl-rag
+```
+
+## Usage
+```python
+from scdl_rag import Client
+
+client = Client(api_key="sk_live_...")
+
+result = client.detect(
+    question="What is RL?",
+    answer="nodes called neurons",
+    documents=[{"id": "doc1", "content": "RL is about..."}],
+)
+
+if result.hallucination_detected:
+    print(f"Hallucination found: {result.explanation}")
+else:
+    print(f"Coherent (score: {result.mu_score})")
+```
+
+## API
+See https://api.scdl-rag.com/docs for full API reference.

scdl_rag-1.0.0/README.md

@@ -0,0 +1,28 @@
+# SCDL-RAG Python SDK
+Detect and fix RAG hallucinations.
+
+## Install
+```bash
+pip install scdl-rag
+```
+
+## Usage
+```python
+from scdl_rag import Client
+
+client = Client(api_key="sk_live_...")
+
+result = client.detect(
+    question="What is RL?",
+    answer="nodes called neurons",
+    documents=[{"id": "doc1", "content": "RL is about..."}],
+)
+
+if result.hallucination_detected:
+    print(f"Hallucination found: {result.explanation}")
+else:
+    print(f"Coherent (score: {result.mu_score})")
+```
+
+## API
+See https://api.scdl-rag.com/docs for full API reference.

scdl_rag-1.0.0/scdl_rag/__init__.py

@@ -0,0 +1,124 @@
+"""
+SCDL-RAG Python SDK — Enterprise hallucination detection client.
+"""
+from typing import List, Optional, Dict, Any
+import requests as _req
+
+
+class Document:
+    def __init__(self, id: str, content: str, title: str = ""):
+        self.id = id
+        self.content = content
+        self.title = title
+
+    def to_dict(self):
+        return {"id": self.id, "content": self.content, "title": self.title}
+
+
+class DetectResult:
+    def __init__(self, data: dict):
+        self.request_id = data.get("request_id")
+        self.hallucination_detected = data.get("hallucination_detected", False)
+        self.mu_score = data.get("mu_score", 0.0)
+        self.status = data.get("status", "unknown")
+        self.signals = data.get("signals", {})
+        self.explanation = data.get("explanation", "")
+        self.processing_time_ms = data.get("processing_time_ms", 0)
+
+
+class DetectAndFixResult:
+    def __init__(self, data: dict):
+        self.request_id = data.get("request_id")
+        self.hallucination_detected = data.get("hallucination_detected", False)
+        self.mu_score_initial = data.get("mu_score_initial", 0.0)
+        self.status_initial = data.get("status_initial", "unknown")
+        self.problem_detected = data.get("problem_detected", {})
+        self.fix_attempted = data.get("fix_attempted", False)
+        self.fix_success = data.get("fix_success", False)
+        self.mu_score_after_fix = data.get("mu_score_after_fix", None)
+        self.status_after_fix = data.get("status_after_fix", None)
+        self.improved_answer = data.get("improved_answer", "")
+        self.evidence_source = data.get("evidence_source", "")
+        self.evidence_snippet = data.get("evidence_snippet", "")
+        self.confidence = data.get("confidence", 0.0)
+        self.processing_time_ms = data.get("processing_time_ms", 0)
+
+
+class BatchResult:
+    def __init__(self, data: dict):
+        self.batch_id = data.get("batch_id")
+        self.total_cases = data.get("total_cases", 0)
+        self.processed = data.get("processed", 0)
+        self.results = data.get("results", [])
+        self.summary = data.get("summary", {})
+        self.processing_time_ms = data.get("processing_time_ms", 0)
+
+
+class Client:
+    """SCDL-RAG API client.
+
+    Usage:
+        client = Client(api_key="sk_live_...")
+        result = client.detect(question="...", answer="...", documents=[...])
+        if result.hallucination_detected:
+            print(result.explanation)
+    """
+
+    def __init__(self, api_key: str, base_url: str = "https://api.scdl-rag.com"):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._headers = {
+            "Authorization": f"Bearer {api_key}",
+            "Content-Type": "application/json",
+        }
+
+    def detect(self, question: str, answer: str, documents: List[Dict],
+               model: str = "gpt-4") -> DetectResult:
+        """Detect hallucination in a RAG answer."""
+        resp = _req.post(f"{self.base_url}/v1/detect",
+                         headers=self._headers,
+                         json={
+                             "question": question,
+                             "answer": answer,
+                             "documents": [{"id": d["id"], "content": d["content"], "title": d.get("title", "")}
+                                           for d in documents],
+                             "model": model,
+                         }, timeout=30)
+        resp.raise_for_status()
+        return DetectResult(resp.json())
+
+    def detect_and_fix(self, question: str, answer: str, documents: List[Dict],
+                       document_pool: List[Dict] = None, auto_fix: bool = True) -> DetectAndFixResult:
+        """Detect hallucination and attempt auto-fix via improved retrieval."""
+        resp = _req.post(f"{self.base_url}/v1/detect-and-fix",
+                         headers=self._headers,
+                         json={
+                             "question": question,
+                             "answer": answer,
+                             "documents": [{"id": d["id"], "content": d["content"], "title": d.get("title", "")}
+                                           for d in documents],
+                             "document_pool": [{"id": d["id"], "content": d["content"], "title": d.get("title", "")}
+                                               for d in (document_pool or [])],
+                             "auto_fix": auto_fix,
+                         }, timeout=60)
+        resp.raise_for_status()
+        return DetectAndFixResult(resp.json())
+
+    def batch_detect_and_fix(self, cases: List[Dict], auto_fix: bool = True,
+                             batch_id: str = None) -> BatchResult:
+        """Batch detect and fix hallucinations."""
+        resp = _req.post(f"{self.base_url}/v1/batch/detect-and-fix",
+                         headers=self._headers,
+                         json={
+                             "batch_id": batch_id,
+                             "cases": [{
+                                 "id": c["id"],
+                                 "question": c["question"],
+                                 "answer": c["answer"],
+                                 "documents": [{"id": d["id"], "content": d["content"], "title": d.get("title", "")}
+                                               for d in c.get("documents", [])],
+                             } for c in cases],
+                             "auto_fix": auto_fix,
+                         }, timeout=120)
+        resp.raise_for_status()
+        return BatchResult(resp.json())

scdl_rag-1.0.0/scdl_rag.egg-info/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: scdl-rag
+Version: 1.0.0
+Summary: SCDL-RAG: Detect and fix RAG hallucinations with 97% recall and 100% precision.
+Author: SCDL-RAG Team
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# SCDL-RAG Python SDK
+Detect and fix RAG hallucinations.
+
+## Install
+```bash
+pip install scdl-rag
+```
+
+## Usage
+```python
+from scdl_rag import Client
+
+client = Client(api_key="sk_live_...")
+
+result = client.detect(
+    question="What is RL?",
+    answer="nodes called neurons",
+    documents=[{"id": "doc1", "content": "RL is about..."}],
+)
+
+if result.hallucination_detected:
+    print(f"Hallucination found: {result.explanation}")
+else:
+    print(f"Coherent (score: {result.mu_score})")
+```
+
+## API
+See https://api.scdl-rag.com/docs for full API reference.

scdl_rag-1.0.0/scdl_rag.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+scdl_rag/__init__.py
+scdl_rag.egg-info/PKG-INFO
+scdl_rag.egg-info/SOURCES.txt
+scdl_rag.egg-info/dependency_links.txt
+scdl_rag.egg-info/requires.txt
+scdl_rag.egg-info/top_level.txt

scdl_rag-1.0.0/scdl_rag.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

scdl_rag-1.0.0/scdl_rag.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

scdl_rag-1.0.0/scdl_rag.egg-info/top_level.txt

@@ -0,0 +1 @@
+scdl_rag

scdl_rag-1.0.0/setup.cfg

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

scdl_rag-1.0.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="scdl-rag",
+    version="1.0.0",
+    description="SCDL-RAG: Detect and fix RAG hallucinations with 97% recall and 100% precision.",
+    long_description=open("README.md").read() if __import__("os").path.exists("README.md") else "",
+    long_description_content_type="text/markdown",
+    author="SCDL-RAG Team",
+    packages=find_packages(),
+    install_requires=["requests>=2.28.0"],
+    python_requires=">=3.8",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+    ],
+)