MindScape is an AI-powered mental wellness web app designed to help users understand their emotions, reduce stress, and build healthier habits through simple daily check-ins.
It combines mood tracking, calming stories, music therapy, and a gentle AI companion named Keshava, inspired by the wisdom of the Bhagavad Gita.
Built with privacy and accessibility in mind, MindScape supports users with small daily actions that feel calming, supportive, and easy to maintain.
Mental wellness support should feel simple and approachable.
MindScape helps users:
🧠 Track emotions through daily check-ins and mood scans 📖 Read calming stories based on their mood 🎵 Listen to relaxing music for stress relief 💬 Talk with Keshava, an AI companion for gentle guidance 📊 Build healthy habits with streaks and progress insights 🆘 Access helplines and real-world professional support when needed
- Daily mood selection
- Quick self-assessment
- Notes & reflections
- Mood score generation
- Weekly mood trends
- Camera-based emotion detection
- Optional computer vision analysis
- Countdown + instant mood results
- Gentle supportive conversations
- Personalized emotional guidance
- Positive suggestions inspired by Bhagavad Gita values
- Mood-based calming stories
- Trending & recommended stories
- Save, like, and continue reading
- Curated relaxing tracks
- Jamendo music integration
- Mini player controls
- Mood averages
- Daily streak tracking
- Consistency score
- Recent scan history
- Trend visualization
- Avatar upload
- Personal details
- Daily mood badge
- Psychologists & counselors
- Support guidance notes
- Easy access during difficult moments
| Route | Purpose |
|---|---|
/ |
Login |
/register |
Registration + onboarding |
/home |
Mood scan + Keshava chat |
/dashboard |
Insights & trends |
/tracker |
Daily mood check-in |
/stories |
Story library |
/music |
Music therapy |
/profile |
User profile |
/helpline |
Mental health support |
- React 19
- Vite
- React Router
- Tailwind CSS
- Flask
- SQLAlchemy
- SQLite
- Groq
- LangChain
- FAISS
- DeepFace
- Hugging Face Inference
cd frontend
npm install
cd ../backend
pip install -r requirements.txtcd backend
python app.pycd frontend
npm run devInstall full ML support:
cd backend
pip install -r requirements-ml.txt- Emergency support alerts
- Personalized meditation suggestions
- Better AI mood analysis
- Weekly emotional wellness reports
- Voice-based Keshava conversations
MindScape is built to feel safe and supportive.
- Private daily mood tracking
- User-controlled data
- Optional AI analysis
- Encourages professional help when needed
Add your preferred license here.
Made with ❤️ to support everyday mental wellness.