Spaces:
Sleeping
Sleeping
| title: Refeel | |
| emoji: 🔥 | |
| colorFrom: green | |
| colorTo: red | |
| sdk: gradio | |
| sdk_version: 5.33.1 | |
| app_file: app.py | |
| pinned: false | |
| license: cc-by-4.0 | |
| short_description: '📝 Refeel – Re-feel your emotions. Reframe your story: AI Di' | |
| # 📝 Refeel – Re-feel your emotions. Reframe your story: AI Diary & Smart Chat | |
| **A smart AI-powered diary web app for the Hugging Face MCP Hackathon.** | |
| Modern individuals often miss the opportunity to deeply reflect on their emotions and experiences in the midst of a rapidly changing environment. Although emotional journaling is a powerful tool for emotional stability and self-understanding, many people struggle to maintain a consistent writing habit or to analyze their own behavioral patterns. | |
| This project aims to build an AI-powered self-reflection journaling service that leverages Large Language Models (LLMs) and Retrieval-Augmented Generation (RAG) technology to help users easily write journal entries and identify recurring emotional patterns or cognitive traps in their thoughts. | |
| Refeel is a web app that allows users to write, search, and analyze their diary entries, and engage in meaningful conversations with an empathetic, psychologically-informed AI assistant. | |
| [▶️ Watch Demo (mp4)](./gradio-screen-recording-2025-06-10T03-00-19.mp4) | |
| <iframe width="560" height="315" src="https://www.youtube.com/embed/6qaRf_5kofc?si=0XzhztYB4MAfPwuY" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe> | |
| --- | |
| ## 🌟 Features | |
| - **✏️ Write Diary**: | |
| Freely write down your thoughts and feelings each day. Each diary entry is vector-embedded and stored in Qdrant. | |
| - **🔍 Search Diary**: | |
| Search your past diary entries by keyword or semantic similarity. | |
| - **🧠 AI Analysis & Coaching**: | |
| After saving an entry, receive instant feedback and kind, realistic advice from the AI. | |
| *(Powered by LangChain + Groq LLM)* | |
| - **🤖 Smart Chat**: | |
| Have personalized conversations with the AI, which references your saved diary entries for context. | |
| - **🌍 Multilingual Embedding**: | |
| Diary entries are vectorized using a multilingual sentence transformer. | |
| --- | |
| ## 🛠️ Tech Stack | |
| | Component | Technology | | |
| |------------------|------------------------------------------------| | |
| | Frontend/Backend | [Gradio](https://gradio.app/) (Python) | | |
| | Vector DB | [Qdrant Cloud](https://qdrant.tech/) | | |
| | LLM | [Groq API](https://groq.com/) (OpenAI-compatible) | | |
| | Embeddings | `sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2` | | |
| | LLM Framework | [LangChain](https://www.langchain.com/) | | |
| --- | |
| ## 🚀 Installation | |
| 1. **Clone the repository** | |
| ```bash | |
| git clone https://huggingface.co/spaces/thisispaperdoll/refeel . | |
| ``` | |
| 2. **Install required packages** | |
| ```bash | |
| pip install gradio qdrant-client sentence-transformers langchain langchain_groq | |
| ``` | |
| 3. **Set API keys** | |
| - Open `app.py` and set your Qdrant and Groq API keys. | |
| 4. **Run the app** | |
| ```bash | |
| python app.py | |
| ``` | |
| - To enable auto-reload on code changes: | |
| ```bash | |
| python app.py --reload | |
| ``` | |
| or | |
| ```python | |
| demo.launch(reload=True) | |
| ``` | |
| --- | |
| ## 💡 Usage Guide | |
| - **Write Diary** | |
| In the "✏️ Write Diary" tab, enter a title and content, then click "Save Diary". | |
| - **Get AI Feedback** | |
| After saving, the AI provides instant emotional analysis and coaching. | |
| - **Continue Chatting** | |
| Go to the "🤖 Smart Chat" tab to have a deeper conversation with the AI using your diary context. | |
| - **Search Diary** | |
| Use the "🔍 Search Diary" tab to find entries based on keywords. | |
| --- | |
| ## 💬 AI Prompt Example | |
| The AI assistant is designed to: | |
| - Empathize and give encouragement | |
| - Detect cognitive distortions and emotional patterns | |
| - Compare with similar past diary entries | |
| - Summarize psychological traps | |
| - Provide friendly and realistic advice suitable for your age | |
| --- | |
| ## 🏆 Hackathon Context | |
| This project was developed for the **Hugging Face MCP Hackathon**. #agent-demo-track | |
| It showcases a personalized, psychologically-aware coaching experience by combining vector search, LLMs, and user context. | |