lorien-memory 0.2.0__tar.gz

lorien_memory-0.2.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environment
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Kuzu DB data
+*.kuzu/
+.lorien/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# macOS
+.DS_Store

lorien_memory-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 paperbags1103-hash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lorien_memory-0.2.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.4
+Name: lorien-memory
+Version: 0.2.0
+Summary: Local-first personal knowledge graph for AI agents — ontology, causal chains, contradiction detection
+Project-URL: Homepage, https://github.com/paperbags1103-hash/lorien
+Project-URL: Repository, https://github.com/paperbags1103-hash/lorien
+Project-URL: Issues, https://github.com/paperbags1103-hash/lorien/issues
+Author: paperbags1103-hash
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,contradiction-detection,knowledge-graph,kuzu,llm,local-first,memory,ontology
+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.12
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.12
+Requires-Dist: click>=8.0
+Requires-Dist: kuzu>=0.8.0
+Provides-Extra: all
+Requires-Dist: numpy>=1.24; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Requires-Dist: sentence-transformers>=2.7.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: hatchling; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: llm
+Requires-Dist: openai>=1.0; extra == 'llm'
+Provides-Extra: vectors
+Requires-Dist: numpy>=1.24; extra == 'vectors'
+Requires-Dist: sentence-transformers>=2.7.0; extra == 'vectors'
+Description-Content-Type: text/markdown
+
+# 🌳 lorien
+
+**Local-first personal knowledge graph for AI agents.**  
+What to believe, why, and what conflicts — structured memory that Mem0 can't do.
+
+```bash
+pip install lorien-memory           # core (KuzuDB + CLI)
+pip install "lorien-memory[vectors]"  # + semantic search
+```
+
+---
+
+## Why lorien?
+
+| Feature | Mem0 | lorien |
+|---------|------|--------|
+| Conversation memory | ✅ | ✅ |
+| Semantic vector search | ✅ | ✅ |
+| Local (no server) | ❌ | ✅ |
+| Cost | $249/mo | **$0** |
+| Priority rule system | ❌ | ✅ |
+| Causal reasoning (CAUSED) | ❌ | ✅ |
+| **Auto contradiction detection** | ❌ | ✅ |
+
+lorien stores *structured knowledge* — not just flat strings. Every fact has a source, every rule has a priority, and contradictions are detected automatically.
+
+---
+
+## Quickstart
+
+```python
+from lorien import LorienMemory
+
+mem = LorienMemory(enable_vectors=True)
+
+# Add a conversation
+mem.add([
+    {"role": "user",      "content": "I have a severe shellfish allergy. Oysters send me to the ER."},
+    {"role": "assistant", "content": "Noted — I'll never recommend shellfish."},
+], user_id="alice")
+
+# 3 months later — new conversation
+mem.add([
+    {"role": "user",      "content": "Where should I eat tonight?"},
+    {"role": "assistant", "content": "The new oyster bar on Main St is great!"},
+], user_id="alice")
+
+# Semantic search — finds allergy even without exact keywords
+results = mem.search("seafood restrictions", user_id="alice")
+# → [{"memory": "User has severe shellfish allergy...", "score": 0.82}]
+
+# Auto-detected contradiction
+contradictions = mem.get_contradictions()
+# → [{"fact_a": "shellfish allergy...", "fact_b": "oyster bar recommendation..."}]
+
+# Hard rules with priority
+rules = mem.get_entity_rules("alice")
+# → [{"text": "Never recommend shellfish to alice", "priority": 100}]
+```
+
+---
+
+## Schema
+
+lorien uses [KuzuDB](https://kuzudb.com) — an embedded graph database (like SQLite, but for graphs).
+
+```
+Entity ─── HAS_RULE ───► Rule
+  │
+ABOUT
+  │
+  ▼
+Fact ─── CAUSED ──► Fact
+  │
+CONTRADICTS
+  │
+  ▼
+Fact
+```
+
+**3 node types:**
+- **Entity** — people, organizations, topics (`canonical_key = "type:name"`)
+- **Fact** — statements about entities (subject → predicate → object)
+- **Rule** — constraints with priority 0–100 (100 = absolute prohibition)
+
+**5 edge types:** `ABOUT`, `HAS_RULE`, `RELATED_TO`, `CAUSED`, `CONTRADICTS`
+
+---
+
+## CLI
+
+```bash
+# Initialize
+lorien init
+
+# Check status
+lorien status
+
+# Ingest a file (MEMORY.md, notes, etc.)
+lorien ingest MEMORY.md
+lorien ingest MEMORY.md --model haiku   # LLM extraction via OpenClaw
+
+# Query the graph
+lorien query "MATCH (e:Entity) RETURN e.name LIMIT 10"
+
+# Show entity details
+lorien show "alice"
+
+# List contradictions
+lorien contradictions
+
+# Conversation memory for a user
+lorien memory alice
+
+# Web visualization (vis.js, no extra deps)
+lorien serve
+```
+
+---
+
+## Contradiction Detection
+
+After every fact is ingested, lorien automatically checks for semantic contradictions:
+
+1. **Vector similarity** — find facts with similar meaning (threshold 0.55)
+2. **Heuristic check** — negation pair patterns (허용↔금지, always↔never, must↔must not, ...)
+3. **LLM confirmation** *(optional)* — yes/no question to any OpenAI-compatible model
+4. **CONTRADICTS edge** — auto-created in the graph for later querying
+
+```python
+detector = ContradictionDetector(
+    store=store,
+    vector_index=vi,
+    llm_model="gpt-4o-mini",
+    api_key="sk-...",
+    similarity_threshold=0.55,
+)
+n = detector.check_and_record(new_fact_id, new_fact_text)
+```
+
+---
+
+## OpenClaw Integration
+
+lorien auto-detects the [OpenClaw](https://github.com/openclaw/openclaw) gateway when available:
+
+```bash
+lorien ingest MEMORY.md --model haiku   # routes through OpenClaw → Anthropic
+lorien ingest notes.md  --model flash   # routes through OpenClaw → Gemini
+```
+
+No API key needed when OpenClaw gateway is running locally.
+
+---
+
+## Installation
+
+```bash
+# Core only (graph + CLI, no LLM, no vectors)
+pip install lorien-memory
+
+# With semantic search
+pip install "lorien-memory[vectors]"
+
+# With OpenAI-compatible LLM extraction
+pip install "lorien-memory[llm]"
+
+# Everything
+pip install "lorien-memory[all]"
+```
+
+**Requirements:** Python 3.12+, no server, no Docker.  
+DB stored at `~/.lorien/db`. Vectors at `~/.lorien/vectors.db`.
+
+---
+
+## Roadmap
+
+- [x] v0.1 — Core graph schema (Entity, Fact, Rule + 5 edge types)
+- [x] v0.1 — LLM ingest via OpenClaw gateway
+- [x] v0.1 — Mem0-compatible `LorienMemory` API
+- [x] v0.2 — Vector semantic search (sentence-transformers, multilingual)
+- [x] v0.2 — Automatic contradiction detection
+- [ ] v0.2 — PyPI release (`pip install lorien-memory`)
+- [ ] v1.0 — Web graph visualization
+- [ ] v1.0 — LangChain adapter
+
+---
+
+## vs Mem0
+
+Mem0 answers: *"What did the user say?"*  
+lorien answers: *"What should I believe, why, and does it contradict anything?"*
+
+Use both. They're complementary, not competitors.
+
+---
+
+MIT License · [GitHub](https://github.com/paperbags1103-hash/lorien)

lorien_memory-0.2.0/README.md

@@ -0,0 +1,199 @@
+# 🌳 lorien
+
+**Local-first personal knowledge graph for AI agents.**  
+What to believe, why, and what conflicts — structured memory that Mem0 can't do.
+
+```bash
+pip install lorien-memory           # core (KuzuDB + CLI)
+pip install "lorien-memory[vectors]"  # + semantic search
+```
+
+---
+
+## Why lorien?
+
+| Feature | Mem0 | lorien |
+|---------|------|--------|
+| Conversation memory | ✅ | ✅ |
+| Semantic vector search | ✅ | ✅ |
+| Local (no server) | ❌ | ✅ |
+| Cost | $249/mo | **$0** |
+| Priority rule system | ❌ | ✅ |
+| Causal reasoning (CAUSED) | ❌ | ✅ |
+| **Auto contradiction detection** | ❌ | ✅ |
+
+lorien stores *structured knowledge* — not just flat strings. Every fact has a source, every rule has a priority, and contradictions are detected automatically.
+
+---
+
+## Quickstart
+
+```python
+from lorien import LorienMemory
+
+mem = LorienMemory(enable_vectors=True)
+
+# Add a conversation
+mem.add([
+    {"role": "user",      "content": "I have a severe shellfish allergy. Oysters send me to the ER."},
+    {"role": "assistant", "content": "Noted — I'll never recommend shellfish."},
+], user_id="alice")
+
+# 3 months later — new conversation
+mem.add([
+    {"role": "user",      "content": "Where should I eat tonight?"},
+    {"role": "assistant", "content": "The new oyster bar on Main St is great!"},
+], user_id="alice")
+
+# Semantic search — finds allergy even without exact keywords
+results = mem.search("seafood restrictions", user_id="alice")
+# → [{"memory": "User has severe shellfish allergy...", "score": 0.82}]
+
+# Auto-detected contradiction
+contradictions = mem.get_contradictions()
+# → [{"fact_a": "shellfish allergy...", "fact_b": "oyster bar recommendation..."}]
+
+# Hard rules with priority
+rules = mem.get_entity_rules("alice")
+# → [{"text": "Never recommend shellfish to alice", "priority": 100}]
+```
+
+---
+
+## Schema
+
+lorien uses [KuzuDB](https://kuzudb.com) — an embedded graph database (like SQLite, but for graphs).
+
+```
+Entity ─── HAS_RULE ───► Rule
+  │
+ABOUT
+  │
+  ▼
+Fact ─── CAUSED ──► Fact
+  │
+CONTRADICTS
+  │
+  ▼
+Fact
+```
+
+**3 node types:**
+- **Entity** — people, organizations, topics (`canonical_key = "type:name"`)
+- **Fact** — statements about entities (subject → predicate → object)
+- **Rule** — constraints with priority 0–100 (100 = absolute prohibition)
+
+**5 edge types:** `ABOUT`, `HAS_RULE`, `RELATED_TO`, `CAUSED`, `CONTRADICTS`
+
+---
+
+## CLI
+
+```bash
+# Initialize
+lorien init
+
+# Check status
+lorien status
+
+# Ingest a file (MEMORY.md, notes, etc.)
+lorien ingest MEMORY.md
+lorien ingest MEMORY.md --model haiku   # LLM extraction via OpenClaw
+
+# Query the graph
+lorien query "MATCH (e:Entity) RETURN e.name LIMIT 10"
+
+# Show entity details
+lorien show "alice"
+
+# List contradictions
+lorien contradictions
+
+# Conversation memory for a user
+lorien memory alice
+
+# Web visualization (vis.js, no extra deps)
+lorien serve
+```
+
+---
+
+## Contradiction Detection
+
+After every fact is ingested, lorien automatically checks for semantic contradictions:
+
+1. **Vector similarity** — find facts with similar meaning (threshold 0.55)
+2. **Heuristic check** — negation pair patterns (허용↔금지, always↔never, must↔must not, ...)
+3. **LLM confirmation** *(optional)* — yes/no question to any OpenAI-compatible model
+4. **CONTRADICTS edge** — auto-created in the graph for later querying
+
+```python
+detector = ContradictionDetector(
+    store=store,
+    vector_index=vi,
+    llm_model="gpt-4o-mini",
+    api_key="sk-...",
+    similarity_threshold=0.55,
+)
+n = detector.check_and_record(new_fact_id, new_fact_text)
+```
+
+---
+
+## OpenClaw Integration
+
+lorien auto-detects the [OpenClaw](https://github.com/openclaw/openclaw) gateway when available:
+
+```bash
+lorien ingest MEMORY.md --model haiku   # routes through OpenClaw → Anthropic
+lorien ingest notes.md  --model flash   # routes through OpenClaw → Gemini
+```
+
+No API key needed when OpenClaw gateway is running locally.
+
+---
+
+## Installation
+
+```bash
+# Core only (graph + CLI, no LLM, no vectors)
+pip install lorien-memory
+
+# With semantic search
+pip install "lorien-memory[vectors]"
+
+# With OpenAI-compatible LLM extraction
+pip install "lorien-memory[llm]"
+
+# Everything
+pip install "lorien-memory[all]"
+```
+
+**Requirements:** Python 3.12+, no server, no Docker.  
+DB stored at `~/.lorien/db`. Vectors at `~/.lorien/vectors.db`.
+
+---
+
+## Roadmap
+
+- [x] v0.1 — Core graph schema (Entity, Fact, Rule + 5 edge types)
+- [x] v0.1 — LLM ingest via OpenClaw gateway
+- [x] v0.1 — Mem0-compatible `LorienMemory` API
+- [x] v0.2 — Vector semantic search (sentence-transformers, multilingual)
+- [x] v0.2 — Automatic contradiction detection
+- [ ] v0.2 — PyPI release (`pip install lorien-memory`)
+- [ ] v1.0 — Web graph visualization
+- [ ] v1.0 — LangChain adapter
+
+---
+
+## vs Mem0
+
+Mem0 answers: *"What did the user say?"*  
+lorien answers: *"What should I believe, why, and does it contradict anything?"*
+
+Use both. They're complementary, not competitors.
+
+---
+
+MIT License · [GitHub](https://github.com/paperbags1103-hash/lorien)

lorien_memory-0.2.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lorien-memory"
+version = "0.2.0"
+description = "Local-first personal knowledge graph for AI agents — ontology, causal chains, contradiction detection"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+authors = [{ name = "paperbags1103-hash" }]
+keywords = [
+    "ai", "agents", "memory", "knowledge-graph", "ontology",
+    "kuzu", "llm", "contradiction-detection", "local-first"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Database",
+]
+
+dependencies = [
+    "kuzu>=0.8.0",
+    "click>=8.0",
+]
+
+[project.optional-dependencies]
+vectors = ["sentence-transformers>=2.7.0", "numpy>=1.24"]
+llm    = ["openai>=1.0"]
+all    = ["sentence-transformers>=2.7.0", "numpy>=1.24", "openai>=1.0"]
+dev    = ["pytest>=8.0", "hatchling"]
+
+[project.urls]
+Homepage   = "https://github.com/paperbags1103-hash/lorien"
+Repository = "https://github.com/paperbags1103-hash/lorien"
+Issues     = "https://github.com/paperbags1103-hash/lorien/issues"
+
+[project.scripts]
+lorien = "lorien.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lorien"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "tests/", "README.md", "LICENSE"]

lorien_memory-0.2.0/src/lorien/__init__.py

@@ -0,0 +1,17 @@
+from .contradiction import ContradictionDetector
+from .ingest import LorienIngester
+from .memory import LorienMemory
+from .models import Entity, Fact, Rule
+from .query import KnowledgeGraph
+from .schema import GraphStore
+
+__all__ = [
+    "ContradictionDetector",
+    "Entity",
+    "Fact",
+    "Rule",
+    "GraphStore",
+    "KnowledgeGraph",
+    "LorienIngester",
+    "LorienMemory",
+]