MoizK commited on
Commit
dbc7aad
Β·
verified Β·
1 Parent(s): c7dc5b8

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +117 -106
README.md CHANGED
@@ -1,106 +1,117 @@
1
- # MindMedic - AI Mental Health Assistant 🧠
2
-
3
- MindMedic is an AI-powered mental health diagnostic assistant built using FLAN-T5 and LangChain. It helps users understand potential mental health concerns by providing evidence-based information and preliminary insights based on trusted mental health resources.
4
-
5
- ## Table of Contents
6
-
7
- - [MindMedic - AI Mental Health Assistant 🧠](#mindmedic---ai-mental-health-assistant-)
8
- - [Table of Contents](#table-of-contents)
9
- - [Introduction](#introduction)
10
- - [Features](#features)
11
- - [Prerequisites](#prerequisites)
12
- - [Installation](#installation)
13
- - [Usage](#usage)
14
- - [Important Note](#important-note)
15
- - [Emergency Resources:](#emergency-resources)
16
- - [Contributing](#contributing)
17
-
18
- ## Introduction
19
-
20
- MindMedic leverages advanced language models and vector stores to provide informative responses to mental health-related queries. It processes and understands a curated collection of mental health resources to offer reliable, evidence-based information about various mental health conditions, symptoms, and general mental wellness topics.
21
-
22
- ## Features
23
-
24
- - πŸ€– Powered by Google's FLAN-T5 language model
25
- - πŸ“š Knowledge base built from trusted mental health resources
26
- - πŸ’‘ Provides evidence-based responses with sources
27
- - πŸ” Semantic search capabilities for accurate information retrieval
28
- - πŸ’» User-friendly chat interface powered by Chainlit
29
- - πŸ”’ Runs locally for privacy
30
-
31
- ## Prerequisites
32
-
33
- Before setting up MindMedic, ensure you have:
34
-
35
- - Python 3.6 or higher
36
- - pip (Python package manager)
37
- - 4GB+ RAM recommended
38
- - CPU with x86_64 architecture
39
-
40
- ## Installation
41
-
42
- 1. Clone this repository:
43
- ```bash
44
- git clone https://github.com/your-username/MindMedic.git
45
- cd MindMedic
46
- ```
47
-
48
- 2. Create and activate a virtual environment:
49
- ```bash
50
- python -m venv venv
51
- # On Windows
52
- venv\Scripts\activate
53
- # On Unix or MacOS
54
- source venv/bin/activate
55
- ```
56
-
57
- 3. Install required packages:
58
- ```bash
59
- pip install -r requirements.txt
60
- ```
61
-
62
- 4. Prepare the knowledge base:
63
- ```bash
64
- python ingest.py
65
- ```
66
-
67
- ## Usage
68
-
69
- 1. Start the MindMedic chatbot:
70
- ```bash
71
- chainlit run model.py -w
72
- ```
73
-
74
- 2. Open your web browser and navigate to `http://localhost:8000`
75
-
76
- 3. Start interacting with MindMedic by asking mental health-related questions
77
-
78
- Example queries:
79
- - "What are the common symptoms of anxiety?"
80
- - "How can I tell if I'm experiencing depression?"
81
- - "What are some coping strategies for stress?"
82
- - "Can you explain what panic attacks feel like?"
83
-
84
- ## Important Note
85
-
86
- ⚠️ **Disclaimer**: MindMedic is an AI assistant designed to provide information and general guidance about mental health topics. It is NOT a replacement for professional mental health care. Always consult with qualified mental health professionals for diagnosis and treatment. In case of emergency, contact your local emergency services or mental health crisis hotline immediately.
87
-
88
- ### Emergency Resources:
89
- - National Suicide Prevention Lifeline (US): 988
90
- - Crisis Text Line: Text HOME to 741741
91
- - Find local mental health resources: [NAMI HelpLine](https://www.nami.org/help)
92
-
93
- ## Contributing
94
-
95
- Contributions to improve MindMedic are welcome! To contribute:
96
-
97
- 1. Fork the repository
98
- 2. Create a feature branch
99
- 3. Make your changes
100
- 4. Submit a pull request
101
-
102
- Please ensure your contributions align with mental health best practices and maintain the focus on providing accurate, helpful information.
103
-
104
- ---
105
-
106
- Built with ❀️ for mental health awareness and support. Remember, it's okay to not be okay, and seeking help is a sign of strength.
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: MindMedic
3
+ emoji: 🧠
4
+ colorFrom: blue
5
+ colorTo: purple
6
+ sdk: docker
7
+ sdk_version: "3.0.0"
8
+ app_file: model.py
9
+ pinned: false
10
+ ---
11
+
12
+ # MindMedic - AI Mental Health Assistant 🧠
13
+
14
+ MindMedic is an AI-powered mental health diagnostic assistant built using FLAN-T5 and LangChain. It helps users understand potential mental health concerns by providing evidence-based information and preliminary insights based on trusted mental health resources.
15
+
16
+ ## Table of Contents
17
+
18
+ - [MindMedic - AI Mental Health Assistant 🧠](#mindmedic---ai-mental-health-assistant-)
19
+ - [Table of Contents](#table-of-contents)
20
+ - [Introduction](#introduction)
21
+ - [Features](#features)
22
+ - [Prerequisites](#prerequisites)
23
+ - [Installation](#installation)
24
+ - [Usage](#usage)
25
+ - [Important Note](#important-note)
26
+ - [Emergency Resources:](#emergency-resources)
27
+ - [Contributing](#contributing)
28
+
29
+ ## Introduction
30
+
31
+ MindMedic leverages advanced language models and vector stores to provide informative responses to mental health-related queries. It processes and understands a curated collection of mental health resources to offer reliable, evidence-based information about various mental health conditions, symptoms, and general mental wellness topics.
32
+
33
+ ## Features
34
+
35
+ - πŸ€– Powered by Google's FLAN-T5 language model
36
+ - πŸ“š Knowledge base built from trusted mental health resources
37
+ - πŸ’‘ Provides evidence-based responses with sources
38
+ - πŸ” Semantic search capabilities for accurate information retrieval
39
+ - πŸ’» User-friendly chat interface powered by Chainlit
40
+ - πŸ”’ Runs locally for privacy
41
+
42
+ ## Prerequisites
43
+
44
+ Before setting up MindMedic, ensure you have:
45
+
46
+ - Python 3.6 or higher
47
+ - pip (Python package manager)
48
+ - 4GB+ RAM recommended
49
+ - CPU with x86_64 architecture
50
+
51
+ ## Installation
52
+
53
+ 1. Clone this repository:
54
+ ```bash
55
+ git clone https://github.com/your-username/MindMedic.git
56
+ cd MindMedic
57
+ ```
58
+
59
+ 2. Create and activate a virtual environment:
60
+ ```bash
61
+ python -m venv venv
62
+ # On Windows
63
+ venv\Scripts\activate
64
+ # On Unix or MacOS
65
+ source venv/bin/activate
66
+ ```
67
+
68
+ 3. Install required packages:
69
+ ```bash
70
+ pip install -r requirements.txt
71
+ ```
72
+
73
+ 4. Prepare the knowledge base:
74
+ ```bash
75
+ python ingest.py
76
+ ```
77
+
78
+ ## Usage
79
+
80
+ 1. Start the MindMedic chatbot:
81
+ ```bash
82
+ chainlit run model.py -w
83
+ ```
84
+
85
+ 2. Open your web browser and navigate to `http://localhost:8000`
86
+
87
+ 3. Start interacting with MindMedic by asking mental health-related questions
88
+
89
+ Example queries:
90
+ - "What are the common symptoms of anxiety?"
91
+ - "How can I tell if I'm experiencing depression?"
92
+ - "What are some coping strategies for stress?"
93
+ - "Can you explain what panic attacks feel like?"
94
+
95
+ ## Important Note
96
+
97
+ ⚠️ **Disclaimer**: MindMedic is an AI assistant designed to provide information and general guidance about mental health topics. It is NOT a replacement for professional mental health care. Always consult with qualified mental health professionals for diagnosis and treatment. In case of emergency, contact your local emergency services or mental health crisis hotline immediately.
98
+
99
+ ### Emergency Resources:
100
+ - National Suicide Prevention Lifeline (US): 988
101
+ - Crisis Text Line: Text HOME to 741741
102
+ - Find local mental health resources: [NAMI HelpLine](https://www.nami.org/help)
103
+
104
+ ## Contributing
105
+
106
+ Contributions to improve MindMedic are welcome! To contribute:
107
+
108
+ 1. Fork the repository
109
+ 2. Create a feature branch
110
+ 3. Make your changes
111
+ 4. Submit a pull request
112
+
113
+ Please ensure your contributions align with mental health best practices and maintain the focus on providing accurate, helpful information.
114
+
115
+ ---
116
+
117
+ Built with ❀️ for mental health awareness and support. Remember, it's okay to not be okay, and seeking help is a sign of strength.