Update README.md
Browse files# πΏ Psychological Health Risk Assessment (DASS-12)
This is an automated psychological health evaluation tool based on the simplified **DASS (Depression, Anxiety and Stress Scale)**. It leverages a Machine Learning model to predict potential mental health risk levels based on 12 psychological state questions.
## π Key Features
- **Instant Assessment**: Interactive interface that provides evaluation results within 5 minutes.
- **Three-Dimensional Analysis**: Calculates and visualizes specific scores for Anxiety, Depression, and Stress.
- **Cloud-Based Storage**: Test results are anonymized and securely stored in a cloud database (Google Sheets) for academic research and trend analysis.
- **Session History**: Supports viewing history logs within the current browser session.
## π Technical Stack
- **Frontend Interface**: [Gradio](https://gradio.app/)
- **Data Processing**: Pandas, Numpy
- **Machine Learning**: LightGBM (LGBMClassifier)
- **Backend Storage**: Google Sheets API (via gspread)
- **Deployment**: Hugging Face Spaces
## π File Structure
- `app.py`: The main Gradio application logic.
- `DASS_model.bin`: The pre-trained machine learning model.
- `AutoPreprocess.py`: Custom data preprocessing class.
- `requirements.txt`: List of Python dependencies required for execution.
## π Privacy & Ethics
Privacy is our top priority:
1. **Anonymity**: The "Nickname" input is used solely for the user interface and is **NEVER** transmitted to the database or used in model calculations.
2. **Data Collection**: Collected data includes: timestamp, basic demographics (Gender/Age/Family Size), dimensional scores, and the 12 raw responses.
3. **Disclaimer**: This tool is not a medical device. Results are for reference only and do not constitute a formal diagnosis.
## π₯ Development Team
- Group 4: Mental Health Risk Prediction Team πΏ
|
@@ -8,5 +8,5 @@ sdk_version: 6.8.0
|
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
-
|
| 12 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
+
|
| 12 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|