avtak commited on
Commit
b47e2e7
Β·
verified Β·
1 Parent(s): 290315c

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +26 -30
README.md CHANGED
@@ -9,13 +9,16 @@ app_file: app.py
9
  pinned: true
10
  tags:
11
  - mcp-in-action-track-consumer
 
 
 
12
  - depression-detection
13
  - mental-health
14
  - longformer
15
  - mcp
16
  - agents
17
  license: mit
18
- short_description: MCP-enabled depression detection agent
19
  ---
20
 
21
  # 🧠 Early Depression Detection MCP Agent
@@ -26,42 +29,35 @@ short_description: MCP-enabled depression detection agent
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)
 
9
  pinned: true
10
  tags:
11
  - mcp-in-action-track-consumer
12
+ - sambanova
13
+ - nebius
14
+ - huggingface
15
  - depression-detection
16
  - mental-health
17
  - longformer
18
  - mcp
19
  - agents
20
  license: mit
21
+ short_description: Agentic depression detection using Kimi K2/Llama 3
22
  ---
23
 
24
  # 🧠 Early Depression Detection MCP Agent
 
29
  ## πŸ“Ή Demo Video
30
  [INSERT YOUTUBE/LOOM LINK HERE]
31
 
 
 
 
32
  ## 🎯 Project Description
33
+ This MCP-enabled agent detects depression risk from social media text using **Mental-Longformer** as a clinical tool and **SambaNova/Nebius** as reasoning engines. It achieves an **F1-score of 0.7668** on eRisk 2025 test data.
34
 
35
+ ### πŸ€– Multi-Provider Agent Architecture
36
+ This agent demonstrates **MCP integration** by orchestrating specialized tools with high-performance LLMs:
 
 
 
 
37
 
38
+ 1. **Tool Layer (The "Eyes"):**
39
+ * **Model:** `avtak/erisk-longformer-depression-v1` (My fine-tuned model).
40
+ * **Capability:** 4,096-token context window for analyzing long user timelines.
41
+ * **Logic:** Implements thesis findings (Echo Chamber effects, Nocturnal patterns).
42
 
43
+ 2. **Reasoning Layer (The "Brain"):**
44
+ * **User Choice:** The agent allows switching between reasoning providers.
45
+ * **SambaNova:** Uses `Meta-Llama-3.1-70B-Instruct` for lightning-fast inference.
46
+ * **Nebius:** Uses `moonshotai/Kimi-K2-Thinking` for advanced reasoning.
 
 
 
47
 
48
+ ## πŸ§ͺ Thesis Findings Integrated
49
+ The agent doesn't just output a score; it looks for specific behavioral biomarkers identified in my Master's Thesis:
50
+ * **"High-Effort, Low-Frequency":** Depressed users write 33% longer posts but post less often.
51
+ * **"The Homophily Cascade":** Users in the "Moderate" risk zone often engage in "Echo Chambers" (11.7x higher interaction with depressed users).
52
+ * **"Nocturnal Posting":** High-risk users show distinct activity spikes between 00:00 - 05:00 UTC.
 
53
 
54
+ ## πŸ† Research Background
55
+ Built on Master's thesis research at **University of Malaya**:
56
+ - **Data Augmentation:** Used Gemini 2.5 Flash Lite to balance the dataset.
57
+ - **Validation:** Rigorous 5-fold cross-validation (mean F1: 0.862).
58
 
59
  ## ⚠️ Ethical Considerations
60
+ This is a research tool, **not a medical diagnostic instrument**.
 
61
  **Crisis Resources:**
62
  - πŸ†˜ Crisis Text Line: Text HOME to 741741 (US)
63
+ - 🌍 International: [befrienders.org](https://befrienders.org)