๐Ÿง  About the Project โ€“ MindGuard

๐Ÿ’ก Inspiration

Mental health is often overlooked โ€” yet it's something most of us struggle with silently. We were inspired by the growing mental health crisis, especially among youth and professionals, and the lack of accessible, stigma-free tools to help.
The question we asked ourselves: โ€œWhat if we could create a digital companion that listens, understands, and acts when no one else does?โ€
MindGuard was born from the idea of combining AI and empathy to create a mental health safety net.


๐Ÿงฐ What it does

MindGuard is an AI-powered mental health companion designed to:

  • Detect early signs of emotional distress or suicidal ideation through journaling (text or voice).
  • Use sentiment and emotion analysis to identify risky patterns.
  • Visualize mood trends with graphs and insights.
  • Provide grounding and calming tools in moments of emotional danger.
  • Trigger Emergency Mode when high-risk emotions are detected (e.g., access to helplines, simulated alerts).

๐Ÿ› ๏ธ How we built it

We used a full-stack architecture for MindGuard:

  • Frontend: React with TypeScript, styled using Tailwind CSS, and animated with Framer Motion for a smooth, calming experience.
  • Backend: Node.js with Express and MongoDB for storing user journal entries and mood scores.
  • AI/NLP Layer: Hugging Face emotion models like distilbert-base-uncased-emotion and twitter-roberta-base-sentiment for analyzing journal entries.
  • Voice Input: Web Speech API for voice journaling.
  • Visualization: Chart.js for plotting mood trends.
  • Emergency Tools: Simulated contact alert system and a wellness toolbox with calming activities.

โš ๏ธ Challenges we ran into

  • ๐Ÿง  Integrating accurate NLP models that could detect nuanced emotional language, especially from short journal entries.
  • ๐ŸŽฏ Balancing sensitivity: Avoiding false positives (e.g., detecting depression when a user is just tired).
  • ๐Ÿ“ฑ Designing a UI that feels calming, non-intrusive, and emotionally safe.
  • โฑ Time constraints โ€” building and testing the full AI pipeline in a short hackathon window.
  • ๐Ÿ”’ Ensuring data privacy and user trust, even in a simulated prototype.

๐Ÿ† Accomplishments that we're proud of

  • Successfully integrated Hugging Face emotion models into a real-time journaling system.
  • Built a responsive and intuitive UI that feels minimal, safe, and user-first.
  • Created a real-world solution that can genuinely help people and start conversations around mental health.
  • Finished a complete end-to-end system โ€” from emotion detection to emergency response โ€” in under 48 hours.

๐Ÿ“š What we learned

  • How to fine-tune and use pre-trained NLP models for emotional sentiment classification.
  • The importance of mental health design patterns โ€” colors, fonts, and layout can impact how safe users feel.
  • Building for impact requires empathy as much as technical skill.
  • How to scope emotional safety features realistically within a hackathon time limit.

๐Ÿ”ฎ What's next for MindGuard

  • ๐Ÿ” End-to-end encryption for journal entries and emotion data.
  • ๐Ÿ“ฑ Native mobile app with offline capabilities and daily mood check-ins.
  • ๐Ÿง‘โ€โš•๏ธ Therapist dashboard (optional) to connect users with licensed professionals when needed.
  • ๐ŸŒ Multi-language support to reach global users with culturally sensitive AI.
  • ๐Ÿง  More advanced emotion models fine-tuned on longer mental health conversations.

MindGuard is just the beginning โ€” our goal is to build a future where no one has to suffer in silence.

Built With

  • ai
  • distilbert-base-uncased-emotion
  • express.js-database:-mongodb-(using-mongoose)-ai/nlp:-hugging-face-transformers-(e.g.
  • fallback
  • framer-motion-backend:-node.js
  • inference
  • javascript-frontend-framework:-react-styling:-tailwind-css
  • languages:-typescript
  • local
  • optional
  • render/railway-(backend)-version-control:-git-+-github-apis/tools:-hugging-face-inference-api-(optional)
  • roberta-base-sentiment)
  • transformers.js
  • transformers.js-voice-input:-web-speech-api-(browser-native)-visualization:-chart.js-authentication:-firebase-auth-(email/google-login-?-optional)-deployment-platforms:-vercel-(frontend)
  • using
Share this project:

Updates