🎯 Problem Statement:
Mental health deterioration often appears through subtle, sustained behavioral changes long before clinical diagnosis. Existing systems depend heavily on self-reporting and delayed assessments, making early intervention difficult.
💡 Solution Overview:
This platform:
• Collects simple daily experience inputs
• Computes a risk score based on trends and persistence
• Visualizes risk level, trend, and contributing factors
• Avoids self-diagnosis or medical claims
• The system focuses on early risk detection, not treatment.
🧩 Core Features:
📊 Risk Dashboard:
• Current Risk Level
• Risk Score
• Persistence Days
• Stress Trend Visualization
📈 Trend Analysis:
• Daily stress vs personal baseline
• Detects sustained deviation, not single bad days
📉 Signal Breakdown:
• Focus difficulty
• Mental exhaustion
• Sleep disruption
• Workload
• Emotional friction
📝 Daily Check-In:
• Multi-step, human-friendly input
• No self-diagnosis required
🛠 Tech Stack:
Backend:
• FastAPI
• PostgreSQL
• Python
Frontend:
• React (Vite)
• Recharts
• Framer Motion
• CSS Grid / Flexbox
⚙️ Setup Instructions:
1️⃣ Backend Setup:
cd backend python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt
Set up .env with your PostgreSQL URL:
DATABASE_URL=postgresql://user:password@localhost:5432/mental_health
Run backend:
uvicorn backend.main:app --reload
Backend runs at:
2️⃣ Seed Demo Data (Recommended)
python scripts/seed_demo_data.py
This populates realistic data for demo purposes.
3️⃣ Frontend Setup:
cd frontend npm install npm run dev
Frontend runs at:
🔗 API Endpoints (Key):
Method Endpoint Description
POST /risk/daily-input Submit daily check-in GET /risk/status Current risk snapshot GET /risk/history Historical trend data
🧠 Ethical Design Notes:
• No medical diagnosis
• No mental health advice
• No personal identifiers
• Focused on decision support, not treatment
🎤 Demo Flow (Quick):
• Open Dashboard
• Explain Risk Level & Trend
• Show Signal Breakdown
• Open Daily Check-In
• Explain experience-based input
• Return to Dashboard
👥 Team:
This is completely build by NAVEENS K, JASWANT KARUN S A.
📌 SDG Alignment:
This project supports UN SDG 3 – Good Health & Well-Being by enabling early identification of mental health risk patterns, improving the potential for timely support and prevention.

Log in or sign up for Devpost to join the conversation.