Felix Chiuman
commited on
Update README.md
Browse files
README.md
CHANGED
@@ -1,2 +1,41 @@
|
|
1 |
-
#
|
2 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# π§ Mental Health Assistant: PTSD-Aware Text Analysis
|
2 |
+
|
3 |
+
**A mental health NLP tool that summarizes trauma narratives, detects emotional tone, classifies psychological state, and provides LLM-generated coping suggestions for PTSD.**
|
4 |
+
|
5 |
+
---
|
6 |
+
|
7 |
+
## π Description
|
8 |
+
|
9 |
+
This project uses state-of-the-art NLP models to assist with mental health support by analyzing clinical or trauma-related patient reports.
|
10 |
+
It aims to provide summarized insights, emotional profiling, and self-care strategies based on the content, using Hugging Face Transformers and Gradio.
|
11 |
+
|
12 |
+
---
|
13 |
+
|
14 |
+
## π‘ Features
|
15 |
+
|
16 |
+
| Task | Model Used |
|
17 |
+
|---------------------------|----------------------------------------------------------------------------|
|
18 |
+
| π Summarization | `machinelearningzuu/ptsd-summarization` |
|
19 |
+
| π Sentiment Analysis | Hugging Face `sentiment-analysis` pipeline |
|
20 |
+
| π‘ Emotion Classification | `nateraw/bert-base-uncased-emotion` |
|
21 |
+
| π PTSD Coping Suggestions | `deepseek-ai/deepseek-llm-7b-chat` |
|
22 |
+
|
23 |
+
---
|
24 |
+
|
25 |
+
## π Live Demo
|
26 |
+
|
27 |
+
π **Launch on Hugging Face Spaces:**
|
28 |
+
[https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME)
|
29 |
+
|
30 |
+
---
|
31 |
+
|
32 |
+
## π Security Note
|
33 |
+
|
34 |
+
This app uses a Hugging Face token to access gated models like DeepSeek.
|
35 |
+
|
36 |
+
Use Hugging Face **Secrets** for safe token management (in Spaces dashboard):
|
37 |
+
|
38 |
+
```python
|
39 |
+
import os
|
40 |
+
from huggingface_hub import login
|
41 |
+
login(os.getenv("HF_TOKEN"))
|