Skip to content

Empowering your mental health journey with compassionate care and a supportive community.

Notifications You must be signed in to change notification settings

KanishaSharma11/MindWell

Repository files navigation

๐ŸŒธ MindWell โ€“ A Youth Mental Wellness Platform

An AI-powered platform for young mental wellness combining emotional support, self-reflection, safe communities, and engaging activities.


๐Ÿ’ก Introduction

Typing SVG

Mental health challenges among youth are increasing due to stress, anxiety, and lack of safe outlets. MindWell addresses these challenges by creating a comprehensive digital wellness ecosystem that combines cutting-edge AI technology with human-centered design.

๐ŸŽฏ Our Mission

  • ๐Ÿค– Support youth through AI-driven companions
  • ๐Ÿ“ Encourage self-reflection via intelligent diary + emotion detection
  • ๐ŸŒ Provide safe anonymous communities for meaningful discussions
  • ๐ŸŽ‰ Promote fun & positivity through games and motivational content

๐Ÿšฉ Problem Statement

Challenge Impact MindWell Solution
๐Ÿ“ฑ Limited interactive platforms for youth Low engagement & accessibility AI-powered personalized interactions
๐Ÿ”’ Lack of anonymous and secure safe spaces Stigma prevents honest sharing Anonymous communities with moderation
โฌ‡๏ธ High dropout rates in existing apps Poor retention & outcomes Gamification & reward systems
๐Ÿฅ Insufficient real-time support Crisis situations unaddressed 24/7 AI companion + resource finder

โœจ Features

๐Ÿ  Home Page - Daily Motivation

  • ๐ŸŒŸ Inspirational Quotes: Fresh motivational content powered by ZenQuotes API
  • ๐Ÿ”„ Dynamic Content: New quote on every refresh or click
  • ๐Ÿ† Achievement Tracker: Visual progress indicators and milestones

๐Ÿค– AI Emotional Chat Companion

Powered by Google Gemini (gemini-2.5-pro)

Mode Description Features
๐Ÿ’ฌ Text Chat Traditional messaging Smart responses, emotion recognition
๐ŸŽ™๏ธ Voice-to-Text Speak your thoughts Web Speech API integration
๐Ÿ“ž Call Mode Real-time conversation Speech-to-Speech capability
๐Ÿง‘โ€๐ŸŽค 3D Avatar Mode Immersive experience Anime model with voice interaction

๐Ÿ” Real-time Resources: Automatically fetches helplines and mental health resources via Google Search API

๐Ÿ“– My Diary - Emotion Intelligence

  • โœ๏ธ Daily Reflections: Secure, private journaling experience
  • ๐Ÿง  Emotion Detection: AI-powered mood analysis using Hugging Face models
  • ๐Ÿ“ˆ Mood Visualization: Beautiful charts showing emotional trends over time

๐ŸŒ Community Feature - Safe Spaces

  • ๐Ÿ‘ฅ Anonymous Communities: Create or join discussion groups safely
  • ๐Ÿ›ก๏ธ Smart Moderation: Perspective API (Google Jigsaw) prevents abuse
  • ๐ŸŽญ Auto-generated Usernames: Protect identity while building connections
  • ๐Ÿ’ฐ Community Creation: Requires 50 coins to maintain quality spaces

๐ŸŽฎ Single Player Game

  • ๐Ÿ•บ Pose Detection: Advanced Mediapipe technology for accurate movement tracking
  • ๐Ÿ“บ Split-Screen View: Compare your moves with reference videos
  • ๐Ÿ… Scoring System: Real-time feedback and improvement suggestions
  • ๐Ÿ’ช Physical Wellness: Combines mental and physical health benefits

๐Ÿช™ Gamification & Rewards

Earn coins through positive behaviors:

  • ๐Ÿ“… Daily login streaks
  • ๐Ÿ“š Reading motivational quotes
  • ๐ŸŽฏ Platform engagement
  • ๐Ÿ† Achieving wellness milestones
  • ๐Ÿค Community participation

Spend coins on:

  • ๐ŸŒ Creating new communities

๐Ÿ“ธ Project Gallery

๐Ÿ–ผ๏ธ Add Your Screenshots Here

Feature Screenshot
๐Ÿ  Home Dashboard Home
๐Ÿค– AI Chat Interface Chat
๐Ÿ“– Diary Diary
๐ŸŒ Community Hub Community
๐ŸŽฎ Dance Game Game

๐Ÿ› ๏ธ Tech Stack

Frontend

HTML5 CSS3 JavaScript

Backend

Python Flask

Data & Visualization

Chart.js

AI & ML

TensorFlow Hugging Face


๐Ÿ”Œ APIs & Models Used

Service Purpose Status
๐ŸŒธ ZenQuotes API Motivational quotes generation โœ… Active
๐Ÿค– Google Gemini AI chatbot conversations โœ… Active
๐Ÿ” Google Search API Real-time helpline resources โœ… Active
๐ŸŽ™๏ธ Web Speech API Voice interaction features โœ… Active
๐Ÿง  Hugging Face Model Emotion detection in diary โœ… Active
๐Ÿ›ก๏ธ Perspective API Community content moderation โœ… Active
๐ŸŽฎ Google Mediapipe Pose detection for dance game โœ… Active

๐Ÿš€ Installation

๐Ÿ“‹ Prerequisites

  • Python 3.8 or higher
  • Node.js (for development tools)
  • Git
  • Web browser with microphone/camera support
  • HTML5, CSS3, JavaScript
  • Tensorflow, Keras

๐Ÿ’ก Feature Usage Tips

  • ๐Ÿค– AI Chat: Be open and honest for best emotional support
  • ๐Ÿ“– Diary: Write regularly for accurate mood tracking
  • ๐ŸŒ Communities: Follow community guidelines for positive interactions
  • ๐ŸŽฎ Games: Use proper lighting for better pose detection
  • ๐Ÿช™ Rewards: Check daily for bonus coin opportunities

๐ŸŽฎ Demo

๐ŸŽฅ Video Walkthrough

Video Demo


Made by: Kanisha Ravindra Sharma

About

Empowering your mental health journey with compassionate care and a supportive community.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published