Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,78 @@
+# 🧠 Conversation Memory System
+
+A self-contained, local-first conversation memory system that replaces the fraudulent [MemPalace](https://github.com/MemPalace/mempalace/issues/618) project with real working code.
+
+## Why not MemPalace?
+
+MemPalace is a **scam repository** — no actual source code, fake 22K+ stars, empty PyPI package. This system is the real deal: SQLite + sentence-transformers, zero external API dependencies.
+
+## Features
+
+- 💾 **SQLite persistence** — conversations stored locally
+- 🔍 **Text search** — find any past conversation
+- 🧮 **Vector embeddings** — semantic search via sentence-transformers (optional)
+- 📤 **Export** — JSON or Markdown output
+- 🖥️ **CLI** — command-line interface for search/retrieve
+- 🔌 **Zero external APIs** — works offline
+
+## Quick Start
+
+```bash
+pip install sentence-transformers
+python memory_system.py
+```
+
+## CLI Usage
+
+```bash
+# Search memories
+python memory_cli.py search "ZeroGPU"
+
+# List all threads
+python memory_cli.py threads
+
+# Show a specific thread
+python memory_cli.py show cydonia-space-setup-20260430-215601
+
+# Export all memories
+python memory_cli.py export --all
+```
+
+## Python API
+
+```python
+from memory_system import ConversationMemory
+
+memory = ConversationMemory(user_id="scottzilla")
+
+# Save a message
+memory.save_message("user", "Hello!", thread_id="my-thread")
+
+# Save a full conversation
+memory.save_conversation([
+    {"role": "user", "content": "Hi"},
+    {"role": "assistant", "content": "Hello!"}
+], thread_id="my-thread")
+
+# Search
+results = memory.search("model loading")
+
+# Get thread history
+messages = memory.get_thread("my-thread")
+
+# Export
+memory.export_to_markdown("conversation.md", "my-thread")
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `memory_system.py` | Core memory class |
+| `memory_cli.py` | Command-line interface |
+
+## Saved Conversations
+
+This repo includes the exported conversation about fixing the Cydonia-24B Space:
+- `cydonia-space-setup-20260430-215601.json`
+- `cydonia-space-setup-20260430-215601.md`