agba-engine 5.0.0__tar.gz

agba_engine-5.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include pyproject.toml
+include setup.py
+recursive-include agba_engine *.py
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude *.pt

agba_engine-5.0.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: agba_engine
+Version: 5.0.0
+Summary: Global Cultural Assistant & Heritage Preservation Engine.
+Author: Aruna Olanrewaju Kabiru
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: torch
+Requires-Dist: huggingface_hub
+
+# Agba Engine
+
+**Agba Engine** is a Global Cultural Assistant and Heritage Preservation Framework designed for high-performance retrieval, indexing, and preservation of cultural regalia, visual artifacts, and audio metadata across diverse global traditions.

agba_engine-5.0.0/README.md

@@ -0,0 +1,3 @@
+# Agba Engine
+
+**Agba Engine** is a Global Cultural Assistant and Heritage Preservation Framework designed for high-performance retrieval, indexing, and preservation of cultural regalia, visual artifacts, and audio metadata across diverse global traditions.

agba_engine-5.0.0/agba_engine/core/engine.py

@@ -0,0 +1,37 @@
+import os
+import torch
+from huggingface_hub import hf_hub_download
+from agba_engine.search.vector import compute_cosine_similarity
+from agba_engine.utils.fallback import resolve_oov_fallback
+
+class AgbaSearchEngine:
+    def __init__(self, index_path="agba_tri_vector_index_v5.pt", repo_id="OcculusPanther/agba-vector-index-v5"):
+        # Auto-download from Hugging Face if file isn't present locally
+        if not os.path.exists(index_path):
+            print(f"⏳ Index `{index_path}` not found locally. Fetching official weights from Hugging Face ({repo_id})...")
+            try:
+                index_path = hf_hub_download(
+                    repo_id=repo_id,
+                    filename="agba_tri_vector_index_v5.pt"
+                )
+                print("✅ Index binary successfully downloaded from Hugging Face!")
+            except Exception as e:
+                raise RuntimeError(f"Failed to download index from Hugging Face: {e}")
+
+        # Security Hardening: weights_only=True prevents arbitrary code execution via pickle
+        try:
+            checkpoint = torch.load(index_path, weights_only=True)
+        except TypeError:
+            checkpoint = torch.load(index_path)
+
+        self.version = checkpoint["version"]
+        self.database = checkpoint["database"]
+        self.total_assets = checkpoint["total_assets"]
+        self.categories = checkpoint["metadata"]["regalia_classes"]
+        
+    def search_by_vision(self, visual_vector, top_k=3):
+        results = compute_cosine_similarity(visual_vector, self.database)
+        return results[:top_k]
+
+    def get_audio_surrogate(self, asset_id, available_segments=set()):
+        return resolve_oov_fallback(asset_id, available_segments)

agba_engine-5.0.0/agba_engine.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: agba_engine
+Version: 5.0.0
+Summary: Global Cultural Assistant & Heritage Preservation Engine.
+Author: Aruna Olanrewaju Kabiru
+License-Expression: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: torch
+Requires-Dist: huggingface_hub
+
+# Agba Engine
+
+**Agba Engine** is a Global Cultural Assistant and Heritage Preservation Framework designed for high-performance retrieval, indexing, and preservation of cultural regalia, visual artifacts, and audio metadata across diverse global traditions.

agba_engine-5.0.0/agba_engine.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+agba_engine.egg-info/PKG-INFO
+agba_engine.egg-info/SOURCES.txt
+agba_engine.egg-info/dependency_links.txt
+agba_engine.egg-info/requires.txt
+agba_engine.egg-info/top_level.txt
+agba_engine/core/engine.py

agba_engine-5.0.0/agba_engine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

agba_engine-5.0.0/agba_engine.egg-info/requires.txt

@@ -0,0 +1,2 @@
+torch
+huggingface_hub

agba_engine-5.0.0/agba_engine.egg-info/top_level.txt

@@ -0,0 +1 @@
+

agba_engine-5.0.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agba_engine"
+version = "5.0.0"
+description = "Global Cultural Assistant & Heritage Preservation Engine."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    { name = "Aruna Olanrewaju Kabiru" }
+]
+dependencies = [
+    "torch",
+    "huggingface_hub"
+]

agba_engine-5.0.0/setup.cfg

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

agba_engine-5.0.0/setup.py

@@ -0,0 +1,7 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="agba_engine",
+    version="5.0.0",
+    packages=find_packages(),
+)