README.md

---
title: Memory Chat with Hugging Face
emoji: 🤖
colorFrom: blue
colorTo: gray
sdk: gradio
app_file: app.py
pinned: false
license: mit
---

# Hugging Face Memory Chat

A conversational AI application built with Hugging Face models that records and remembers user memories.

## Features

- 🤖 Hugging Face model integration
- 💾 Memory storage and retrieval
- 💬 Simple conversational interface
- 🔐 Secure memory management

## Setup

1. Install requirements:
   ```bash
   pip install -r requirements.txt
   ```

2. Set up Hugging Face API token:
   ```bash
   export HUGGINGFACE_API_TOKEN=your_token_here
   ```

3. Run the application:
   ```bash
   python app.py
   ```

## Usage

The application provides a simple interface where you can:
- Have conversations with the AI
- The AI will automatically record important memories from your conversations
- Retrieve memories when relevant to the conversation
- View your memory timeline

## Project Structure

```
hf-memory-chat/
├── app.py              # Main application
├── memory_manager.py   # Memory storage and retrieval
├── chat_interface.py   # Conversational interface
├── config.py          # Configuration settings
├── requirements.txt   # Python dependencies
└── memories/          # Memory storage directory
    ├── memories.json  # Memory database
    └── timeline.md    # Human-readable memory timeline
```

## License

MIT License