A culturally-intelligent AI Mental Health Companion for Nigeria, providing a safe, multi-lingual "Emotional Haven" for mental clarity and peace.
# MindMate 🌿 | Your AI Safe Space for Mental Clarity & Peace
**MindMate** is a culturally-intelligent AI Mental Health Companion designed to break the silence around mental wellness in Nigeria. Built for the **Raenest X DevCareer Hackathon**, it provides a judgment-free, anonymous environment where anyone can speak freely about their heart and mind.
---
## 🔗 Quick Links
* **Live Demo:** Deploy Link - Click Here *(Optimized for 24/7 availability)*
* **Video Demo:** Watch the Demo on X
---
## 🌟 The Mission
In a society where mental health is often stigmatized or overlooked, many suffer in silence. **MindMate** bridges this gap by offering immediate, reliable, and empathetic support. It is a *"Compassionate Companion for Every Journey"*- from the student facing exams to the professional managing a high-stress career.
## 🚀 Key Features
* **Cultural Empathy:** Communicates using local nuances (English, Pidgin, Yoruba, Igbo, Hausa) with warm, localized greetings like *Pele*, *Ndo*, and *Sannu*.
* **Scientific Foundation:** Guidance is grounded in **WHO** (World Health Organization) and **UNICEF** wellness standards.
* **Therapeutic Logic:** Incorporates **Cognitive Behavioral Therapy (CBT)** principles to help users validate emotions and reframe negative thoughts.
* **Voice-First Accessibility:** Integrated microphone support for users who find it easier to speak than type.
* **Anonymity & Safety:** A completely private space with built-in crisis protocols that direct users to professional Nigerian helplines when needed.
## 🛠️ Tech Stack
* **Frontend:** HTML5, CSS3 (Custom Responsive UI), JavaScript (ES6+).
* **Backend:** Node.js, Express.
* **AI Engine:** Llama 3.3-70B via Groq Cloud API for lightning-fast, intelligent responses.
* **Infrastructure:** Deployed on **Render** with custom **Cron-job** "heartbeats" to ensure 24/7 availability.
## 🧠 Technical Challenges Overcome
### 1. The "Generic Response" Trap
Early iterations suffered from repetitive "I hear you" p …