Initial clean commit with LFS models

.gitattributes

@@ -0,0 +1,6 @@
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.keras filter=lfs diff=lfs merge=lfs -text
+app/ml_assets/emotion_model_trained.h5 filter=lfs diff=lfs merge=lfs -text
+app/ml_assets/emotion_model_trained.keras filter=lfs diff=lfs merge=lfs -text
+app/ml_assets/*.h5 filter=lfs diff=lfs merge=lfs -text
+app/ml_assets/*.keras filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,60 @@
+# ========================
+# 🐍 PYTHON / BACKEND
+# ========================
+__pycache__/
+*.py[cod]
+*$py.class
+venv/
+.venv/
+env/
+.env
+instance/
+.pytest_cache/
+backend/.env
+
+# ========================
+# ⚛️ NODE / FRONTEND
+# ========================
+node_modules/
+/frontend/dist/
+/frontend/build/
+/frontend/.env
+/frontend/.env.local
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.eslintcache
+
+# ========================
+# 📓 JUPYTER NOTEBOOKS
+# ========================
+.ipynb_checkpoints/
+*/.ipynb_checkpoints/
+
+# ========================
+# 💾 DATASETS & LARGE FILES
+# ========================
+# Ignore raw datasets (Standard practice: download them separately)
+datasets/
+/backend/app/ml_assets
+/backend/app/ml_assets/MEDICATION.csv
+
+# NOTE: We do NOT ignore *.h5 or *.keras here because you are using 
+# Git LFS to track them. If you were NOT using LFS, you would uncomment below:
+# *.h5
+# *.keras
+
+# ========================
+# ⚙️ IDE & OS FILES
+# ========================
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.swp
+
+# ========================
+# 🐳 DOCKER
+# ========================
+# We usually keep the Dockerfile, but ignore local logs/mounts if any
+docker-compose.override.yml

Dockerfile

@@ -0,0 +1,25 @@
+# 1. Use Python 3.10
+FROM python:3.10-slim
+
+# 2. Set working directory
+WORKDIR /app
+
+# 3. Install system dependencies
+RUN apt-get update && apt-get install -y libgl1 libglib2.0-0 && rm -rf /var/lib/apt/lists/*
+
+# 4. Install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 5. Copy your code (and datasets) into the container
+COPY . .
+
+RUN python download_models.py
+
+ENV PYTHONPATH=/app
+
+# 6. Expose the port (5000 is standard for Flask)
+EXPOSE 5000
+
+# 7. Run the app
+CMD ["python", "app/main.py"]

app/api/endpoints/facial.py

@@ -0,0 +1,35 @@
+from flask import Blueprint, request, jsonify
+import cv2
+import numpy as np
+from app.services.emotion_engine import emotion_detector
+
+# Create a Blueprint (a group of routes)
+facial_bp = Blueprint('facial', __name__)
+
+@facial_bp.route('/predict/emotion', methods=['POST'])
+def predict_emotion():
+    """
+    Endpoint to receive an image file and return the detected emotion.
+    Expects 'form-data' with a key named 'file'.
+    """
+    if 'file' not in request.files:
+        return jsonify({"error": "No file part in the request"}), 400
+
+    file = request.files['file']
+    
+    if file.filename == '':
+        return jsonify({"error": "No file selected"}), 400
+
+    try:
+        # Convert the uploaded file directly to a numpy array (OpenCV format)
+        # This avoids saving the file to disk, which is faster and cleaner.
+        file_bytes = np.frombuffer(file.read(), np.uint8)
+        image = cv2.imdecode(file_bytes, cv2.IMREAD_COLOR)
+
+        # Pass the image to our AI engine
+        result = emotion_detector.detect_emotion(image)
+        
+        return jsonify(result)
+
+    except Exception as e:
+        return jsonify({"error": str(e)}), 500

app/api/endpoints/remedies.py

@@ -0,0 +1,22 @@
+from flask import Blueprint, request, jsonify
+from app.services.remedy_engine import remedy_engine
+
+remedies_bp = Blueprint('remedies', __name__)
+
+@remedies_bp.route('/get_advice', methods=['GET'])
+def get_advice():
+    """
+    Query Param: ?condition=Depression
+    Returns: JSON with meds, treatments, and Gita story.
+    """
+    condition = request.args.get('condition')
+    
+    if not condition:
+        return jsonify({"error": "Missing 'condition' parameter"}), 400
+
+    result = remedy_engine.get_remedy(condition)
+
+    if result:
+        return jsonify(result)
+    else:
+        return jsonify({"message": "No specific remedy found for this condition."}), 404

app/api/endpoints/therapist.py

@@ -0,0 +1,33 @@
+from flask import Blueprint, request, jsonify
+from app.services.llm_engine import llm_therapist
+
+therapist_bp = Blueprint('therapist', __name__)
+
+@therapist_bp.route('/chat', methods=['POST'])
+def chat():
+    """
+    Expects JSON:
+    {
+        "message": "I feel anxious",
+        "emotion": "fear",
+        "history": [
+            {"role": "user", "content": "Hi"},
+            {"role": "assistant", "content": "Hello!"}
+        ]
+    }
+    """
+    data = request.get_json()
+    
+    user_message = data.get('message', '')
+    current_emotion = data.get('emotion', None)
+    history = data.get('history', [])
+
+    if not user_message:
+        return jsonify({"error": "Message cannot be empty"}), 400
+
+    # Generate response
+    response_text = llm_therapist.generate_response(user_message, current_emotion, history)
+
+    return jsonify({
+        "response": response_text
+    })

app/main.py

@@ -0,0 +1,33 @@
+import os
+from flask import Flask
+from flask_cors import CORS
+from dotenv import load_dotenv
+
+# Load environment variables (API Keys) from .env
+load_dotenv()
+
+# Import the 3 Endpoints
+from app.api.endpoints.facial import facial_bp
+from app.api.endpoints.remedies import remedies_bp
+from app.api.endpoints.therapist import therapist_bp
+
+def create_app():
+    app = Flask(__name__)
+    
+    # Enable CORS so Frontend (port 5173) can talk to Backend (port 5000)
+    CORS(app)
+
+    # Register the Blueprints (The 3 features)
+    app.register_blueprint(facial_bp, url_prefix='/api')
+    app.register_blueprint(remedies_bp, url_prefix='/api')
+    app.register_blueprint(therapist_bp, url_prefix='/api')
+
+    return app
+
+if __name__ == '__main__':
+    app = create_app()
+    print("🚀 PsyPredict Backend is fully operational on http://localhost:5000")
+    print("   - /api/predict/emotion [POST]")
+    print("   - /api/get_advice?condition=... [GET]")
+    print("   - /api/chat [POST]")
+    app.run(host='0.0.0.0', port=5000, debug=True)

app/ml_assets/MEDICATION.csv

@@ -0,0 +1,47 @@
+Mental Condition,Symptoms,Recommended Treatments,Medications,Dosage,Advanced Remedies
+Depression,sadness; loss of interest; fatigue; hopeless; worthlessness,Cognitive Behavioral Therapy (CBT); Exercise,Fluoxetine; Sertraline,20 mg daily; 50 mg daily,"""Imagine you are Arjuna standing in the middle of a battlefield, feeling confused and helpless. Lord Krishna told him: 'You must focus on doing your duty, not worry about what will happen next.' Similarly, when sadness feels overwhelming, focus on small actions like taking a walk or journaling. Step by step, your path becomes clearer."""
+Anxiety,worry; restlessness; nervousness; panic; fear,Mindfulness; Deep Breathing Exercises,Buspirone; Clonazepam,10 mg twice daily; 0.5 mg twice daily,"""Think of your mind as a restless river that keeps rushing and never rests. Krishna said peace comes from steady action. Instead of trying to stop the river all at once, observe the flow calmly. Breathe deeply and tell yourself, 'It’s okay to feel nervous. I don’t have to control everything now.'"""
+PTSD,flashbacks; nightmares; severe anxiety; trauma; dissociation,Trauma-Focused CBT; EMDR,Paroxetine; Sertraline,20 mg daily; 50 mg daily,"""Picture yourself as Arjuna who felt afraid of fighting his own family. Lord Krishna advised that facing fear is part of life. When painful memories come back, remind yourself they are passing shadows. Gently acknowledge them, knowing they will pass, and keep moving forward."""
+Bipolar Disorder,mood swings; mania; depression; euphoria; impulsivity; irritability,Mood Stabilizers; CBT,Lithium; Valproate,300 mg daily; 500 mg twice daily,"""Life has highs and lows, like waves in the ocean. The Gita teaches focusing on steady actions without getting lost in emotions. Create daily routines and treat mood swings as temporary weather changes, not permanent states."""
+Schizophrenia,hallucinations; delusions; disorganized thinking; paranoia; social withdrawal,Antipsychotic Medications; CBT,Risperidone; Olanzapine,2 mg daily; 10 mg daily,"""Schizophrenia may distort reality, but the Gita teaches our true self is beyond illusions. Therapy and medications stabilize perception, like dawn gradually clearing a misty morning."""
+OCD,intrusive thoughts; repetitive behaviors; compulsions; rituals; anxiety-driven actions,CBT (Exposure and Response Prevention); Medication,Fluoxetine; Sertraline,20 mg daily; 50 mg daily,"""OCD feels like being trapped in a loop. The Gita teaches observing thoughts without reacting. Like clouds passing in the sky, they come and go. Mindfulness helps you understand they don’t define you."""
+ADHD,inattention; hyperactivity; impulsivity; difficulty focusing; forgetfulness,Behavioral Therapy; Medication,Methylphenidate; Atomoxetine,10 mg daily; 40 mg daily,"""ADHD makes focusing hard. Krishna teaches purpose-driven action. Set small goals, focus on one thing at a time, and remind yourself: 'Every small task I do is a step toward my goal,' helping you build structure."""
+Borderline Personality Disorder,intense emotions; unstable relationships; self-harm; fear of abandonment; impulsivity,Dialectical Behavior Therapy (DBT); Medication,Lamotrigine; Aripiprazole,100 mg daily; 10 mg daily,"""Feelings rise and fall like waves. The Gita suggests watching them without acting. Like a calm observer, you’ll see emotions pass without dragging you."""
+Eating Disorders,disordered eating; preoccupation with weight; binge eating; purging; extreme dieting,Nutritional Counseling; CBT,Fluoxetine; Olanzapine,20 mg daily; 10 mg daily,"""Eating disorders come from a distorted self-image. The Gita reminds us our worth comes from inner values, not appearance. Care for your body gently, like tending a garden."""
+Self-esteem Issues,low self-worth; negative self-image; inferiority; self-doubt,CBT; Motivational Interviewing,Sertraline; Escitalopram,50 mg daily; 10 mg daily,"""Self-esteem grows when you realize your worth lies in trying your best, not perfection. The Gita teaches to focus on effort as your true achievement."""
+Social Anxiety Disorder,fear of social situations; avoidance; embarrassment; self-consciousness,CBT; Social Skills Training,Paroxetine; Clonazepam,20 mg daily; 0.5 mg twice daily,"""Social anxiety makes interaction hard. Krishna says focus on duty, not judgment. Start with small conversations, and remind yourself: 'Each small step is progress.'"""
+Generalized Anxiety Disorder,excessive worry; muscle tension; restlessness; difficulty concentrating,CBT; Medication,Buspirone; Clonazepam,10 mg twice daily; 0.5 mg twice daily,"""Generalized anxiety makes you worry about everything. The Gita teaches handling what you can now and letting go of tomorrow's fears."""
+Panic Disorder,panic attacks; dizziness; heart palpitations; shortness of breath,CBT; Exposure Therapy,Paroxetine; Sertraline,20 mg daily; 50 mg daily,"""Panic feels like a storm. The Gita says observe it calmly. Breathe deeply and remember: this storm will pass."""
+Obsessive-Compulsive Personality Disorder,perfectionism; control; orderliness; rigidity,CBT; Behavioral Therapy,Fluoxetine; Clomipramine,20 mg daily; 25 mg daily,"""Perfection is impossible. The Gita teaches adaptability. Do your best, and let go of impossible standards."""
+Substance Use Disorder,substance abuse; dependency; withdrawal; cravings; tolerance,Behavioral Therapy; Medication,Naltrexone; Methadone,50 mg daily; 30 mg daily,"""True freedom comes from letting go of harmful habits. The Gita teaches replacing unhealthy attachments with positive ones."""
+Autism Spectrum Disorder,social difficulties; restricted interests; repetitive behaviors; communication challenges,Supportive Therapy; Occupational Therapy,Risperidone; Aripiprazole,2 mg daily; 10 mg daily,"""Autism makes social situations confusing. The Gita teaches compassion and patience. Your unique path is valuable."""
+Dissociative Identity Disorder,multiple personalities; memory gaps; dissociation; identity confusion,Psychotherapy; Medication,Fluoxetine; Sertraline,20 mg daily; 50 mg daily,"""Your core self is stable. Therapy helps integrate fragmented parts, showing that every identity is a piece of the whole."""
+Grief,sorrow; loss; mourning; sadness; emptiness,Supportive Counseling; Grief Therapy,None Typically,None Typically,"""Grief is part of life’s cycle. The Gita teaches acceptance and meaningful action, gently helping you heal over time."""
+Seasonal Affective Disorder,depression in winter; lack of sunlight; fatigue; low mood during winter,Light Therapy; CBT,Fluoxetine; Bupropion,20 mg daily; 150 mg daily,"""Winter feels long and dark, but like light eventually shines, the Gita teaches hope and steady small actions through dark times."""
+Insomnia,difficulty sleeping; waking at night; restlessness; trouble falling asleep,CBT-I; Sleep Hygiene Practices,Trazodone; Zolpidem,50 mg at night; 10 mg at night,"""Sleep comes when you stop chasing it. The Gita teaches calming the mind through routine and breathing."""
+Intermittent Explosive Disorder,anger outbursts; aggression; irritability; uncontrollable rage,DBT; Medication,Lamotrigine; Risperidone,100 mg daily; 2 mg daily,"""Anger is like a passing cloud. Observe it without judgment, and it will fade."""
+Trichotillomania,pulling out hair; hair loss; compulsive behavior; hair-pulling urges,Habit Reversal Therapy; Behavioral Therapy,None Typically,None Typically,"""Urges are temporary. Watch them like clouds in the sky. They pass."""
+Dermatillomania,skin picking; skin lesions; compulsive behavior; skin damage,Behavioral Therapy; Medication,Fluoxetine; Sertraline,20 mg daily; 50 mg daily,"""See the urge to pick as a passing thought, not a command. Gently let it pass."""
+Somatic Symptom Disorder,physical symptoms; excessive focus on health; distress; preoccupation with symptoms,CBT; Supportive Counseling,None Typically,None Typically,"""Focus on real duties and gentle self-care. Symptoms will fade like shadows."""
+Conversion Disorder,neurological symptoms; paralysis; unexplained symptoms; loss of motor function,Psychotherapy; Physical Therapy,None Typically,None Typically,"""Trust your body’s ability to heal. Calm your mind and therapy will help."""
+Factitious Disorder,faking illness; deception; symptom fabrication; self-induced symptoms,Psychotherapy; Medication,None Typically,None Typically,"""Be honest with yourself. Real healing comes from facing truth, not fabricating pain."""
+Malingering,falsifying symptoms; external incentives; deceitful behavior; feigned illness,Psychotherapy; Supportive Counseling,None Typically,None Typically,"""True progress comes from aligning actions with inner truth."""
+Acute Stress Disorder,dissociation; intrusive memories; anxiety after trauma; emotional numbness,Trauma-Focused CBT; EMDR,Paroxetine; Sertraline,20 mg daily; 50 mg daily,"""Suffering is temporary. Like a flowing river, let each moment pass without holding on."""
+Schizoaffective Disorder,schizophrenia symptoms; mood disorder symptoms; psychosis; emotional instability,Medication; CBT,Risperidone; Lithium,2 mg daily; 300 mg daily,"""Balance is key. Focus on daily small actions, supported by therapy and medicine."""
+Premenstrual Dysphoric Disorder,severe PMS; mood swings before menstruation; irritability; sadness,CBT; Lifestyle Changes,Fluoxetine; Sertraline,20 mg daily; 50 mg daily,"""Accept the cycle of life. Each phase is temporary. Self-care and compassion help you through."""
+Adjustment Disorders,emotional symptoms; behavioral symptoms; difficulty coping,Psychotherapy; Supportive Counseling,None Typically,None Typically,"""Life is change. Like Arjuna adjusted in battle, take small steady steps to adapt."""
+Burnout,exhaustion; cynicism; reduced efficacy; emotional depletion,CBT; Mindfulness,None Typically,None Typically,"""Balance effort with rest. Every small meaningful action helps rebuild energy."""
+Internet Addiction,compulsive internet use; neglecting responsibilities; social withdrawal,Behavioral Therapy; Mindfulness,None Typically,None Typically,"""Digital interaction is temporary. Real connection grows slowly, step by step."""
+Phone Addiction,excessive phone use; neglecting real interactions; constant checking,Mindfulness; Behavioral Therapy,None Typically,None Typically,"""Like Krishna teaches, presence matters more than constant connection. Start small."""
+Loneliness,feeling isolated; lack of companionship; disconnected; longing,Psychotherapy; Social Skills Training,None Typically,None Typically,"""Your true self is always connected to the universe. Small acts of kindness rebuild connection."""
+Hopelessness,sense of despair; lack of motivation; bleak future; giving up,CBT; Supportive Therapy,None Typically,None Typically,"""Each small step you take plants a seed of hope. Even slow progress matters."""
+Anger Management Issues,anger outbursts; difficulty controlling temper; aggression; frustration,DBT; Psychotherapy,Lamotrigine; Risperidone,100 mg daily; 2 mg daily,"""Observe anger like clouds passing. Let it drift without acting."""
+Perfectionism,fear of failure; high self-standards; overcritical self-evaluation; procrastination,CBT; Mindfulness,None Typically,None Typically,"""Perfect is a myth. Focus on doing your best, one step at a time."""
+Chronic Pain Disorder,persistent pain; physical suffering; limited functionality,CBT; Physical Therapy,None Typically,None Typically,"""Pain is part of life. Like a warrior marching steadily, small self-care steps help."""
+Emotional Instability,mood swings; difficulty maintaining relationships; sensitivity to criticism,Psychotherapy; Mindfulness,None Typically,None Typically,"""Emotions come and go. Like waves in the ocean, steady practices help balance them."""
+Relationship Issues,communication problems; conflict; lack of intimacy; emotional distance,Couples Therapy; Supportive Counseling,None Typically,None Typically,"""See others with patience and compassion. Every small understanding builds connection."""
+Workplace Stress,overwhelm; tight deadlines; lack of support; dissatisfaction,CBT; Mindfulness,None Typically,None Typically,"""Focus on your duty, not recognition. Calm steps reduce pressure."""
+Financial Anxiety,money worries; fear of insolvency; budget concerns; debt anxiety,CBT; Financial Counseling,None Typically,None Typically,"""Krishna teaches responsibility without attachment. Budget calmly and steadily."""
+Parenting Stress,guilt; overwhelm; lack of confidence; relationship strain,Supportive Counseling; Psychoeducation,None Typically,None Typically,"""Parenting is a sacred duty done with love and patience. Perfection isn’t the goal."""
+Chronic Fatigue Syndrome,persistent tiredness; low energy; difficulty concentrating; sleep disturbances,CBT; Lifestyle Changes,None Typically,None Typically,"""Accept limits kindly. Every small progress is a victory."""
+Existential Crisis,meaninglessness; questioning purpose; identity confusion; fear of death,Psychotherapy; Mindfulness,None Typically,None Typically,"""Life’s purpose is found in small selfless actions, not big answers."""

app/ml_assets/emotion_model_trained.h5

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:321afafe98e32c9cf098c691e54000cf9c77f62203a2854829a128c081bcbe21
+size 190595136

app/ml_assets/emotion_model_trained.keras

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a5501fcfd57d06acc45de397c55becb4fe3e317ab7c17b40d6d1273547567397
+size 190584874

app/services/emotion_engine.py

@@ -0,0 +1,91 @@
+import os
+import cv2
+import numpy as np
+import logging
+from tensorflow.keras.models import load_model
+from tensorflow.keras.preprocessing.image import img_to_array
+
+# Define the exact labels from your notebook
+EMOTION_LABELS = ['happy', 'sad', 'angry', 'surprised', 'neutral', 'fear', 'disgust']
+
+class EmotionDetector:
+    def __init__(self):
+        self.model = None
+        self.face_cascade = None
+        self.load_resources()
+
+    def load_resources(self):
+        """Loads the ML model and Haar Cascade from the assets folder."""
+        # Dynamic path to ensure it works on any machine
+        base_path = os.path.dirname(os.path.abspath(__file__))
+        assets_path = os.path.join(base_path, '..', 'ml_assets')
+
+        model_path = os.path.join(assets_path, 'emotion_model_trained.h5')
+        haar_path = os.path.join(assets_path, 'haarcascade_frontalface_default.xml')
+
+        # Load Model
+        try:
+            self.model = load_model(model_path)
+            logging.info(f"✅ Emotion Model loaded from {model_path}")
+        except Exception as e:
+            logging.error(f"❌ Failed to load model: {e}")
+
+        # Load Face Detector
+        try:
+            self.face_cascade = cv2.CascadeClassifier(haar_path)
+            if self.face_cascade.empty():
+                raise IOError("Failed to load Haarcascade XML file")
+            logging.info(f"✅ Face Detector loaded from {haar_path}")
+        except Exception as e:
+            logging.error(f"❌ Failed to load Haarcascade: {e}")
+
+    def detect_emotion(self, image_path_or_array):
+        """
+        Input: Image (numpy array or file path)
+        Output: Dictionary with 'emotion' and 'confidence'
+        """
+        if self.model is None or self.face_cascade is None:
+            return {"error": "AI models are not loaded"}
+
+        # 1. Read Image
+        if isinstance(image_path_or_array, str):
+            image = cv2.imread(image_path_or_array)
+        else:
+            image = image_path_or_array
+
+        if image is None:
+            return {"error": "Invalid image input"}
+
+        # 2. Convert to Grayscale
+        gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
+
+        # 3. Detect Face
+        faces = self.face_cascade.detectMultiScale(gray, scaleFactor=1.3, minNeighbors=5)
+
+        if len(faces) == 0:
+            return {"message": "No face detected"}
+
+        # 4. Process the first detected face
+        (x, y, w, h) = faces[0]
+        roi_gray = gray[y:y+h, x:x+w]
+        
+        # 5. Preprocessing (Resize to 48x48 & Normalize)
+        roi = cv2.resize(roi_gray, (48, 48), interpolation=cv2.INTER_AREA)
+        roi = roi.astype("float") / 255.0
+        roi = img_to_array(roi)
+        roi = np.expand_dims(roi, axis=0)
+
+        # 6. Predict
+        preds = self.model.predict(roi)[0]
+        label_index = preds.argmax()
+        label = EMOTION_LABELS[label_index]
+        confidence = float(preds[label_index])
+
+        return {
+            "emotion": label,
+            "confidence": round(confidence * 100, 2),
+            "face_box": [int(x), int(y), int(w), int(h)]
+        }
+
+# Create a singleton instance to be imported elsewhere
+emotion_detector = EmotionDetector()

app/services/llm_engine.py

@@ -0,0 +1,79 @@
+import os
+import google.generativeai as genai
+from dotenv import load_dotenv
+
+# Load environment variables (API Keys)
+load_dotenv()
+
+GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
+
+if not GOOGLE_API_KEY:
+    print("⚠️ Error: GOOGLE_API_KEY not found. Check your .env file!")
+else:
+    print("✅ Key loaded securely.")
+
+class LLMEngine:
+    def __init__(self):
+        self.api_key = os.getenv("GOOGLE_API_KEY")
+        self.model = None
+        self._setup_model()
+
+    def _setup_model(self):
+        """Configures the Gemini Model."""
+        if not self.api_key:
+            print("⚠️ WARNING: GOOGLE_API_KEY not found in .env file. Chat will function in 'Mock Mode'.")
+            return
+
+        try:
+            genai.configure(api_key=self.api_key)
+            self.model = genai.GenerativeModel('gemini-2.0-flash')
+            print("✅ LLM Engine: Gemini 2.0 Flash Connected")
+        except Exception as e:
+            print(f"❌ LLM Engine Error: {e}")
+
+    def generate_response(self, user_text, emotion_context=None, history=[]):
+        """
+        Generates a therapeutic response.
+        
+        Args:
+            user_text (str): The user's message.
+            emotion_context (str): The emotion detected by the camera (e.g., 'sad', 'happy').
+            history (list): Previous chat messages for context.
+        """
+        
+        # 1. Fallback if no API Key (Mock Mode)
+        if not self.model:
+            return "I am currently running in offline mode. Please set your GOOGLE_API_KEY to chat with me fully! (Detected emotion: " + str(emotion_context) + ")"
+
+        # 2. Construct the "System Prompt" (The Persona)
+        system_instruction = (
+            "You are PsyPredict, a compassionate, culturally grounded mental health assistant. "
+            "Your goal is to provide supportive, non-prescriptive guidance combining modern psychology "
+            "and wisdom from the Bhagavad Gita.\n\n"
+            "GUIDELINES:\n"
+            "1. Be empathetic and warm.\n"
+            "2. If the user seems stressed or sad, offer a short, relevant quote or metaphor from the Bhagavad Gita.\n"
+            "3. IMPORTANT: You are NOT a doctor. Do not diagnose or prescribe medication. If the user mentions self-harm, immediately provide emergency resources.\n"
+            "4. Keep responses concise (under 100 words) unless asked for a story."
+        )
+
+        # 3. Add "Fusion" Context (Visual + Text)
+        fusion_context = ""
+        if emotion_context and emotion_context != "neutral":
+            fusion_context = f"[SYSTEM NOTE: The user's facial expression currently shows '{emotion_context}'. Use this to adjust your tone.]\n"
+
+        # 4. Build the Full Prompt
+        # We combine history into a text block for simplicity (stateless request)
+        conversation_log = "\n".join([f"{msg['role']}: {msg['content']}" for msg in history[-5:]]) # Keep last 5 turns
+        
+        final_prompt = f"{system_instruction}\n\nCONVERSATION HISTORY:\n{conversation_log}\n\n{fusion_context}User: {user_text}\nAssistant:"
+
+        try:
+            # 5. Call Gemini
+            response = self.model.generate_content(final_prompt)
+            return response.text.strip()
+        except Exception as e:
+            return f"I'm having trouble connecting to my thought engine right now. Error: {str(e)}"
+
+# Singleton Instance
+llm_therapist = LLMEngine()

app/services/remedy_engine.py

@@ -0,0 +1,54 @@
+import pandas as pd
+import os
+
+class RemedyEngine:
+    def __init__(self):
+        self.df = None
+        self.load_data()
+
+    def load_data(self):
+        """Loads the MEDICATION.csv file into a Pandas DataFrame."""
+        try:
+            base_path = os.path.dirname(os.path.abspath(__file__))
+            csv_path = os.path.join(base_path, '..', 'ml_assets', 'MEDICATION.csv')
+            
+            if os.path.exists(csv_path):
+                self.df = pd.read_csv(csv_path)
+                # Normalize column names to be safe
+                self.df.columns = [c.strip() for c in self.df.columns]
+                print("✅ Remedy Engine: Knowledge Base Loaded")
+            else:
+                print(f"❌ Remedy Engine: CSV not found at {csv_path}")
+        except Exception as e:
+            print(f"❌ Remedy Engine Error: {e}")
+
+    def get_remedy(self, condition_name):
+        """
+        Searches for a condition (e.g., 'Depression') and returns the full remedy details.
+        It uses case-insensitive partial matching.
+        """
+        if self.df is None:
+            return {"error": "Database not loaded"}
+
+        # Search for the condition (case-insensitive)
+        # We check if the search term is IN the 'Mental Condition' column
+        mask = self.df['Mental Condition'].str.contains(condition_name, case=False, na=False)
+        result = self.df[mask]
+
+        if result.empty:
+            return None
+
+        # Get the first match
+        row = result.iloc[0]
+
+        return {
+            "condition": row['Mental Condition'],
+            "symptoms": row['Symptoms'],
+            "treatments": row['Recommended Treatments'],
+            "medications": row['Medications'],
+            "dosage": row['Dosage'],
+            "gita_remedy": row['Advanced Remedies']  # This is the story/advice
+        }
+
+# Singleton instance
+remedy_engine = RemedyEngine()

download_models.py

@@ -0,0 +1,25 @@
+import os
+import gdown # We will install this library
+
+# 👇 PASTE YOUR GOOGLE DRIVE IDs HERE
+MODEL_ID = "10GWSogJNKlPlTeWtJkDq_zc4roB1Vmnu"
+CSV_ID   = "1bJ8C1BY0rvPNKuWcBgqiUtiSzHziZokH"
+
+# Define where they should go
+model_path = "app/ml_assets/emotion_model_trained.h5"
+csv_path   = "app/ml_assets/MEDICATION.csv"
+
+def download_file(file_id, output_path):
+    if not os.path.exists(output_path):
+        os.makedirs(os.path.dirname(output_path), exist_ok=True)
+        url = f'https://drive.google.com/uc?id={file_id}'
+        print(f"⬇️ Downloading {output_path}...")
+        gdown.download(url, output_path, quiet=False)
+    else:
+        print(f"✅ Found {output_path}, skipping download.")
+
+if __name__ == "__main__":
+    print("🚀 Starting Model Download...")
+    download_file(MODEL_ID, model_path)
+    download_file(CSV_ID, csv_path)
+    print("✅ All models ready!")

requirements.txt

@@ -0,0 +1,17 @@
+# --- Core Backend ---
+flask
+flask-cors
+python-dotenv
+google-generativeai
+gdown
+
+# --- AI & Vision (Version Locked for Stability) ---
+numpy<2.0
+opencv-python
+tensorflow
+pandas
+tensorflow-cpu
+pillow
+
+# --- Utilities ---
+requests