README.md

# 🧠 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`