Skip to content

README.md

Latest commit

 

History

History
86 lines (54 loc) · 2.51 KB

README.md

File metadata and controls

86 lines (54 loc) · 2.51 KB

SoulMate-AI

AI-powered youth mental wellness platform with features like Mind Log, Mood History, Vibe Match, Soul Connect, and ThriveTrack. Includes empathetic voice mode, growth avatars, and three AI personalities (Ira, Ariv, Dr. Aarav) to provide confidential, stigma-free emotional support.

🌱 Youth Mental Wellness AI Platform

Confidential • Empathetic • Culturally Relevant An AI-powered platform designed to support Indian youth in overcoming mental health stigma, expressing emotions safely, and building long-term wellness habits.

✨ Key Features

  • 📝 Mind Log – Record thoughts and feelings privately.
  • 📊 Mood History – Visualize emotional journeys and patterns.
  • 🎵 Vibe Match – Personalized music & activities based on mood.
  • 🤝 Soul Connect – Anonymous community for stigma-free peer support.
  • 🏆 ThriveTrack – Growth system with badges & flourishing avatars.
  • 🎙️ Voice Mode – Real-time, empathetic speech-to-speech conversations.
  • 🤖 AI Companions – Choose between friendly Ira, motivational Ariv, or professional Dr. Aarav.

🎯 Why This Matters

Youth in India face enormous academic and social pressure, yet mental health care is often inaccessible or stigmatized. Our platform offers a safe, affordable, and engaging digital ecosystem that empowers young people to reflect, connect, and grow without fear of judgment.

🛠️ Tech Stack

  • Frontend: React / Next.js (customizable UI with ChatGPT-like view)
  • Backend: Node.js / Express
  • AI Models: Powered by OpenRouter (DeepSeek R1, Gemini, others)
  • Database: MongoDB / Firebase
  • Hosting: Google Cloud Platform

🚀 Getting Started

  1. Clone the repository:

    git clone https://github.com/yourusername/your-repo-name.git

  2. Install dependencies:

    npm install

  3. Add your API keys to .env:

    OPENROUTER_API_KEY= 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

  4. Start development server:

    npm run dev

📌 Roadmap

  • Multi-language voice support
  • Advanced analytics for emotional patterns
  • Offline journaling mode
  • Professional counselor integration

🤝 Contributing

Contributions, feedback, and new ideas are always welcome! Please open an issue or submit a pull request.

📜 License

This project is licensed under the GNU GPLv3– feel free to use and adapt with attribution.