synapse-memory-engine 1.3.0__tar.gz

synapse_memory_engine-1.3.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: synapse-memory-engine
+Version: 1.3.0
+Summary: Production-grade active RAG & cognitive memory engine with multi-tenancy, pgvector HNSW indexing, semantic deduplication, decay-based pruning, and token-aware context packing.
+Home-page: https://github.com/721189/Synapse-Memory
+Author: Synapse Cognitive Systems
+Author-email: Synapse Cognitive Systems <singhshivam20009@gmail.com>
+Project-URL: Homepage, https://github.com/721189/Synapse-Memory
+Project-URL: Bug Tracker, https://github.com/721189/Synapse-Memory/issues
+Project-URL: Documentation, https://github.com/721189/Synapse-Memory#readme
+Project-URL: Repository, https://github.com/721189/Synapse-Memory.git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: uvicorn>=0.34.0
+Requires-Dist: cryptography>=42.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: urllib3>=2.8.0
+Provides-Extra: local-models
+Requires-Dist: sentence-transformers>=5.0.0; extra == "local-models"
+Provides-Extra: pgvector
+Requires-Dist: psycopg2-binary>=2.9.9.1; extra == "pgvector"
+Requires-Dist: pgvector>=0.4.0; extra == "pgvector"
+Provides-Extra: redis
+Requires-Dist: redis>=5.0.0; extra == "redis"
+Provides-Extra: langchain
+Requires-Dist: langchain-core>=0.3.0; extra == "langchain"
+Provides-Extra: llamaindex
+Requires-Dist: llama-index-core>=0.13.0; extra == "llamaindex"
+Provides-Extra: all
+Requires-Dist: sentence-transformers>=5.0.0; extra == "all"
+Requires-Dist: psycopg2-binary>=2.9.9.1; extra == "all"
+Requires-Dist: pgvector>=0.4.0; extra == "all"
+Requires-Dist: langchain-core>=0.3.0; extra == "all"
+Requires-Dist: llama-index-core>=0.13.0; extra == "all"
+Requires-Dist: redis>=5.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: flake8>=7.0.0; extra == "dev"
+Requires-Dist: mypy>=1.13.0; extra == "dev"
+Requires-Dist: bandit>=1.8.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: types-requests>=2.32.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# Synapse Memory Python SDK
+
+Core Python SDK and algorithms for the Synapse Cognitive Memory substrate.
+
+## Features
+
+- **Encrypted SQLite Storage**: Fernet AES-128-CBC with HMAC-SHA256 authenticated encryption at rest.
+- **Dynamic Programming Knapsack Packing**: Exact 0/1 Knapsack optimizer for packing high-relevance memories into strict token envelopes.
+- **Ebbinghaus Decay Engine**: Continuous temporal decay with positive/negative reinforcement factors.
+- **Semantic Deduplication**: Dual lexical Jaccard and dense cosine similarity detection to prevent node fragmentation.
+- **Hybrid Retrieval**: BM25 sparse lexical ranking fused with dense vector embeddings via Reciprocal Rank Fusion (RRF).
+- **Framework Integrations**: True drop-in adapters for LangChain (`BaseMemory`) and LlamaIndex (`BaseMemory`).
+
+## Installation
+
+```bash
+pip install synapse-memory-engine          # from PyPI
+# or, from a checkout of this repository:
+pip install -e .
+```
+
+## Testing
+
+```bash
+python3 -m unittest discover -s tests
+```

synapse_memory_engine-1.3.0/README.md

@@ -0,0 +1,26 @@
+# Synapse Memory Python SDK
+
+Core Python SDK and algorithms for the Synapse Cognitive Memory substrate.
+
+## Features
+
+- **Encrypted SQLite Storage**: Fernet AES-128-CBC with HMAC-SHA256 authenticated encryption at rest.
+- **Dynamic Programming Knapsack Packing**: Exact 0/1 Knapsack optimizer for packing high-relevance memories into strict token envelopes.
+- **Ebbinghaus Decay Engine**: Continuous temporal decay with positive/negative reinforcement factors.
+- **Semantic Deduplication**: Dual lexical Jaccard and dense cosine similarity detection to prevent node fragmentation.
+- **Hybrid Retrieval**: BM25 sparse lexical ranking fused with dense vector embeddings via Reciprocal Rank Fusion (RRF).
+- **Framework Integrations**: True drop-in adapters for LangChain (`BaseMemory`) and LlamaIndex (`BaseMemory`).
+
+## Installation
+
+```bash
+pip install synapse-memory-engine          # from PyPI
+# or, from a checkout of this repository:
+pip install -e .
+```
+
+## Testing
+
+```bash
+python3 -m unittest discover -s tests
+```

synapse_memory_engine-1.3.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+# Published as `synapse-memory-engine` on PyPI — the `synapse-memory` name is
+# owned by an unrelated third-party project. Import package stays `synapse_memory`.
+# See docs/publishing.md.
+name = "synapse-memory-engine"
+version = "1.3.0"
+authors = [{name = "Synapse Cognitive Systems", email = "singhshivam20009@gmail.com"}]
+description = "Production-grade active RAG & cognitive memory engine with multi-tenancy, pgvector HNSW indexing, semantic deduplication, decay-based pruning, and token-aware context packing."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "fastapi>=0.115.0",
+    "pydantic>=2.10.0",
+    "uvicorn>=0.34.0",
+    "cryptography>=42.0.0",
+    "requests>=2.31.0",
+    "numpy>=1.26.0",
+    # Direct floor for the HTTP dependency graph: the resolver otherwise picks
+    # urllib3 2.7.x, which the image scan flags (CVE-2026-97687 / CVE-2026-97689).
+    "urllib3>=2.8.0"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/721189/Synapse-Memory"
+"Bug Tracker" = "https://github.com/721189/Synapse-Memory/issues"
+"Documentation" = "https://github.com/721189/Synapse-Memory#readme"
+"Repository" = "https://github.com/721189/Synapse-Memory.git"
+
+[project.optional-dependencies]
+local-models = [
+    "sentence-transformers>=5.0.0"
+]
+pgvector = [
+    "psycopg2-binary>=2.9.9.1",
+    "pgvector>=0.4.0"
+]
+redis = [
+    "redis>=5.0.0"
+]
+langchain = [
+    "langchain-core>=0.3.0"
+]
+llamaindex = [
+    "llama-index-core>=0.13.0"
+]
+all = [
+    "sentence-transformers>=5.0.0",
+    "psycopg2-binary>=2.9.9.1",
+    "pgvector>=0.4.0",
+    "langchain-core>=0.3.0",
+    "llama-index-core>=0.13.0",
+    "redis>=5.0.0"
+]
+dev = [
+    "flake8>=7.0.0",
+    "mypy>=1.13.0",
+    "bandit>=1.8.0",
+    "pytest>=8.0.0",
+    # Required by fastapi.testclient.TestClient -> starlette.testclient
+    "httpx>=0.27.0",
+    # NOTE: types-cryptography is intentionally absent. Its last release is
+    # 3.3.23.x, so any `types-cryptography>=42` pin is unsatisfiable; cryptography
+    # itself ships inline types (py.typed) since 3.4, and this project requires
+    # >=42, so mypy reads the real annotations from the package.
+    "types-requests>=2.32.0"
+]
+
+[project.scripts]
+synapse-memory = "synapse_memory.cli.synapse_cli:main"
+synapse = "synapse_memory.cli.synapse_cli:main"
+synapse-cli = "synapse_memory.cli.synapse_cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["synapse_memory*"]
+
+[tool.setuptools.package-data]
+# Ship the PEP 561 marker so downstream type checkers use our annotations.
+synapse_memory = ["py.typed"]

synapse_memory_engine-1.3.0/setup.cfg

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

synapse_memory_engine-1.3.0/setup.py

@@ -0,0 +1,49 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="synapse-memory-engine",
+    version="1.2.0",
+    description="Sovereign, active RAG & cognitive long-term memory engine for AI agents",
+    author="Synapse Cognitive Systems",
+    author_email="synapse-memory@users.noreply.github.com",
+    url="https://github.com/721189/Synapse-Memory",
+    license="All Rights Reserved",
+    packages=find_packages(include=["synapse_memory*"]),
+    python_requires=">=3.10",
+    install_requires=[
+        "fastapi>=0.115.0",
+        "pydantic>=2.10.0",
+        "uvicorn>=0.34.0",
+        "cryptography>=42.0.0",
+        "requests>=2.31.0",
+        "numpy>=1.26.0",
+    ],
+    extras_require={
+        "local-models": ["sentence-transformers>=5.0.0"],
+        "pgvector": ["psycopg2-binary>=2.9.9.1", "pgvector>=0.4.0"],
+        "langchain": ["langchain-core>=0.3.0"],
+        "llamaindex": ["llama-index-core>=0.13.0"],
+        "all": [
+            "sentence-transformers>=5.0.0",
+            "psycopg2-binary>=2.9.9.1",
+            "pgvector>=0.4.0",
+            "langchain-core>=0.3.0",
+            "llama-index-core>=0.13.0",
+        ],
+        "dev": [
+            "flake8>=7.0.0",
+            "mypy>=1.13.0",
+            "bandit>=1.8.0",
+            "pytest>=8.0.0",
+            "types-cryptography>=42.0.0",
+            "types-requests>=2.32.0",
+        ],
+    },
+    entry_points={
+        "console_scripts": [
+            "synapse-memory=synapse_memory.cli.synapse_cli:main",
+            "synapse=synapse_memory.cli.synapse_cli:main",
+            "synapse-cli=synapse_memory.cli.synapse_cli:main",
+        ]
+    }
+)

synapse_memory_engine-1.3.0/synapse_memory/__init__.py

@@ -0,0 +1,31 @@
+from synapse_memory.core.memory_manager import MemoryManager
+from synapse_memory.core.sqlite_db import SQLiteMemoryStore
+from synapse_memory.core.pgvector_db import PGVectorMemoryStore
+from synapse_memory.core.auth import SecurityManager
+from synapse_memory.core.embedder import SynapseEmbedder
+from synapse_memory.core.hybrid_search import HybridSearch
+from synapse_memory.core.knapsack_packer import KnapsackPacker
+from synapse_memory.core.decay_engine import DecayEngine
+from synapse_memory.integrations.langchain import SynapseLangChainMemory
+from synapse_memory.integrations.llamaindex import SynapseLlamaIndexMemory
+from synapse_memory.client import SynapseClient, SynapseError, CreateResult, QueryResult
+
+__version__ = "1.3.0"
+__api_compat_version__ = "v1"
+
+__all__ = [
+    "MemoryManager",
+    "SQLiteMemoryStore",
+    "PGVectorMemoryStore",
+    "SecurityManager",
+    "SynapseEmbedder",
+    "HybridSearch",
+    "KnapsackPacker",
+    "DecayEngine",
+    "SynapseLangChainMemory",
+    "SynapseLlamaIndexMemory",
+    "SynapseClient",
+    "SynapseError",
+    "CreateResult",
+    "QueryResult",
+]