MindMate is an AI-assisted mental wellness platform designed to support emotional wellbeing through intelligent conversation, self-reflection tools, and community interaction built with modern full-stack technologies and privacy-first principles.
MindMate combines AI companionship, emotional tracking, and guided wellness tools into a single platform. It aims to provide accessible mental wellness support while maintaining user privacy and data security.
This project is a wellness support tool not a substitute for professional medical care.
- Context-aware conversational AI powered by Groq LLMs
- Emotionally supportive responses designed for wellness contexts
- Continuous conversation memory for better personalization
- AI-augmented community interaction
- Supportive discussion environment
- Autonomous AI personalities to encourage engagement
- Daily mood check-ins
- Visual emotional trend analysis
- Habit-building streak system
- Guided breathing exercises
- Meditation resources
- Relaxation audio environments
- Achievement badges
- Positive habit streak tracking
- Weekly self-reflection insights
- Supabase Row Level Security (RLS)
- Secure authentication workflows
- Minimal sensitive data exposure
- Next.js 14 (App Router)
- React and TypeScript
- Tailwind CSS
- Framer Motion animations
- Supabase (Postgres, Auth, Realtime)
- Secure API routes via Next.js
- Groq Cloud API
- Llama 3 70B model support
- Vercel recommended
- Node.js 18+
- Supabase account
- Groq API key
- Clone the repository
git clone https://github.com/RandomAssassin-rgb/MindMate.git
cd MindMate/mindmate-next
- Install dependencies
npm install
- Configure environment variables
Create
.env.local:
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
GROQ_API_KEY=your_groq_api_key
- Start development server
npm run dev
Visit:
http://localhost:3000
mindmate-next/
│
├── app App Router pages and API routes
├── components UI and layout components
├── lib Utilities and service clients
├── theme Design tokens and styling config
└── types TypeScript definitions
- Push repository to GitHub
- Import project in Vercel
- Add environment variables
- Deploy
Done
Contributions are welcome.
Typical workflow:
fork → branch → commit → pull request
Please:
- Write clear commit messages
- Keep code consistent
- Add documentation when needed
MIT License free for personal and commercial use.
Mental wellness tools are often:
- Fragmented
- Expensive
- Not privacy-focused
MindMate explores how AI and modern web tech can create accessible emotional wellness support responsibly.