kubemind 0.1.0__tar.gz

kubemind-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: kubemind
+Version: 0.1.0
+Summary: Official Python client SDK for KubeMind AI Gateway and Governance Control Plane
+Author: KubeMind team
+Author-email: KubeMind Team <maintainers@kubemind.io>
+License: MIT
+Project-URL: Homepage, https://kubemind.io
+Project-URL: Documentation, https://kubemind.io/docs
+Project-URL: Repository, https://github.com/kubemind/kubemind
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.23.0
+Dynamic: author
+Dynamic: requires-python
+
+# KubeMind Python SDK (`kubemind`)
+
+The official Python client library for **KubeMind** — the self-hosted intelligent AI gateway and governance control plane.
+
+## Installation
+
+```bash
+pip install kubemind
+```
+
+## Quickstart
+
+```python
+from kubemind import KubeMindClient
+
+# Initialize client with API key and workspace ID
+client = KubeMindClient(
+    api_key="your-api-key",
+    workspace_id="default",
+    router_url="http://localhost:9080",
+    mind_url="http://localhost:9081",
+    sentinel_url="http://localhost:9083",
+)
+
+# 1. Chat completion with intent classification & sensitivity governance
+completion = client.chat_completion(
+    model="llama3.1",
+    messages=[
+        {"role": "user", "content": "Email alice@example.com the summary report"}
+    ]
+)
+print("Response:", completion["choices"][0]["message"]["content"])
+print("Routing Decision:", completion.get("routing_decision"))
+
+# 2. Semantic prompt routing
+route = client.route("What is our company expense policy?")
+print("Content:", route.get("content"))
+print("Retrieval Status:", route.get("retrieval_status"))
+
+# 3. CFO Cost & Usage Analytics
+analytics = client.get_cost_analytics(window_hours=24)
+print(f"Total Requests: {analytics['total_requests']}")
+print(f"Estimated Spend ($): {analytics['estimated_spend_usd']}")
+
+# 4. Cryptographic Ledger Verification
+audit = client.verify_audit_ledger()
+print("Ledger Intact:", audit.get("verified"))
+```
+
+## Features
+
+- **Pre-Dispatch Sensitivity Gating**: Inline regex + local offline NER tokenization with in-memory reversible restoration.
+- **Intent-Driven Routing**: Routes prompts dynamically based on classified semantic intent.
+- **Fail-Closed Grounding**: Distinguishes verified corporate knowledge from hallucinations.
+- **SHA-256 Tamper-Evident Ledger**: Verifiable cryptographic audit trail for HIPAA/SOC2 compliance.
+- **Granular RBAC**: Supports role-scoped API keys (`admin`, `developer`, `auditor`, `viewer`).

kubemind-0.1.0/README.md

@@ -0,0 +1,56 @@
+# KubeMind Python SDK (`kubemind`)
+
+The official Python client library for **KubeMind** — the self-hosted intelligent AI gateway and governance control plane.
+
+## Installation
+
+```bash
+pip install kubemind
+```
+
+## Quickstart
+
+```python
+from kubemind import KubeMindClient
+
+# Initialize client with API key and workspace ID
+client = KubeMindClient(
+    api_key="your-api-key",
+    workspace_id="default",
+    router_url="http://localhost:9080",
+    mind_url="http://localhost:9081",
+    sentinel_url="http://localhost:9083",
+)
+
+# 1. Chat completion with intent classification & sensitivity governance
+completion = client.chat_completion(
+    model="llama3.1",
+    messages=[
+        {"role": "user", "content": "Email alice@example.com the summary report"}
+    ]
+)
+print("Response:", completion["choices"][0]["message"]["content"])
+print("Routing Decision:", completion.get("routing_decision"))
+
+# 2. Semantic prompt routing
+route = client.route("What is our company expense policy?")
+print("Content:", route.get("content"))
+print("Retrieval Status:", route.get("retrieval_status"))
+
+# 3. CFO Cost & Usage Analytics
+analytics = client.get_cost_analytics(window_hours=24)
+print(f"Total Requests: {analytics['total_requests']}")
+print(f"Estimated Spend ($): {analytics['estimated_spend_usd']}")
+
+# 4. Cryptographic Ledger Verification
+audit = client.verify_audit_ledger()
+print("Ledger Intact:", audit.get("verified"))
+```
+
+## Features
+
+- **Pre-Dispatch Sensitivity Gating**: Inline regex + local offline NER tokenization with in-memory reversible restoration.
+- **Intent-Driven Routing**: Routes prompts dynamically based on classified semantic intent.
+- **Fail-Closed Grounding**: Distinguishes verified corporate knowledge from hallucinations.
+- **SHA-256 Tamper-Evident Ledger**: Verifiable cryptographic audit trail for HIPAA/SOC2 compliance.
+- **Granular RBAC**: Supports role-scoped API keys (`admin`, `developer`, `auditor`, `viewer`).

kubemind-0.1.0/kubemind/__init__.py

@@ -0,0 +1,3 @@
+from .client import KubeMindClient
+
+__all__ = ["KubeMindClient"]

kubemind-0.1.0/kubemind/client.py

@@ -0,0 +1,169 @@
+import os
+import httpx
+from typing import List, Dict, Any, Optional
+
+class KubeMindClient:
+    """
+    Official Python SDK client for KubeMind.
+    Provides standard wrappers around KubeMind services (Router, Mind, Sentinel).
+    """
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        workspace_id: Optional[str] = None,
+        router_url: Optional[str] = None,
+        mind_url: Optional[str] = None,
+        sentinel_url: Optional[str] = None,
+        timeout: float = 30.0
+    ):
+        self.workspace_id = workspace_id or os.environ.get("KUBEMIND_WORKSPACE", "default")
+        resolved_router = router_url or os.environ.get("ROUTER_URL", os.environ.get("KUBEMIND_ROUTER_URL", "http://localhost:9080"))
+        resolved_mind = mind_url or os.environ.get("MIND_URL", os.environ.get("KUBEMIND_MIND_URL", "http://localhost:9081"))
+        resolved_sentinel = sentinel_url or os.environ.get("SENTINEL_URL", os.environ.get("KUBEMIND_SENTINEL_URL", "http://localhost:9083"))
+        
+        self.router_url = resolved_router.rstrip("/")
+        self.mind_url = resolved_mind.rstrip("/")
+        self.sentinel_url = resolved_sentinel.rstrip("/")
+        self.timeout = timeout
+        
+        self.headers = {
+            "Content-Type": "application/json",
+            "X-Workspace-ID": self.workspace_id
+        }
+        if api_key:
+            self.headers["X-API-Key"] = api_key
+
+    def chat_completion(self, model: str, messages: List[Dict[str, str]], enable_cache: bool = True, **kwargs) -> Dict[str, Any]:
+        """
+        Sends a prompt to the KubeMind Router for classification, policy overlay, and LLM completions.
+        """
+        url = f"{self.router_url}/v1/chat/completions"
+        payload = {
+            "model": model,
+            "messages": messages,
+            "enable_cache": enable_cache,
+            **kwargs
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.post(url, headers=self.headers, json=payload)
+            resp.raise_for_status()
+            return resp.json()
+
+    def chat_stream(self, model: str, messages: List[Dict[str, str]], **kwargs):
+        """
+        Stream chat completion tokens in real-time with de-anonymization applied.
+        """
+        import json
+        url = f"{self.router_url}/v1/chat/completions"
+        payload = {
+            "model": model,
+            "messages": messages,
+            "stream": True,
+            **kwargs
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            with client.stream("POST", url, headers=self.headers, json=payload) as resp:
+                resp.raise_for_status()
+                for line in resp.iter_lines():
+                    if line.startswith("data: ") and not line.startswith("data: [DONE]"):
+                        try:
+                            yield json.loads(line[6:])
+                        except Exception:
+                            continue
+
+    def route(self, prompt: str, **kwargs) -> Dict[str, Any]:
+        """
+        Sends a prompt to KubeMind Router's intent routing proxy directly.
+        """
+        url = f"{self.router_url}/v1/route"
+        payload = {
+            "prompt": prompt,
+            **kwargs
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.post(url, headers=self.headers, json=payload)
+            resp.raise_for_status()
+            return resp.json()
+
+    def classify(self, prompt: str) -> Dict[str, Any]:
+        """
+        Dry-run classify the prompt intent and sensitivity.
+        """
+        url = f"{self.router_url}/v1/classify"
+        payload = {
+            "prompt": prompt
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.post(url, headers=self.headers, json=payload)
+            resp.raise_for_status()
+            return resp.json()
+
+    def ingest_memory(self, content: str, source: str = "sdk", metadata: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """
+        Ingest documents/knowledge into the KubeMind knowledge graph (Mind).
+        """
+        url = f"{self.mind_url}/v1/ingest"
+        payload = {
+            "content": content,
+            "source": source,
+            "metadata": metadata or {}
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.post(url, headers=self.headers, json=payload)
+            resp.raise_for_status()
+            return resp.json()
+
+    def query_memory(self, query: str, filters: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        """
+        Query the memory knowledge graph.
+        """
+        url = f"{self.mind_url}/v1/query"
+        payload = {
+            "query": query,
+            "filters": filters or {}
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.post(url, headers=self.headers, json=payload)
+            resp.raise_for_status()
+            return resp.json()
+
+    def verify_audit_ledger(self, limit: int = 50) -> Dict[str, Any]:
+        """
+        Verify and fetch the audit ledger entries from Sentinel.
+        """
+        url = f"{self.sentinel_url}/v1/audit/verify"
+        params = {
+            "workspace_id": self.workspace_id,
+            "limit": limit
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.get(url, headers=self.headers, params=params)
+            resp.raise_for_status()
+            return resp.json()
+
+    def get_cost_analytics(self, window_hours: int = 24) -> Dict[str, Any]:
+        """
+        Fetch aggregated cost, token, and provider usage analytics.
+        """
+        url = f"{self.router_url}/v1/usage/analytics"
+        params = {
+            "window_hours": window_hours
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.get(url, headers=self.headers, params=params)
+            resp.raise_for_status()
+            return resp.json()
+
+    def get_org_analytics(self, window_hours: int = 720) -> Dict[str, Any]:
+        """
+        Fetch cross-workspace org-wide financial and token rollups.
+        """
+        url = f"{self.router_url}/v1/usage/org-analytics"
+        params = {
+            "window_hours": window_hours
+        }
+        with httpx.Client(timeout=self.timeout) as client:
+            resp = client.get(url, headers=self.headers, params=params)
+            resp.raise_for_status()
+            return resp.json()
+

kubemind-0.1.0/kubemind.egg-info/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: kubemind
+Version: 0.1.0
+Summary: Official Python client SDK for KubeMind AI Gateway and Governance Control Plane
+Author: KubeMind team
+Author-email: KubeMind Team <maintainers@kubemind.io>
+License: MIT
+Project-URL: Homepage, https://kubemind.io
+Project-URL: Documentation, https://kubemind.io/docs
+Project-URL: Repository, https://github.com/kubemind/kubemind
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.23.0
+Dynamic: author
+Dynamic: requires-python
+
+# KubeMind Python SDK (`kubemind`)
+
+The official Python client library for **KubeMind** — the self-hosted intelligent AI gateway and governance control plane.
+
+## Installation
+
+```bash
+pip install kubemind
+```
+
+## Quickstart
+
+```python
+from kubemind import KubeMindClient
+
+# Initialize client with API key and workspace ID
+client = KubeMindClient(
+    api_key="your-api-key",
+    workspace_id="default",
+    router_url="http://localhost:9080",
+    mind_url="http://localhost:9081",
+    sentinel_url="http://localhost:9083",
+)
+
+# 1. Chat completion with intent classification & sensitivity governance
+completion = client.chat_completion(
+    model="llama3.1",
+    messages=[
+        {"role": "user", "content": "Email alice@example.com the summary report"}
+    ]
+)
+print("Response:", completion["choices"][0]["message"]["content"])
+print("Routing Decision:", completion.get("routing_decision"))
+
+# 2. Semantic prompt routing
+route = client.route("What is our company expense policy?")
+print("Content:", route.get("content"))
+print("Retrieval Status:", route.get("retrieval_status"))
+
+# 3. CFO Cost & Usage Analytics
+analytics = client.get_cost_analytics(window_hours=24)
+print(f"Total Requests: {analytics['total_requests']}")
+print(f"Estimated Spend ($): {analytics['estimated_spend_usd']}")
+
+# 4. Cryptographic Ledger Verification
+audit = client.verify_audit_ledger()
+print("Ledger Intact:", audit.get("verified"))
+```
+
+## Features
+
+- **Pre-Dispatch Sensitivity Gating**: Inline regex + local offline NER tokenization with in-memory reversible restoration.
+- **Intent-Driven Routing**: Routes prompts dynamically based on classified semantic intent.
+- **Fail-Closed Grounding**: Distinguishes verified corporate knowledge from hallucinations.
+- **SHA-256 Tamper-Evident Ledger**: Verifiable cryptographic audit trail for HIPAA/SOC2 compliance.
+- **Granular RBAC**: Supports role-scoped API keys (`admin`, `developer`, `auditor`, `viewer`).

kubemind-0.1.0/kubemind.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+setup.py
+kubemind/__init__.py
+kubemind/client.py
+kubemind.egg-info/PKG-INFO
+kubemind.egg-info/SOURCES.txt
+kubemind.egg-info/dependency_links.txt
+kubemind.egg-info/requires.txt
+kubemind.egg-info/top_level.txt

kubemind-0.1.0/kubemind.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kubemind-0.1.0/kubemind.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx>=0.23.0

kubemind-0.1.0/kubemind.egg-info/top_level.txt

@@ -0,0 +1 @@
+kubemind

kubemind-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kubemind"
+version = "0.1.0"
+description = "Official Python client SDK for KubeMind AI Gateway and Governance Control Plane"
+readme = "README.md"
+authors = [{ name = "KubeMind Team", email = "maintainers@kubemind.io" }]
+license = { text = "MIT" }
+requires-python = ">=3.8"
+dependencies = [
+    "httpx>=0.23.0",
+]
+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 :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Security",
+]
+
+[project.urls]
+Homepage = "https://kubemind.io"
+Documentation = "https://kubemind.io/docs"
+Repository = "https://github.com/kubemind/kubemind"

kubemind-0.1.0/setup.cfg

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

kubemind-0.1.0/setup.py

@@ -0,0 +1,13 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="kubemind",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=[
+        "httpx>=0.20.0",
+    ],
+    author="KubeMind team",
+    description="Official Python SDK for the KubeMind gateway and governance plane",
+    python_requires=">=3.8",
+)