Skip to content

TinsaeTadesse17/Wellness-Assistant-AI

Repository files navigation

Wellness and Mental Health AI Assistant

Welcome to the Wellness and Mental Health AI Assistant repository! This project is an AI-powered virtual assistant designed to provide professional, empathetic, and actionable support for wellness, self-care, and mental health-related queries.

Powered by Gemini API and enhanced with evidence-based psychological frameworks, this assistant is designed to deliver high-quality, supportive, and actionable responses tailored to users' concerns.


🌟 Features

  • Specialized Responses: Focused exclusively on wellness, self-care, and mental health.
  • Gemini API Integration: Retrieves relevant insights to address user queries.
  • Psychological Frameworks: Incorporates principles from Cognitive Behavioral Therapy (CBT), Positive Psychology, and Mindfulness-Based Stress Reduction (MBSR).
  • Custom Recipe: Adds unique, actionable advice and wellness exercises on top of API responses.
  • Empathetic Tone: Maintains a calm, supportive, and empowering voice in all responses.

🎯 Use Cases

  • Managing stress and anxiety
  • Building healthy habits and routines
  • Improving sleep quality
  • Overcoming procrastination and low motivation
  • Practicing mindfulness and emotional regulation

🛠️ Technology Stack

  • Gemini API: Core source of information for user queries.
  • React: Frontend framework for building the user interface.
  • Psychological Frameworks: Evidence-based strategies for mental health and wellness.

📦 Installation

  1. Clone the repository:
    git clone https://github.com/TinsaeTadesse17/Wellness-Assistant-AI.git 
    cd Wellness-Assistant-AI
  2. Install dependencies:
    npm install  
  3. Set up your environment variables:
    • Add your Gemini API key and other required keys to a .env file
    GEMINI_API_KEY=your-api-key    
  4. Start the development server:
    npm start    

🚀 How It Works

  1. User Input: Users ask a wellness or mental health-related question.
  2. Gemini API: The assistant fetches relevant information from the Gemini API.
  3. Psychological Insights: Adds value to the response using psychological principles and frameworks.
  4. Custom Recipe: Enhances the response with actionable advice, exercises, or strategies tailored to the query.
  5. Output: Provides a professional, empathetic, and actionable response to the user.

🤝 Contributing

Contributions are welcome! Please follow these steps:

  1. Fork this repository.
  2. Create a new branch:
    git checkout -b feature-name  

3.Make your changes and commit them:

  git push origin feature-name     

4.Open a pull request.

📄 License

This project is licensed under the MIT License.

📧 Contact

If you have any questions or suggestions, feel free to reach out!

About

Wellness and Mental Health AI Assistant https://mentalwellnessai.netlify.app

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published