asuriq 1.0.0__tar.gz

asuriq-1.0.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: asuriq
+Version: 1.0.0
+Summary: ASURIQ Python SDK — verify AI answers against 21 databases
+Author: Silent Ampersand LLC
+License: MIT
+Project-URL: Homepage, https://asuriq.dev
+Project-URL: Documentation, https://asuriq.dev/api-docs
+Project-URL: Repository, https://github.com/duke-of-beans/ASURIQ
+Keywords: ai,verification,hallucination,fact-checking,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# asuriq
+
+Verify AI answers against 21 databases. Hallucination detection. Entity verification.
+
+```python
+from asuriq import Asuriq
+
+client = Asuriq()
+result = client.check("Your AI response text here", query="The original question")
+
+print(f"Confidence: {result.confidence.score}")
+print(f"Hallucination risk: {result.hallucination.risk}")
+
+for entity in result.entities:
+    print(f"  {entity.entity} ({entity.type}): {entity.status}")
+```
+
+## Install
+
+```bash
+pip install asuriq
+```
+
+## Methods
+
+- `client.check(text, query=None, tier="protocol")` — Full verification analysis
+- `client.deliberate(text, query=None)` — Multi-model deliberation
+- `client.health()` — Engine status
+- `client.ghost()` — Self-model metrics
+- `client.metabolism()` — Token usage stats
+
+## Links
+
+- [asuriq.dev](https://asuriq.dev)
+- [API docs](https://asuriq.dev/api-docs)
+- [All integrations](https://asuriq.dev/integrations)

asuriq-1.0.0/README.md

@@ -0,0 +1,36 @@
+# asuriq
+
+Verify AI answers against 21 databases. Hallucination detection. Entity verification.
+
+```python
+from asuriq import Asuriq
+
+client = Asuriq()
+result = client.check("Your AI response text here", query="The original question")
+
+print(f"Confidence: {result.confidence.score}")
+print(f"Hallucination risk: {result.hallucination.risk}")
+
+for entity in result.entities:
+    print(f"  {entity.entity} ({entity.type}): {entity.status}")
+```
+
+## Install
+
+```bash
+pip install asuriq
+```
+
+## Methods
+
+- `client.check(text, query=None, tier="protocol")` — Full verification analysis
+- `client.deliberate(text, query=None)` — Multi-model deliberation
+- `client.health()` — Engine status
+- `client.ghost()` — Self-model metrics
+- `client.metabolism()` — Token usage stats
+
+## Links
+
+- [asuriq.dev](https://asuriq.dev)
+- [API docs](https://asuriq.dev/api-docs)
+- [All integrations](https://asuriq.dev/integrations)

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

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: asuriq
+Version: 1.0.0
+Summary: ASURIQ Python SDK — verify AI answers against 21 databases
+Author: Silent Ampersand LLC
+License: MIT
+Project-URL: Homepage, https://asuriq.dev
+Project-URL: Documentation, https://asuriq.dev/api-docs
+Project-URL: Repository, https://github.com/duke-of-beans/ASURIQ
+Keywords: ai,verification,hallucination,fact-checking,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# asuriq
+
+Verify AI answers against 21 databases. Hallucination detection. Entity verification.
+
+```python
+from asuriq import Asuriq
+
+client = Asuriq()
+result = client.check("Your AI response text here", query="The original question")
+
+print(f"Confidence: {result.confidence.score}")
+print(f"Hallucination risk: {result.hallucination.risk}")
+
+for entity in result.entities:
+    print(f"  {entity.entity} ({entity.type}): {entity.status}")
+```
+
+## Install
+
+```bash
+pip install asuriq
+```
+
+## Methods
+
+- `client.check(text, query=None, tier="protocol")` — Full verification analysis
+- `client.deliberate(text, query=None)` — Multi-model deliberation
+- `client.health()` — Engine status
+- `client.ghost()` — Self-model metrics
+- `client.metabolism()` — Token usage stats
+
+## Links
+
+- [asuriq.dev](https://asuriq.dev)
+- [API docs](https://asuriq.dev/api-docs)
+- [All integrations](https://asuriq.dev/integrations)

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

@@ -0,0 +1,7 @@
+README.md
+asuriq.py
+pyproject.toml
+asuriq.egg-info/PKG-INFO
+asuriq.egg-info/SOURCES.txt
+asuriq.egg-info/dependency_links.txt
+asuriq.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+asuriq

asuriq-1.0.0/asuriq.py

@@ -0,0 +1,157 @@
+"""
+ASURIQ Python SDK
+Verify AI answers against 21 databases. Hallucination detection. Entity verification.
+
+Usage:
+    from asuriq import Asuriq
+
+    client = Asuriq()
+    result = client.check("Your AI response text here", query="The original question")
+    print(result.confidence.score)
+    print(result.hallucination.risk)
+"""
+
+import urllib.request
+import urllib.error
+import json
+from dataclasses import dataclass, field
+from typing import Optional, Any
+
+
+DEFAULT_API = "https://consensus-production-6eeb.up.railway.app"
+
+
+@dataclass
+class Axis:
+    axis: str
+    score: float
+    label: str
+
+
+@dataclass
+class Confidence:
+    score: float
+    axes: list[Axis] = field(default_factory=list)
+    bottleneck: Optional[str] = None
+
+
+@dataclass
+class Hallucination:
+    risk: float
+    assessment: str = ""
+    signals: list[str] = field(default_factory=list)
+
+
+@dataclass
+class Entity:
+    entity: str
+    type: str
+    status: str = "unverified"
+    sources: list[dict] = field(default_factory=list)
+
+
+@dataclass
+class CheckResult:
+    confidence: Confidence
+    hallucination: Optional[Hallucination] = None
+    entities: list[Entity] = field(default_factory=list)
+    hedging: Optional[dict] = None
+    tone: Optional[dict] = None
+    fmea: Optional[dict] = None
+    citations: Optional[dict] = None
+    contradictions: list[dict] = field(default_factory=list)
+    improvement_hints: Optional[dict] = None
+    stress_questions: list[dict] = field(default_factory=list)
+    classification: Optional[dict] = None
+    raw: dict = field(default_factory=dict)
+
+
+class AsuriqError(Exception):
+    def __init__(self, status: int, message: str):
+        self.status = status
+        super().__init__(f"ASURIQ API error {status}: {message}")
+
+
+class Asuriq:
+    """ASURIQ verification client."""
+
+    def __init__(self, api_base: str = DEFAULT_API, api_key: Optional[str] = None):
+        self.api_base = api_base.rstrip("/")
+        self.api_key = api_key
+
+    def check(self, text: str, query: Optional[str] = None, tier: str = "protocol") -> CheckResult:
+        """Run the full ASURIQ check on AI-generated text."""
+        body = {"text": text, "tier": tier}
+        if query:
+            body["query"] = query
+        data = self._post("/api/v1/check", body)
+        return self._parse_check(data)
+
+    def deliberate(self, text: str, query: Optional[str] = None) -> dict:
+        """Run multi-model deliberation with voting and audit trail."""
+        body = {"text": text, "tier": "t3"}
+        if query:
+            body["query"] = query
+        return self._post("/api/v1/deliberate", body)
+
+    def health(self) -> dict:
+        """Check engine health and available providers."""
+        return self._get("/health")
+
+    def ghost(self) -> dict:
+        """Get Ghost self-model metrics (calibration, domain accuracy)."""
+        return self._get("/api/v1/ghost")
+
+    def metabolism(self) -> dict:
+        """Get token metabolism and session state."""
+        return self._get("/api/v1/metabolism")
+
+    def _post(self, path: str, body: dict) -> dict:
+        url = self.api_base + path
+        data = json.dumps(body).encode("utf-8")
+        headers = {"Content-Type": "application/json"}
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        req = urllib.request.Request(url, data=data, headers=headers, method="POST")
+        try:
+            with urllib.request.urlopen(req, timeout=30) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            raise AsuriqError(e.code, e.read().decode("utf-8", errors="replace"))
+
+    def _get(self, path: str) -> dict:
+        url = self.api_base + path
+        headers = {}
+        if self.api_key:
+            headers["Authorization"] = f"Bearer {self.api_key}"
+        req = urllib.request.Request(url, headers=headers)
+        try:
+            with urllib.request.urlopen(req, timeout=15) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            raise AsuriqError(e.code, e.read().decode("utf-8", errors="replace"))
+
+    def _parse_check(self, data: dict) -> CheckResult:
+        conf = data.get("confidence", {})
+        axes = [Axis(**a) for a in conf.get("axes", [])] if conf.get("axes") else []
+        hall = data.get("hallucination")
+        entities = [Entity(
+            entity=e.get("entity", e.get("name", "")),
+            type=e.get("type", "unknown"),
+            status=e.get("status", "unverified"),
+            sources=e.get("sources", []),
+        ) for e in data.get("entities", [])]
+        return CheckResult(
+            confidence=Confidence(score=conf.get("score", 0), axes=axes, bottleneck=conf.get("bottleneck")),
+            hallucination=Hallucination(risk=hall.get("risk", 0), assessment=hall.get("assessment", ""), signals=hall.get("signals", [])) if hall else None,
+            entities=entities,
+            hedging=data.get("hedging"),
+            tone=data.get("tone"),
+            fmea=data.get("fmea"),
+            citations=data.get("citations"),
+            contradictions=data.get("contradictions", []),
+            improvement_hints=data.get("improvementHints"),
+            stress_questions=data.get("stressQuestions", []),
+            classification=data.get("classification"),
+            raw=data,
+        )

asuriq-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "asuriq"
+version = "1.0.0"
+description = "ASURIQ Python SDK — verify AI answers against 21 databases"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "Silent Ampersand LLC"}]
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+keywords = ["ai", "verification", "hallucination", "fact-checking", "llm"]
+
+[project.urls]
+Homepage = "https://asuriq.dev"
+Documentation = "https://asuriq.dev/api-docs"
+Repository = "https://github.com/duke-of-beans/ASURIQ"

asuriq-1.0.0/setup.cfg

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