Spaces:
Sleeping
Sleeping
Update README.md
Browse files
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:
|
| 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
|
| 34 |
|
| 35 |
-
|
| 36 |
-
|
| 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 |
-
**
|
|
|
|
|
|
|
|
|
|
| 43 |
|
| 44 |
-
|
| 45 |
-
The agent
|
| 46 |
-
-
|
| 47 |
-
|
| 48 |
-
- Social withdrawal indicators
|
| 49 |
-
- Hopelessness themes
|
| 50 |
-
- Disrupted sleep/energy patterns
|
| 51 |
|
| 52 |
-
##
|
| 53 |
-
|
| 54 |
-
-
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
- Validated on held-out eRisk 2025 test set
|
| 58 |
|
| 59 |
-
##
|
| 60 |
-
|
|
|
|
|
|
|
| 61 |
|
| 62 |
## β οΈ Ethical Considerations
|
| 63 |
-
This is a research tool, **not a medical diagnostic instrument**.
|
| 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)
|