# 🎬 Demo Script & Testing Guide

## Quick Start Testing

### 1. Test Gradio Interface
1. Visit the Hugging Face Space
2. Try saving a memory in the "Save Memory" tab
3. Search for it in the "Search Memory" tab
4. Browse all memories in the "Browse Memories" tab

### 2. Test MCP Server with Claude Desktop

#### Setup:
1. Add to your `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "long-term-memory": {
      "command": "python",
      "args": ["run_mcp_server.py"],
      "env": {},
      "cwd": "/path/to/your/project"
    }
  }
}
```

2. Restart Claude Desktop

## Demo Scenarios

### Scenario 1: Philosophy Student
1. Save insights from reading different philosophers
2. Search for connections between ideas
3. Build upon previous understanding in new discussions

### Scenario 2: Research Notes
1. Save key findings from papers
2. Find related research using semantic search
3. Synthesize knowledge across sessions

### Scenario 3: Personal Development
1. Save insights from conversations about goals
2. Track progress and learnings over time
3. Reference past conclusions in future planning

## Testing Checklist

### Basic Functionality
- [ ] Save memory with all fields
- [ ] Save memory with minimal fields
- [ ] Search with various queries
- [ ] Search with different thresholds
- [ ] List memories with different limits
- [ ] View memory statistics

### Edge Cases
- [ ] Empty search query
- [ ] Search with no results
- [ ] Search when no memories exist
- [ ] Very long content
- [ ] Special characters in content
- [ ] Multiple identical memories

### MCP Integration
- [ ] Server starts correctly
- [ ] Tools are discovered by client
- [ ] All tools execute successfully  
- [ ] Error handling works
- [ ] Multiple concurrent requests

## Performance Benchmarks

### Expected Performance
- **Save Memory**: < 1 second
- **Search 100 memories**: < 2 seconds  
- **List memories**: < 0.5 seconds
- **Memory footprint**: ~50MB for 1000 memories

### Scalability Limits
- **ChromaDB**: Handles 100K+ documents efficiently
- **Embeddings**: 384-dimensional vectors (all-MiniLM-L6-v2)
- **Storage**: ~1KB per memory average

## Troubleshooting

### Common Issues
1. **"MCP not available"**: Install missing dependencies
2. **Embedding model fails**: Check internet connection for initial download
3. **ChromaDB errors**: Check write permissions for memory_db directory
4. **Claude Desktop not connecting**: Verify config.json path an