pyomnibrain 0.1.0__tar.gz

pyomnibrain-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: pyomnibrain
+Version: 0.1.0
+Summary: Python bindings and SDK for OmniBrain: Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine
+Author-email: "Shah Md. Mahi" <shahmdmahi15@gmail.com>
+Project-URL: Homepage, https://github.com/shahmdmahi15/omnibrain
+Project-URL: Bug Tracker, https://github.com/shahmdmahi15/omnibrain/issues
+Project-URL: Website, https://shahmdmahi.dpdns.org
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Database :: Database Engines/Servers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# pyomnibrain
+
+**Python SDK & Client for OmniBrain (ChronoCache)**
+*Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine*
+
+## Installation
+
+```bash
+pip install pyomnibrain
+```
+
+## Quickstart
+
+```python
+from pyomnibrain import OmniBrainClient
+
+# Connect to local OmniBrain daemon
+client = OmniBrainClient(host="127.0.0.1", port=4821)
+
+# Check daemon health
+health = client.health()
+print(f"Connected to OmniBrain v{health['version']}")
+
+# Snapshot an article into offline memory
+capture_result = client.capture(
+    url="https://example.com/rust-architecture",
+    title="High-Performance Rust Architectures",
+    content="""
+    <article>
+        <h1>High-Performance Rust Architectures</h1>
+        <p>Rust empowers developers to build reliable, high-throughput systems with zero-cost abstractions.</p>
+    </article>
+    """
+)
+print(f"Captured: {capture_result['title']} | Compression: {capture_result['compression']['compression_ratio']}x")
+
+# Search offline memory with hybrid fusion
+results = client.search("high-performance reliable systems", limit=5, mode="hybrid")
+for r in results:
+    print(f"[{r['match_type'].upper()}] {r['title']} (Score: {r['score']:.4f})")
+    print(f"  Snippet: {r['snippet']}")
+```

pyomnibrain-0.1.0/README.md

@@ -0,0 +1,42 @@
+# pyomnibrain
+
+**Python SDK & Client for OmniBrain (ChronoCache)**
+*Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine*
+
+## Installation
+
+```bash
+pip install pyomnibrain
+```
+
+## Quickstart
+
+```python
+from pyomnibrain import OmniBrainClient
+
+# Connect to local OmniBrain daemon
+client = OmniBrainClient(host="127.0.0.1", port=4821)
+
+# Check daemon health
+health = client.health()
+print(f"Connected to OmniBrain v{health['version']}")
+
+# Snapshot an article into offline memory
+capture_result = client.capture(
+    url="https://example.com/rust-architecture",
+    title="High-Performance Rust Architectures",
+    content="""
+    <article>
+        <h1>High-Performance Rust Architectures</h1>
+        <p>Rust empowers developers to build reliable, high-throughput systems with zero-cost abstractions.</p>
+    </article>
+    """
+)
+print(f"Captured: {capture_result['title']} | Compression: {capture_result['compression']['compression_ratio']}x")
+
+# Search offline memory with hybrid fusion
+results = client.search("high-performance reliable systems", limit=5, mode="hybrid")
+for r in results:
+    print(f"[{r['match_type'].upper()}] {r['title']} (Score: {r['score']:.4f})")
+    print(f"  Snippet: {r['snippet']}")
+```

pyomnibrain-0.1.0/pyomnibrain/__init__.py

@@ -0,0 +1,107 @@
+"""
+pyomnibrain: Python Client and Data Science Interface for OmniBrain.
+Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine.
+"""
+
+from typing import Any, Dict, List, Optional
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+
+
+class OmniBrainError(Exception):
+    """Base exception for OmniBrain client errors."""
+    pass
+
+
+class OmniBrainClient:
+    """Client for interacting with local or remote OmniBrain daemon."""
+
+    def __init__(self, host: str = "127.0.0.1", port: int = 4821, timeout: float = 10.0):
+        self.base_url = f"http://{host}:{port}"
+        self.timeout = timeout
+
+    def _request(self, method: str, path: str, data: Optional[Dict[str, Any]] = None, params: Optional[Dict[str, Any]] = None) -> Any:
+        url = f"{self.base_url}{path}"
+        if params:
+            query_string = urllib.parse.urlencode({k: v for k, v in params.items() if v is not None})
+            url = f"{url}?{query_string}"
+
+        headers = {
+            "Accept": "application/json",
+            "User-Agent": "pyomnibrain/0.1.0",
+        }
+        body = None
+        if data is not None:
+            body = json.dumps(data).encode("utf-8")
+            headers["Content-Type"] = "application/json"
+
+        req = urllib.request.Request(url, data=body, headers=headers, method=method)
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as response:
+                resp_bytes = response.read()
+                if not resp_bytes:
+                    return None
+                return json.loads(resp_bytes.decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            error_body = e.read().decode("utf-8", errors="replace")
+            raise OmniBrainError(f"HTTP {e.code}: {error_body}") from e
+        except Exception as e:
+            raise OmniBrainError(f"Connection failed to {url}: {e}") from e
+
+    def health(self) -> Dict[str, Any]:
+        """Check status of OmniBrain daemon."""
+        return self._request("GET", "/health")
+
+    def capture(
+        self,
+        url: str,
+        content: str,
+        title: Optional[str] = None,
+        raw_html: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Capture a web page or article into offline memory.
+        Runs readability extraction, Zstd compression, and HNSW embedding indexing.
+        """
+        payload = {
+            "url": url,
+            "title": title,
+            "content": content,
+            "raw_html": raw_html,
+        }
+        return self._request("POST", "/api/capture", data=payload)
+
+    def search(
+        self,
+        query: str,
+        limit: int = 10,
+        mode: str = "hybrid",
+    ) -> List[Dict[str, Any]]:
+        """
+        Execute search across offline personal web memory.
+        Modes: 'hybrid' (RRF BM25 + HNSW), 'lexical' (BM25), 'semantic' (HNSW Cosine).
+        """
+        params = {
+            "q": query,
+            "limit": limit,
+            "mode": mode,
+        }
+        return self._request("GET", "/api/search", params=params)
+
+    def get_doc(self, doc_id: str) -> Dict[str, Any]:
+        """Retrieve full uncompressed document by ID."""
+        return self._request("GET", f"/api/doc/{doc_id}")
+
+    def delete_doc(self, doc_id: str) -> bool:
+        """Delete document from store and search indexes."""
+        res = self._request("DELETE", f"/api/doc/{doc_id}")
+        return res.get("success", False)
+
+    def stats(self) -> Dict[str, Any]:
+        """Get knowledge graph and compression telemetry."""
+        return self._request("GET", "/api/stats")
+
+
+__all__ = ["OmniBrainClient", "OmniBrainError"]

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

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: pyomnibrain
+Version: 0.1.0
+Summary: Python bindings and SDK for OmniBrain: Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine
+Author-email: "Shah Md. Mahi" <shahmdmahi15@gmail.com>
+Project-URL: Homepage, https://github.com/shahmdmahi15/omnibrain
+Project-URL: Bug Tracker, https://github.com/shahmdmahi15/omnibrain/issues
+Project-URL: Website, https://shahmdmahi.dpdns.org
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Database :: Database Engines/Servers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+
+# pyomnibrain
+
+**Python SDK & Client for OmniBrain (ChronoCache)**
+*Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine*
+
+## Installation
+
+```bash
+pip install pyomnibrain
+```
+
+## Quickstart
+
+```python
+from pyomnibrain import OmniBrainClient
+
+# Connect to local OmniBrain daemon
+client = OmniBrainClient(host="127.0.0.1", port=4821)
+
+# Check daemon health
+health = client.health()
+print(f"Connected to OmniBrain v{health['version']}")
+
+# Snapshot an article into offline memory
+capture_result = client.capture(
+    url="https://example.com/rust-architecture",
+    title="High-Performance Rust Architectures",
+    content="""
+    <article>
+        <h1>High-Performance Rust Architectures</h1>
+        <p>Rust empowers developers to build reliable, high-throughput systems with zero-cost abstractions.</p>
+    </article>
+    """
+)
+print(f"Captured: {capture_result['title']} | Compression: {capture_result['compression']['compression_ratio']}x")
+
+# Search offline memory with hybrid fusion
+results = client.search("high-performance reliable systems", limit=5, mode="hybrid")
+for r in results:
+    print(f"[{r['match_type'].upper()}] {r['title']} (Score: {r['score']:.4f})")
+    print(f"  Snippet: {r['snippet']}")
+```

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

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

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+pyomnibrain

pyomnibrain-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pyomnibrain"
+version = "0.1.0"
+authors = [
+  { name="Shah Md. Mahi", email="shahmdmahi15@gmail.com" },
+]
+description = "Python bindings and SDK for OmniBrain: Embedded Local-First Temporal Semantic Knowledge Graph & Reader Engine"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Database :: Database Engines/Servers",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/shahmdmahi15/omnibrain"
+"Bug Tracker" = "https://github.com/shahmdmahi15/omnibrain/issues"
+"Website" = "https://shahmdmahi.dpdns.org"

pyomnibrain-0.1.0/setup.cfg

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