File size: 1,281 Bytes
6db3a7e
b69cdd6
 
 
6db3a7e
 
 
 
 
b69cdd6
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
---
title: Conversation Memory System
emoji: ๐Ÿ’พ
colorFrom: blue
colorTo: green
sdk: gradio
pinned: false
---

# ๐Ÿ’พ Conversation Memory System

SQLite-backed conversation tracker with text search, semantic search, and Markdown export. Fully offline.

## Features
- ๐Ÿ’พ **SQLite persistence** โ€” no external services
- ๐Ÿ” **Text search** โ€” LIKE queries across all memories  
- ๐Ÿงฎ **Vector embeddings** โ€” semantic search when `sentence-transformers` is installed
- ๐Ÿ“ค **Export** โ€” Markdown for any thread or all conversations
- ๐Ÿ”Œ **Zero external APIs** โ€” works fully offline

## Usage

### Save a message
Use the **Save** tab to store conversations from any source (user, assistant, system, agent-zero).

### Search
- **Text search**: Fast LIKE-based search across all message content
- **Semantic search**: Requires `sentence-transformers` (auto-detected)

### Export
Export individual threads or all conversations to Markdown.

## API Integration
```python
import requests

# Save a message
requests.post("https://scottzillasystems-conversation-memory.hf.space/api/save", json={
    "role": "user",
    "content": "Hello!",
    "thread_id": "my-thread"
})

# Search
requests.get("https://scottzillasystems-conversation-memory.hf.space/api/search?q=hello")
```