suusuu93 commited on
Commit
4aa803c
·
verified ·
1 Parent(s): 3467d27

Delete README.md

Browse files
Files changed (1) hide show
  1. README.md +0 -146
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