File size: 2,059 Bytes
abff226 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | # 🧠 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`
|