Skip to content

psyflow-team/PsyFlo--AI-Mental--Health--Companion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Psyflo - AI Mental Health Companion

An intelligent mental health companion app that provides 24/7 accessible wellness support through AI-driven mood tracking, personalized recommendations, and privacy-first design.

🎯 Mission

Making mental health support affordable, accessible, and stigma-free for everyoneβ€”especially students and young professionals navigating stress, anxiety, and mental wellness challenges.

πŸ’‘ Problem We're Solving

Mental health support is critical, yet many people lack access to affordable, accessible resources. Barriers include:

  • High costs ($100-200 per therapy session)
  • Limited professional availability
  • Stigma and fear of judgment
  • Support unavailable during crises (nights, weekends, emergencies)

Psyflo democratizes mental wellness by providing intelligent, personalized support anytime, anywhere.

✨ Key Features

  • πŸ“Š AI-Powered Mood Tracking - Log your mood (1-10 scale) with optional journal entries
  • πŸ€– Personalized Recommendations - Get AI-generated wellness suggestions based on your emotional state
  • πŸ’¬ Conversational AI Companion - Real-time emotional support from Gemma-3-27b AI model
  • πŸ“ˆ Mental Health Insights - Track mood patterns and identify triggers over time
  • πŸ”’ Privacy-First Design - Encrypted data, no external sharing, complete user control
  • πŸŒ™ 24/7 Accessibility - Support available anytime, anywhere, judgment-free

πŸš€ Quick Start

Try Psyflo Now

Visit: https://psyflo.vercel.app

No installation needed - just open the link!

How to Use

Step 1: Sign Up

  1. Click Sign Up
  2. Enter your email and password
  3. Click Create Account

Step 2: Log Your Mood

  1. Go to Dashboard
  2. Select your current mood (1-10 scale with emoji)
  3. Optionally add notes about what you're feeling
  4. Click Save Mood

Step 3: Get AI Recommendations

The AI analyzes your mood and notes, then provides:

  • Empathetic message understanding your feelings
  • Personalized coping strategies
  • Specific wellness suggestions based on your history

Step 4: Track Your Progress

  • View your Mood History to see patterns
  • Check which activities help you most
  • Identify mood triggers
  • Celebrate improvements!

πŸ› οΈ Tech Stack

  • Frontend: Next.js 15, React, TypeScript, Tailwind CSS
  • Backend: Firebase
  • AI: Gemma-3-27b for emotion analysis and recommendations
  • Security: Encrypted data, privacy-first architecture

πŸ€– How the AI Works

When you log your mood with notes:

  1. Your Input

    • Mood level (1-10)
    • Optional notes: "feeling stressed about work"
  2. AI Analysis

    • Detects emotions: stress, anxiety, pressure
    • Understands context: work-related challenge
    • Considers your history: what helped before
  3. Personalized Response

    • Empathetic message: "I understand work stress..."
    • Specific suggestions: "Try a 5-minute walk"
    • Pattern insights: "You usually feel better after exercise"

πŸ”’ Your Privacy Matters

βœ… All your data is encrypted βœ… We never share your information βœ… You can delete your data anytime βœ… No external tracking or data selling βœ… GDPR compliant and secure

πŸ“š Features Overview

Dashboard

  • Quick mood logging
  • View today's mood and recommendations
  • See upcoming mood patterns

Mood History

  • Visual charts showing your mood over time
  • Identify patterns and triggers
  • Track your mental health journey
  • See improvement trends

Recommendations

  • Personalized activities based on your mood
  • Breathing exercises for anxiety
  • Meditation guides for stress
  • Movement suggestions for low mood
  • Journal prompts for reflection

Resources

  • Crisis support hotlines
  • Mental health resources
  • Meditation guides
  • Professional help links
  • Community support options

Profile

  • Manage your account
  • Update preferences
  • View account settings
  • Privacy controls

πŸ’‘ Tips for Best Results

  1. Log regularly - Daily mood tracking helps AI learn what works for you
  2. Be honest - Add notes about what you're feeling for better recommendations
  3. Try suggestions - Test the AI recommendations to see what helps
  4. Track patterns - Notice when and why your mood changes
  5. Ask for help - Use resources if you need professional support

πŸ†˜ Crisis Support

If you're in crisis, please reach out:

  • Crisis Text Line: Text HOME to 741741
  • National Suicide Prevention Lifeline (US): 988
  • International Helpline: findahelpline.com

Psyflo is not a substitute for professional mental health treatment. Please seek professional help if needed.

πŸ“± Works Everywhere

  • βœ… Desktop & laptop
  • βœ… Tablet
  • βœ… Mobile phone
  • βœ… Any modern web browser

❓ FAQ

Q: Is Psyflo free? A: Yes! Psyflo is completely free to use.

Q: Is my data safe? A: Yes. All data is encrypted and never shared. You control your privacy.

Q: Can I use this instead of therapy? A: Psyflo complements therapy, not replaces it. Use it between sessions and for daily support.

Q: How often should I log my mood? A: Daily is ideal, but any frequency helps. The more you log, the better AI understands you.

Q: What if I'm not feeling the recommendations? A: Try different suggestions. The AI learns from your feedback. What works varies person to person.

Q: Can I delete my account? A: Yes. Go to Profile β†’ Settings β†’ Delete Account. All your data will be removed.

🌟 What Makes Psyflo Different

Psyflo Other Mood Apps Therapy
Available 24/7 βœ… βœ… ❌
Personalized AI βœ… ❌ βœ…
Affordable βœ… Free βœ… ❌ $100-200/session
Immediate Support βœ… ❌ ❌
Pattern Detection βœ… ❌ βœ…
Privacy-First βœ… ⚠️ βœ…

πŸš€ Future Features Coming

We're constantly improving Psyflo:

  • Wearable integration (fitness trackers, smartwatches)
  • Voice journal entries
  • Therapist integration
  • Community support groups
  • Advanced mood analytics

πŸ‘₯ Team

Built by passionate developers committed to mental health:

  • Benonia Ayeh - Full-Stack Developer
  • Sutharshan Suthakaran - AI/Data Scientist

πŸ’¬ Feedback

We'd love to hear from you!

πŸ“„ License

MIT License - Open source and free to use

πŸ™ Support Mental Health

If Psyflo helps you, please:

  • Share with friends and family
  • Tell us your story (feedback helps!)
  • Encourage others to check in on their mental health
  • Remember: asking for help is strength, not weakness

Important Disclaimer

Psyflo is not a medical service. It provides support and recommendations, but is not a substitute for professional mental health treatment. If you're experiencing:

  • Thoughts of self-harm
  • Suicidal ideation
  • Severe depression or anxiety
  • Any mental health crisis

Please contact a mental health professional or crisis hotline immediately.

Crisis Resources:

  • Crisis Text Line: Text HOME to 741741
  • 988 Suicide & Crisis Lifeline: Call or text 988
  • International: findahelpline.com

Your mental health matters. Take care of yourself. πŸ’š

Live Demo: https://psyflo.vercel.app GitHub: https://github.com/psyflow-team/psyflo

About

An intelligent mental health companion app that provides 24/7 accessible wellness support through AI-driven mood tracking, personalized recommendations, and privacy-first design.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors