ScottzillaSystems/conversation-memory

1# 🧠 Conversation Memory System2 3A self-contained, local-first conversation memory system that replaces the fraudulent [MemPalace](https://github.com/MemPalace/mempalace/issues/618) project with real working code.4 5## Why not MemPalace?6 7MemPalace 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.8 9## Features10 11- 💾 **SQLite persistence** — conversations stored locally12- 🔍 **Text search** — find any past conversation13- 🧮 **Vector embeddings** — semantic search via sentence-transformers (optional)14- 📤 **Export** — JSON or Markdown output15- 🖥️ **CLI** — command-line interface for search/retrieve16- 🔌 **Zero external APIs** — works offline17 18## Quick Start19 20```bash21pip install sentence-transformers22python memory_system.py23```24 25## CLI Usage26 27```bash28# Search memories29python memory_cli.py search "ZeroGPU"30 31# List all threads32python memory_cli.py threads33 34# Show a specific thread35python memory_cli.py show cydonia-space-setup-20260430-21560136 37# Export all memories38python memory_cli.py export --all39```40 41## Python API42 43```python44from memory_system import ConversationMemory45 46memory = ConversationMemory(user_id="scottzilla")47 48# Save a message49memory.save_message("user", "Hello!", thread_id="my-thread")50 51# Save a full conversation52memory.save_conversation([53    {"role": "user", "content": "Hi"},54    {"role": "assistant", "content": "Hello!"}55], thread_id="my-thread")56 57# Search58results = memory.search("model loading")59 60# Get thread history61messages = memory.get_thread("my-thread")62 63# Export64memory.export_to_markdown("conversation.md", "my-thread")65```66 67## Files68 69| File | Purpose |70|------|---------|71| `memory_system.py` | Core memory class |72| `memory_cli.py` | Command-line interface |73 74## Saved Conversations75 76This repo includes the exported conversation about fixing the Cydonia-24B Space:77- `cydonia-space-setup-20260430-215601.json`78- `cydonia-space-setup-20260430-215601.md`79