limbicdb 0.1.0__tar.gz

limbicdb-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: limbicdb
+Version: 0.1.0
+Summary: Debuggable memory layer for AI agents
+Author-email: Kousoyu <770668004@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Kousoyu/limbicdb
+Project-URL: Repository, https://github.com/Kousoyu/limbicdb
+Project-URL: Documentation, https://github.com/Kousoyu/limbicdb
+Keywords: ai,memory,debuggable,agents,llm
+Classifier: Development Status :: 3 - Alpha
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# LimbicDB Python SDK
+
+Debuggable memory layer for AI agents
+
+## Installation
+
+```bash
+pip install limbicdb
+```
+
+> **Note**: This package requires [LimbicDB](https://github.com/Kousoyu/limbicdb) to be installed locally.
+> The Python SDK is a thin wrapper around the LimbicDB CLI.
+
+## Quick Start
+
+```python
+from limbicdb import Memory
+
+# Initialize memory with default path
+memory = Memory()
+
+# Explain memory retrieval decisions
+explanation = memory.explain("anime")
+print(explanation)
+
+# Check for conflicts
+if explanation["conflicts"]:
+    print("⚠️  Conflicting memories detected!")
+```
+
+## Features
+
+- **Explainable Memory**: See why your AI retrieved specific memories
+- **Conflict Detection**: Identify contradictory information in your memory
+- **Decision Tracing**: Understand the full retrieval process
+- **LangChain Integration**: Use as a drop-in replacement for LangChain memory
+
+## LangChain Integration
+
+```python
+from langchain.memory import ConversationBufferMemory
+from limbicdb import Memory
+
+# Create LimbicDB memory
+limbic_memory = Memory()
+
+# Use in LangChain agent
+agent = Agent(
+    memory=limbic_memory,
+    # ... other agent configuration
+)
+
+# After agent runs, explain decisions
+explanation = limbic_memory.explain("user query")
+```
+
+## Requirements
+
+- Python 3.8+
+- Node.js 18+
+- LimbicDB installed locally
+
+## Philosophy
+
+Memory should not be a black box. LimbicDB makes AI memory observable, explainable, and controllable.
+
+## License
+
+MIT

limbicdb-0.1.0/README.md

@@ -0,0 +1,69 @@
+# LimbicDB Python SDK
+
+Debuggable memory layer for AI agents
+
+## Installation
+
+```bash
+pip install limbicdb
+```
+
+> **Note**: This package requires [LimbicDB](https://github.com/Kousoyu/limbicdb) to be installed locally.
+> The Python SDK is a thin wrapper around the LimbicDB CLI.
+
+## Quick Start
+
+```python
+from limbicdb import Memory
+
+# Initialize memory with default path
+memory = Memory()
+
+# Explain memory retrieval decisions
+explanation = memory.explain("anime")
+print(explanation)
+
+# Check for conflicts
+if explanation["conflicts"]:
+    print("⚠️  Conflicting memories detected!")
+```
+
+## Features
+
+- **Explainable Memory**: See why your AI retrieved specific memories
+- **Conflict Detection**: Identify contradictory information in your memory
+- **Decision Tracing**: Understand the full retrieval process
+- **LangChain Integration**: Use as a drop-in replacement for LangChain memory
+
+## LangChain Integration
+
+```python
+from langchain.memory import ConversationBufferMemory
+from limbicdb import Memory
+
+# Create LimbicDB memory
+limbic_memory = Memory()
+
+# Use in LangChain agent
+agent = Agent(
+    memory=limbic_memory,
+    # ... other agent configuration
+)
+
+# After agent runs, explain decisions
+explanation = limbic_memory.explain("user query")
+```
+
+## Requirements
+
+- Python 3.8+
+- Node.js 18+
+- LimbicDB installed locally
+
+## Philosophy
+
+Memory should not be a black box. LimbicDB makes AI memory observable, explainable, and controllable.
+
+## License
+
+MIT

limbicdb-0.1.0/limbicdb/__init__.py

@@ -0,0 +1,9 @@
+"""
+LimbicDB Python SDK
+Debuggable memory layer for AI agents
+"""
+
+from .memory import Memory
+
+__version__ = "0.1.0"
+__author__ = "Kousoyu"

limbicdb-0.1.0/limbicdb/memory.py

@@ -0,0 +1,164 @@
+"""
+LimbicDB Memory Class
+Thin wrapper around LimbicDB CLI commands
+"""
+
+import subprocess
+import json
+import os
+from typing import List, Dict, Any, Optional
+
+class MemoryError(Exception):
+    """Base exception for LimbicDB errors"""
+    pass
+
+class Memory:
+    """
+    LimbicDB Memory interface for Python
+    
+    This class provides a thin wrapper around the LimbicDB CLI,
+    allowing Python applications to use LimbicDB's debuggable memory features.
+    """
+    
+    def __init__(self, path: str = ".limbic", limbicdb_path: Optional[str] = None):
+        """
+        Initialize LimbicDB Memory
+        
+        Args:
+            path: Path to the .limbic database file
+            limbicdb_path: Path to the LimbicDB installation directory
+                          If not provided, will look for LIMBICDB_PATH env var
+                          or default to current working directory
+        """
+        self.path = path
+        self.limbicdb_path = limbicdb_path or os.environ.get('LIMBICDB_PATH', '.')
+        
+        # Verify LimbicDB is available
+        if not self._check_limbicdb_available():
+            raise MemoryError(f"LimbicDB not found at {self.limbicdb_path}")
+    
+    def _check_limbicdb_available(self) -> bool:
+        """Check if LimbicDB CLI is available"""
+        try:
+            result = subprocess.run(
+                ["npm", "list", "--depth=0"],
+                cwd=self.limbicdb_path,
+                capture_output=True,
+                text=True
+            )
+            return "limbicdb" in result.stdout
+        except (subprocess.SubprocessError, FileNotFoundError):
+            return False
+    
+    def _run_cli(self, command: str, args: List[str]) -> Dict[str, Any]:
+        """
+        Execute LimbicDB CLI command and return JSON result
+        
+        Args:
+            command: CLI command name (e.g., "explain")
+            args: Command arguments
+            
+        Returns:
+            Parsed JSON output from CLI
+            
+        Raises:
+            MemoryError: If CLI command fails
+        """
+        # Build command - use npm run for better compatibility
+        cmd = ["npm", "run", command, "--"] + args + ["--json"]
+        
+        try:
+            result = subprocess.run(
+                cmd,
+                cwd=self.limbicdb_path,
+                capture_output=True,
+                text=True,
+                timeout=20  # 20 second timeout
+            )
+            
+            if result.returncode != 0:
+                error_msg = result.stderr or result.stdout
+                raise MemoryError(f"CLI command failed: {error_msg}")
+            
+            # Parse JSON output
+            try:
+                return json.loads(result.stdout)
+            except json.JSONDecodeError:
+                # If no JSON output, return empty dict
+                return {}
+                
+        except subprocess.TimeoutExpired:
+            raise MemoryError("CLI command timed out")
+        except Exception as e:
+            raise MemoryError(f"CLI execution error: {str(e)}")
+    
+    def explain(self, query: str) -> Dict[str, Any]:
+        """
+        Explain memory retrieval decisions
+        
+        Args:
+            query: Search query to explain
+            
+        Returns:
+            Dictionary containing explanation with structure:
+            {
+                "query": str,
+                "selectedMemory": Memory object or None,
+                "candidates": List[{
+                    "memory": Memory object,
+                    "score": float,
+                    "reasons": List[str]
+                }],
+                "conflicts": bool,
+                "decisionTrace": List[str]
+            }
+        """
+        return self._run_cli("explain", [query])
+    
+    def remember(self, content: str) -> Dict[str, Any]:
+        """
+        Add memory to database
+        
+        Args:
+            content: Memory content to store
+            
+        Returns:
+            Dictionary with success status and content
+        """
+        return self._run_cli("remember", [content])
+    
+    def search(self, query: str) -> Dict[str, Any]:
+        """
+        Search memories by query
+        
+        Args:
+            query: Search query
+            
+        Returns:
+            Dictionary containing query and results list
+        """
+        return self._run_cli("search", [query])
+    
+    def timeline(self, query: str) -> Dict[str, Any]:
+        """
+        Get memory timeline for query
+        
+        Args:
+            query: Query to filter timeline
+            
+        Returns:
+            Dictionary containing query and memories list
+        """
+        return self._run_cli("timeline", [query])
+    
+    def forget(self, content: str) -> Dict[str, Any]:
+        """
+        Remove memory from database
+        
+        Args:
+            content: Memory content to delete
+            
+        Returns:
+            Dictionary with success status and deletion count
+        """
+        return self._run_cli("forget", [content])

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

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: limbicdb
+Version: 0.1.0
+Summary: Debuggable memory layer for AI agents
+Author-email: Kousoyu <770668004@qq.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Kousoyu/limbicdb
+Project-URL: Repository, https://github.com/Kousoyu/limbicdb
+Project-URL: Documentation, https://github.com/Kousoyu/limbicdb
+Keywords: ai,memory,debuggable,agents,llm
+Classifier: Development Status :: 3 - Alpha
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# LimbicDB Python SDK
+
+Debuggable memory layer for AI agents
+
+## Installation
+
+```bash
+pip install limbicdb
+```
+
+> **Note**: This package requires [LimbicDB](https://github.com/Kousoyu/limbicdb) to be installed locally.
+> The Python SDK is a thin wrapper around the LimbicDB CLI.
+
+## Quick Start
+
+```python
+from limbicdb import Memory
+
+# Initialize memory with default path
+memory = Memory()
+
+# Explain memory retrieval decisions
+explanation = memory.explain("anime")
+print(explanation)
+
+# Check for conflicts
+if explanation["conflicts"]:
+    print("⚠️  Conflicting memories detected!")
+```
+
+## Features
+
+- **Explainable Memory**: See why your AI retrieved specific memories
+- **Conflict Detection**: Identify contradictory information in your memory
+- **Decision Tracing**: Understand the full retrieval process
+- **LangChain Integration**: Use as a drop-in replacement for LangChain memory
+
+## LangChain Integration
+
+```python
+from langchain.memory import ConversationBufferMemory
+from limbicdb import Memory
+
+# Create LimbicDB memory
+limbic_memory = Memory()
+
+# Use in LangChain agent
+agent = Agent(
+    memory=limbic_memory,
+    # ... other agent configuration
+)
+
+# After agent runs, explain decisions
+explanation = limbic_memory.explain("user query")
+```
+
+## Requirements
+
+- Python 3.8+
+- Node.js 18+
+- LimbicDB installed locally
+
+## Philosophy
+
+Memory should not be a black box. LimbicDB makes AI memory observable, explainable, and controllable.
+
+## License
+
+MIT

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

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

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+limbicdb

limbicdb-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "limbicdb"
+version = "0.1.0"
+description = "Debuggable memory layer for AI agents"
+readme = "README.md"
+authors = [{name = "Kousoyu", email = "770668004@qq.com"}]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "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",
+]
+keywords = ["ai", "memory", "debuggable", "agents", "llm"]
+dependencies = []
+requires-python = ">=3.8"
+
+[project.urls]
+Homepage = "https://github.com/Kousoyu/limbicdb"
+Repository = "https://github.com/Kousoyu/limbicdb"
+Documentation = "https://github.com/Kousoyu/limbicdb"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["limbicdb*"]

limbicdb-0.1.0/setup.cfg

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