Spaces:
Sleeping
Sleeping
Update README.md
Browse files
README.md
CHANGED
|
@@ -4,8 +4,9 @@ emoji: π§
|
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: purple
|
| 6 |
sdk: gradio
|
| 7 |
-
sdk_version:
|
| 8 |
app_file: app.py
|
|
|
|
| 9 |
tags:
|
| 10 |
- mcp-in-action-track-consumer
|
| 11 |
- depression-detection
|
|
@@ -14,6 +15,7 @@ tags:
|
|
| 14 |
- mcp
|
| 15 |
- agents
|
| 16 |
license: mit
|
|
|
|
| 17 |
---
|
| 18 |
|
| 19 |
# π§ Early Depression Detection MCP Agent
|
|
@@ -21,29 +23,45 @@ license: mit
|
|
| 21 |
**Hackathon:** MCP 1st Birthday - Track 2: MCP in Action (Consumer)
|
| 22 |
**Author:** Hassan Hassanzadeh Aliabadi | [LinkedIn](https://www.linkedin.com/in/hassanzh/)
|
| 23 |
|
| 24 |
-
## Demo Video
|
| 25 |
-
[INSERT YOUTUBE LINK HERE]
|
| 26 |
|
| 27 |
-
## Social Media Post
|
| 28 |
[INSERT LINKEDIN/X POST LINK HERE]
|
| 29 |
|
| 30 |
-
## Project Description
|
| 31 |
-
This MCP-enabled agent detects depression risk from social media text using Mental-Longformer, achieving F1-score of 0.7668 on eRisk 2025 test data.
|
| 32 |
|
| 33 |
**Key Features:**
|
| 34 |
-
- 4,096-token context window (8x BERT's capacity)
|
| 35 |
-
- Trained on eRisk 2017-2022 datasets
|
| 36 |
-
- Data augmentation with Gemini 2.5 Flash Lite
|
| 37 |
-
- Real-time linguistic pattern analysis
|
|
|
|
| 38 |
|
| 39 |
**Model:** [avtak/erisk-longformer-depression-v1](https://huggingface.co/avtak/erisk-longformer-depression-v1)
|
| 40 |
|
| 41 |
-
## How It Works
|
| 42 |
The agent analyzes long-form text for linguistic markers including:
|
| 43 |
- Anhedonia (loss of interest)
|
| 44 |
- Self-focused negative language
|
| 45 |
- Social withdrawal indicators
|
| 46 |
- Hopelessness themes
|
|
|
|
| 47 |
|
| 48 |
-
##
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 49 |
- Hassan Hassanzadeh Aliabadi (@avtak)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
colorFrom: blue
|
| 5 |
colorTo: purple
|
| 6 |
sdk: gradio
|
| 7 |
+
sdk_version: 6.0.1
|
| 8 |
app_file: app.py
|
| 9 |
+
pinned: true
|
| 10 |
tags:
|
| 11 |
- mcp-in-action-track-consumer
|
| 12 |
- depression-detection
|
|
|
|
| 15 |
- mcp
|
| 16 |
- agents
|
| 17 |
license: mit
|
| 18 |
+
short_description: MCP-enabled depression detection agent
|
| 19 |
---
|
| 20 |
|
| 21 |
# π§ Early Depression Detection MCP Agent
|
|
|
|
| 23 |
**Hackathon:** MCP 1st Birthday - Track 2: MCP in Action (Consumer)
|
| 24 |
**Author:** Hassan Hassanzadeh Aliabadi | [LinkedIn](https://www.linkedin.com/in/hassanzh/)
|
| 25 |
|
| 26 |
+
## πΉ Demo Video
|
| 27 |
+
[INSERT YOUTUBE/LOOM LINK HERE]
|
| 28 |
|
| 29 |
+
## π± Social Media Post
|
| 30 |
[INSERT LINKEDIN/X POST LINK HERE]
|
| 31 |
|
| 32 |
+
## π― Project Description
|
| 33 |
+
This MCP-enabled agent detects depression risk from social media text using Mental-Longformer, achieving **F1-score of 0.7668** on eRisk 2025 test data.
|
| 34 |
|
| 35 |
**Key Features:**
|
| 36 |
+
- π 4,096-token context window (8x BERT's capacity)
|
| 37 |
+
- π Trained on eRisk 2017-2022 datasets
|
| 38 |
+
- π€ Data augmentation with Gemini 2.5 Flash Lite
|
| 39 |
+
- β‘ Real-time linguistic pattern analysis
|
| 40 |
+
- π MCP-enabled for agent integration
|
| 41 |
|
| 42 |
**Model:** [avtak/erisk-longformer-depression-v1](https://huggingface.co/avtak/erisk-longformer-depression-v1)
|
| 43 |
|
| 44 |
+
## π§ͺ How It Works
|
| 45 |
The agent analyzes long-form text for linguistic markers including:
|
| 46 |
- Anhedonia (loss of interest)
|
| 47 |
- Self-focused negative language
|
| 48 |
- Social withdrawal indicators
|
| 49 |
- Hopelessness themes
|
| 50 |
+
- Disrupted sleep/energy patterns
|
| 51 |
|
| 52 |
+
## π Research Background
|
| 53 |
+
Built on Master's thesis research at **University of Malaya**, this model addresses critical challenges in early depression detection:
|
| 54 |
+
- Handles imbalanced datasets through LLM-powered augmentation
|
| 55 |
+
- Captures long-context dependencies (4096 vs 512 tokens)
|
| 56 |
+
- Rigorous 5-fold cross-validation (mean F1: 0.862, std: 0.009)
|
| 57 |
+
- Validated on held-out eRisk 2025 test set
|
| 58 |
+
|
| 59 |
+
## π₯ Team
|
| 60 |
- Hassan Hassanzadeh Aliabadi (@avtak)
|
| 61 |
+
|
| 62 |
+
## β οΈ Ethical Considerations
|
| 63 |
+
This is a research tool, **not a medical diagnostic instrument**. Always consult qualified healthcare professionals for mental health concerns.
|
| 64 |
+
|
| 65 |
+
**Crisis Resources:**
|
| 66 |
+
- π Crisis Text Line: Text HOME to 741741 (US)
|
| 67 |
+
- π International: [befrienders.org](https://befrienders.org)
|