Spaces:
Configuration error
Configuration error
Delete README.md
Browse files
README.md
DELETED
|
@@ -1,146 +0,0 @@
|
|
| 1 |
-
🤖 MAXA – Max Assistance
|
| 2 |
-
AI Integrated Academic & Mental Health Support System for High School Students
|
| 3 |
-
|
| 4 |
-
Team: B-max
|
| 5 |
-
Members: Ngô Gia Duy Anh – Nguyễn Đức Lâm – Lê Văn Duy Hiếu
|
| 6 |
-
Competition: AI Young Guru
|
| 7 |
-
|
| 8 |
-
📌 1. Overview
|
| 9 |
-
|
| 10 |
-
Maxa (Max Assistance) is an AI-powered web application designed to support high school students (15–17 years old) in managing:
|
| 11 |
-
|
| 12 |
-
📊 Academic stress
|
| 13 |
-
|
| 14 |
-
🔎 Misinformation related to exams and university admissions
|
| 15 |
-
|
| 16 |
-
🎯 Personalized study planning
|
| 17 |
-
|
| 18 |
-
The system integrates Natural Language Processing (NLP), Machine Learning, Generative AI (GenAI), and Retrieval-Augmented Generation (RAG) into one unified platform.
|
| 19 |
-
|
| 20 |
-
Unlike traditional single-function tools, Maxa provides a holistic support model that combines psychological analysis, academic personalization, and information verification.
|
| 21 |
-
|
| 22 |
-
🎯 2. Problem Statement
|
| 23 |
-
|
| 24 |
-
According to the World Health Organization, adolescent mental health is a growing global concern.
|
| 25 |
-
|
| 26 |
-
High school students face increasing stress due to:
|
| 27 |
-
|
| 28 |
-
Academic pressure and university entrance exams
|
| 29 |
-
|
| 30 |
-
Family and societal expectations
|
| 31 |
-
|
| 32 |
-
Social media comparison (TikTok, Facebook, Instagram)
|
| 33 |
-
|
| 34 |
-
Exposure to unverified or misleading educational information
|
| 35 |
-
|
| 36 |
-
At the same time, the education system often applies standardized methods to students who:
|
| 37 |
-
|
| 38 |
-
Have different learning capacities
|
| 39 |
-
|
| 40 |
-
Have diverse career orientations
|
| 41 |
-
|
| 42 |
-
Have different stress tolerance levels
|
| 43 |
-
|
| 44 |
-
There is currently no integrated system that simultaneously:
|
| 45 |
-
|
| 46 |
-
Detects stress early
|
| 47 |
-
|
| 48 |
-
Verifies educational information
|
| 49 |
-
|
| 50 |
-
Personalizes learning pathways
|
| 51 |
-
|
| 52 |
-
Maxa addresses this gap.
|
| 53 |
-
|
| 54 |
-
🧠 3. Core Features
|
| 55 |
-
1️⃣ Stress Level Prediction
|
| 56 |
-
|
| 57 |
-
Emotion analysis from student journal input
|
| 58 |
-
|
| 59 |
-
Sentiment classification
|
| 60 |
-
|
| 61 |
-
Stress scoring and categorization:
|
| 62 |
-
|
| 63 |
-
🟢 Low
|
| 64 |
-
|
| 65 |
-
🟡 Medium
|
| 66 |
-
|
| 67 |
-
🟠 High
|
| 68 |
-
|
| 69 |
-
🔴 Critical Risk
|
| 70 |
-
|
| 71 |
-
The system can provide early warnings when stress reaches high levels.
|
| 72 |
-
|
| 73 |
-
2️⃣ Fake Information Detection (RAG-based)
|
| 74 |
-
|
| 75 |
-
Using Retrieval-Augmented Generation (RAG), the system:
|
| 76 |
-
|
| 77 |
-
Retrieves information from trusted educational sources
|
| 78 |
-
|
| 79 |
-
Compares user input with verified data
|
| 80 |
-
|
| 81 |
-
Provides:
|
| 82 |
-
|
| 83 |
-
Reliability percentage
|
| 84 |
-
|
| 85 |
-
Reference sources
|
| 86 |
-
|
| 87 |
-
Warning signals for misinformation
|
| 88 |
-
|
| 89 |
-
This enhances students’ digital literacy and critical thinking skills.
|
| 90 |
-
|
| 91 |
-
3️⃣ Personalized Study Plan Generator
|
| 92 |
-
|
| 93 |
-
Based on:
|
| 94 |
-
|
| 95 |
-
Current stress level
|
| 96 |
-
|
| 97 |
-
Academic goals (A, B, C, D subject groups…)
|
| 98 |
-
|
| 99 |
-
Strengths and weaknesses
|
| 100 |
-
|
| 101 |
-
GenAI generates:
|
| 102 |
-
|
| 103 |
-
Weekly/monthly study schedules
|
| 104 |
-
|
| 105 |
-
Time management strategies
|
| 106 |
-
|
| 107 |
-
Balanced subject planning
|
| 108 |
-
|
| 109 |
-
Career orientation suggestions
|
| 110 |
-
|
| 111 |
-
If stress is high → study intensity is adjusted.
|
| 112 |
-
If academic imbalance is detected → corrective scheduling is suggested.
|
| 113 |
-
|
| 114 |
-
🏗 4. System Architecture
|
| 115 |
-
User Input (Web Interface)
|
| 116 |
-
↓
|
| 117 |
-
Data Preprocessing (NLP)
|
| 118 |
-
↓
|
| 119 |
-
┌───────────────┬───────────────┬────────────────┐
|
| 120 |
-
│ Stress Model │ Fake News RAG │ Study Planner │
|
| 121 |
-
└───────────────┴───────────────┴────────────────┘
|
| 122 |
-
↓
|
| 123 |
-
Personalized AI Response
|
| 124 |
-
⚙️ 5. Technologies Used
|
| 125 |
-
Component Technology
|
| 126 |
-
Programming Language Python
|
| 127 |
-
UI Framework Gradio (Hugging Face Spaces)
|
| 128 |
-
NLP Transformers
|
| 129 |
-
ML Model Classification model
|
| 130 |
-
GenAI Text generation
|
| 131 |
-
RAG FAISS + Retrieval Pipeline
|
| 132 |
-
Database (future expansion) Structured data storage
|
| 133 |
-
🚀 6. Deployment
|
| 134 |
-
|
| 135 |
-
This application is deployed on Hugging Face Spaces using:
|
| 136 |
-
|
| 137 |
-
Gradio interface
|
| 138 |
-
|
| 139 |
-
Python backend
|
| 140 |
-
|
| 141 |
-
Transformer-based NLP pipeline
|
| 142 |
-
|
| 143 |
-
To run locally:
|
| 144 |
-
|
| 145 |
-
pip install -r requirements.txt
|
| 146 |
-
python app.py
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|