Your compassionate AI companion for mental health support, designed specifically for college students.
- Google Gemini AI Integration: Advanced AI companion using Google's latest language model
- Real-time Mood Analysis: AI analyzes your text input to understand emotional state
- Personalized Insights: Get tailored recommendations based on your mood patterns
- Crisis Detection: Intelligent crisis assessment with immediate resource provision
- Context-Aware Conversations: AI remembers your history and provides personalized support
- 24/7 AI Companion: Always-available mental health support
- Mood-Aware Responses: AI adapts responses based on your current emotional state
- Topic Detection: Automatically identifies conversation themes (academic stress, social anxiety, etc.)
- Crisis Intervention: Immediate crisis detection with emergency resources
- Conversation History: Track your mental health journey over time
- AI-Powered Analysis: Get insights from your mood entries using natural language processing
- Pattern Recognition: Identify mood trends and triggers
- Personalized Recommendations: AI suggests activities based on your current state
- Streak Tracking: Build healthy habits with daily mood logging
- Visual Analytics: Beautiful charts showing your emotional journey
- Real-time Insights: AI-generated insights based on your data
- Smart Recommendations: Personalized activities and techniques
- Progress Tracking: Monitor your mental health journey
- Trend Analysis: Visual representation of mood patterns
- Quick Actions: Easy access to support tools
- Dynamic Content: Resources adapt based on your needs
- Personalized Categories: AI-recommended resources based on your situation
- Difficulty Levels: Activities tailored to your current capacity
- Benefit Tracking: Understand how each resource helps you
- Smart Filtering: Find exactly what you need when you need it
- Node.js 18+
- npm or yarn
- Google Gemini API key
-
Clone the repository
git clone https://github.com/yourusername/mindbridge.git cd mindbridge -
Install dependencies
npm install
-
Set up Google Gemini AI
- Get your API key from Google AI Studio
- The API key is already configured in the code (for demo purposes)
- Note: In production, use environment variables for security
-
Start the development server
npm run dev
-
Open your browser Navigate to
http://localhost:8080(or the port shown in terminal)
- React 18 with TypeScript for type safety
- Vite for fast development and building
- Tailwind CSS for modern, responsive design
- Shadcn/ui for beautiful, accessible components
- React Router for client-side routing
- Google Gemini 1.5 Flash for natural language processing
- Custom AI Service for mental health-specific prompts
- Context Management for personalized responses
- Safety Protocols for crisis detection and intervention
- Local Storage for user data persistence
- Real-time Updates for immediate AI insights
- Secure Handling of sensitive mental health information
Create a .env.local file in the root directory:
VITE_GEMINI_API_KEY=your_google_gemini_api_key_hereThe AI service is configured in src/lib/ai-service.ts:
// Initialize Google Gemini AI
const genAI = new GoogleGenerativeAI(process.env.VITE_GEMINI_API_KEY);
const model = genAI.getGenerativeModel({ model: 'gemini-1.5-flash' });- Welcome introduction to MindBridge
- Quick access to all features
- Crisis support information
- Beautiful, engaging design
- Real-time AI responses using Google Gemini
- Mood analysis of your messages
- Crisis detection with immediate resources
- Topic identification for better support
- Conversation history tracking
- AI-powered mood analysis from text input
- Visual mood calendar with 30-day view
- Streak tracking for motivation
- AI insights based on patterns
- Personalized recommendations
- Real-time statistics (streaks, averages, progress)
- AI-generated insights and tips
- Personalized recommendations for activities
- Mood trend charts and analytics
- Quick action buttons for support
- AI-curated content based on your needs
- Dynamic recommendations that adapt to your situation
- Difficulty levels and time estimates
- Benefit tracking for each resource
- Smart filtering by category
- Analyzes your messages for emotional content
- Identifies crisis indicators automatically
- Provides context-aware responses
- Remembers conversation history
- Suggests activities based on your mood
- Adapts difficulty levels to your capacity
- Considers your available time
- Tracks what works for you
- Monitors for crisis indicators in real-time
- Provides immediate crisis resources
- Offers grounding techniques
- Connects to emergency services
- Identifies trends in your emotional state
- Suggests interventions based on patterns
- Tracks progress over time
- Provides predictive insights
- Glass morphism effects with backdrop blur
- Gradient backgrounds for visual appeal
- Smooth animations and transitions
- Responsive design for all devices
- Accessibility-first approach
- Primary: Blue to purple gradients
- Success: Green to emerald
- Warning: Orange to red
- Neutral: Slate variations
- Accent: Purple to pink
- Modern fonts with excellent readability
- Hierarchical sizing for clear information architecture
- Gradient text effects for emphasis
- Responsive scaling across devices
- All data stored locally on your device
- No personal information sent to external servers
- AI responses generated in real-time without storage
- Crisis detection runs locally for privacy
- Immediate access to crisis hotlines
- Emergency contact information
- Grounding techniques and coping strategies
- Professional resource recommendations
MindBridge includes comprehensive crisis support:
- 988 Suicide & Crisis Lifeline
- Crisis Text Line (Text HOME to 741741)
- Emergency Services (911)
- Campus Counseling resources
- Immediate coping strategies
Important: MindBridge is a supportive AI companion, not a replacement for professional therapy. If you're in immediate crisis, please contact emergency services or a crisis hotline.
We welcome contributions to make MindBridge better for all students!
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request
- Additional AI models and integrations
- More crisis detection algorithms
- Enhanced analytics and insights
- Additional language support
- Accessibility improvements
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini AI for providing the AI capabilities
- Shadcn/ui for beautiful component library
- Tailwind CSS for the utility-first CSS framework
- React Team for the amazing frontend framework
- Mental Health Community for guidance and support
- Documentation: GitHub Wiki
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Made with β€οΈ for students, by students
MindBridge - Your AI-powered mental health companion