MindStudy is a mood-aware study companion that helps students manage their mental well-being while staying productive. It lets users track their emotions, maintain a journal, organize daily tasks, and visualize their progress over time. By combining emotional awareness with planning features, MindStudy encourages healthy study habits, self-reflection, and balance instead of burnout.

🧐 Features

Here're some of the project's best features:

• Mood Tracking
• ML based emotion Analysis
• Personal Journaling
• Task & Study Planner
• Google Calendar Integration
• Track emotional changes
• AI Study Companion (Chat-based)
• Student-Friendly UX

How to Set Up it?

The following instructions were tested on the Windows and Linux with Python 3.13.

1. Clone this repository

git clone https://github.com/subhilogix/mood-study-planner.git

cd mood-study-planner

BACKEND

cd backend

2. Create and activate virtual environment

python -m venv venv

on Linux system

source venv/bin/activate

on Windows system

.\venv\Scripts\activate.bat

3. Install requirements

pip install  -r requirements.txt

4. Run the

uvicorn app.main:app --reload --port 8000

FRONTEND

cd frontend

1. Install requirements

npm install

2. Run the

npm run dev

Future Advancements

• AI-generated study timetable
• Mood-based task difficulty adjustment
• Deeper analytics charts
• Mobile app version