avtak commited on
Commit
f11a0ed
Β·
verified Β·
1 Parent(s): 69e7821

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +30 -12
README.md CHANGED
@@ -4,8 +4,9 @@ emoji: 🧠
4
  colorFrom: blue
5
  colorTo: purple
6
  sdk: gradio
7
- sdk_version: 5.0.0
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
- ## Team
 
 
 
 
 
 
 
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)