MindMate

Elevating Mental Health with AI

---

Introducing MindMate

MindMate is an AI-powered mental health chat assistant designed to guide, support, and empower users on their journey to better mental well-being. With a user-friendly interface, MindMate offers personalized guidance, insightful analysis, and curated resources—all in one secure, accessible platform.

---

Why Choose MindMate?

• AI-Powered Chat Assistant: Get immediate, empathetic support for your mental health questions.
• Longitudinal Mental Health Analysis: Track your well-being over time with detailed reporting.
• Graphical Insights: Visualize your mental health status and progress.
• Curated Articles: Access editor-compiled resources to learn about mental health topics.
• Personalized Email Suggestions: Receive regular, actionable tips to improve your mental health.

---

Recognition

🏆 Recognized at H2AI Georgetown University Hackathon

---

Experience MindMate

• Live Deployment: https://mind-mate-wellness.vercel.app
• Watch the Demo: YouTube Explanation

---

Technology

System Architecture

MindMate leverages a robust, multi-server architecture for performance, scalability, and security:

• Frontend Server
• Backend Server
• WebSocket Server
• Email Server

---

Tech Stack

Component	Technologies & Tools
Frontend	React JS, Tailwind CSS
Backend	Node.js, Express.js, Gemini (Gen AI), WebSockets, NodeMailer
Tools	Vercel, Render, MongoDB Atlas, Firebase

---

Local Setup Guide

1. Firebase Configuration

1. Create a new Firebase project.
2. Add a Web App.
3. Enable Authentication:
   • Email/Password
   • Google (Gmail)
4. Retrieve firebaseConfig:
   • Go to Project Settings > Web App.
5. Set up .env in Frontend:
   • Copy firebaseConfig as per .env.sample.
6. Generate a Private Key:
   • In Service Accounts, generate a new private key (JSON).
7. Set up .env in Backend:
   • Add the private key as per .env.sample.
8. Complete remaining .env variables.

---

2. Gemini API Key

• Obtain your Gemini API key from ai.google.dev.
• Add to Backend .env as per .env.sample.

---

3. MongoDB Atlas

• Create a MongoDB Atlas account.
• Get your connection URI.
• Add to Backend .env as per .env.sample.

---

4. Server Connections

• WebSocket Server URL: Add to Backend .env (e.g., WEBSOCKET_SERVER=ws://localhost:8802).
• Backend & WebSocket URLs: Add to Frontend .env (e.g., REACT_APP_API_LINK=http://localhost:8800, REACT_APP_WS_LINK=ws://localhost:8802).

---

5. Installation & Launch

1. Ensure Node.js is installed.
2. Run npm install in each folder:
   • Backend
   • Frontend
   • WebSocket Server
3. Launch Servers:
   • Backend: npm run dev or npm start
   • Frontend: npm start
   • WebSocket Server: node index.js

---

Website Preview

HomePage

Login

Analysis

AI Chat

---

Ready to Make a Difference

MindMate stands out for its seamless integration of AI, user-centric design, and comprehensive mental health support. Whether you’re a user seeking guidance or a developer looking to contribute, MindMate offers a powerful, accessible solution for mental well-being.

All setup steps and tech stack details are presented for clarity and ease of use, with security and best practices in mind.