ZappY-AI commited on
Commit
c4b3258
1 Parent(s): 1facb07

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +132 -115
README.md CHANGED
@@ -1,201 +1,218 @@
1
  ---
2
- library_name: transformers
3
- tags: []
 
 
 
 
 
 
 
 
4
  ---
5
-
6
- # Model Card for Model ID
7
-
8
- <!-- Provide a quick summary of what the model is/does. -->
9
-
10
-
11
-
12
- ## Model Details
13
 
14
  ### Model Description
15
 
16
- <!-- Provide a longer summary of what this model is. -->
 
 
 
 
 
 
17
 
18
- This is the model card of a 🤗 transformers model that has been pushed on the Hub. This model card has been automatically generated.
19
 
20
- - **Developed by:** [More Information Needed]
21
- - **Funded by [optional]:** [More Information Needed]
22
- - **Shared by [optional]:** [More Information Needed]
23
- - **Model type:** [More Information Needed]
24
- - **Language(s) (NLP):** [More Information Needed]
25
- - **License:** [More Information Needed]
26
- - **Finetuned from model [optional]:** [More Information Needed]
27
 
28
- ### Model Sources [optional]
 
 
 
 
29
 
30
- <!-- Provide the basic links for the model. -->
31
 
32
- - **Repository:** [More Information Needed]
33
- - **Paper [optional]:** [More Information Needed]
34
- - **Demo [optional]:** [More Information Needed]
35
-
36
- ## Uses
37
-
38
- <!-- Address questions around how the model is intended to be used, including the foreseeable users of the model and those affected by the model. -->
39
-
40
- ### Direct Use
41
 
42
- <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
 
 
 
43
 
44
- [More Information Needed]
45
 
46
- ### Downstream Use [optional]
47
 
48
- <!-- This section is for the model use when fine-tuned for a task, or when plugged into a larger ecosystem/app -->
49
 
50
- [More Information Needed]
51
 
52
- ### Out-of-Scope Use
53
 
54
- <!-- This section addresses misuse, malicious use, and uses that the model will not work well for. -->
 
 
55
 
56
- [More Information Needed]
57
-
58
- ## Bias, Risks, and Limitations
59
-
60
- <!-- This section is meant to convey both technical and sociotechnical limitations. -->
61
-
62
- [More Information Needed]
63
-
64
- ### Recommendations
65
-
66
- <!-- This section is meant to convey recommendations with respect to the bias, risk, and technical limitations. -->
67
 
68
- Users (both direct and downstream) should be made aware of the risks, biases and limitations of the model. More information needed for further recommendations.
69
 
70
- ## How to Get Started with the Model
 
 
71
 
72
- Use the code below to get started with the model.
73
 
74
- [More Information Needed]
75
 
76
- ## Training Details
77
 
78
- ### Training Data
79
 
80
- <!-- This should link to a Dataset Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
81
 
82
- [More Information Needed]
 
 
83
 
84
- ### Training Procedure
85
 
86
- <!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
87
 
88
- #### Preprocessing [optional]
89
 
90
- [More Information Needed]
91
 
 
92
 
93
- #### Training Hyperparameters
94
 
95
- - **Training regime:** [More Information Needed] <!--fp32, fp16 mixed precision, bf16 mixed precision, bf16 non-mixed precision, fp16 non-mixed precision, fp8 mixed precision -->
96
 
97
- #### Speeds, Sizes, Times [optional]
98
 
99
- <!-- This section provides information about throughput, start/end time, checkpoint size if relevant, etc. -->
100
 
101
- [More Information Needed]
102
 
103
- ## Evaluation
104
 
105
- <!-- This section describes the evaluation protocols and provides the results. -->
106
 
107
- ### Testing Data, Factors & Metrics
108
 
109
- #### Testing Data
110
 
111
- <!-- This should link to a Dataset Card if possible. -->
112
 
113
- [More Information Needed]
114
 
115
- #### Factors
116
 
117
- <!-- These are the things the evaluation is disaggregating by, e.g., subpopulations or domains. -->
118
 
119
- [More Information Needed]
120
 
121
- #### Metrics
122
 
123
- <!-- These are the evaluation metrics being used, ideally with a description of why. -->
124
 
125
- [More Information Needed]
126
 
127
- ### Results
128
 
129
- [More Information Needed]
 
 
130
 
131
- #### Summary
132
 
 
133
 
 
134
 
135
- ## Model Examination [optional]
136
 
137
- <!-- Relevant interpretability work for the model goes here -->
138
 
139
- [More Information Needed]
140
 
141
- ## Environmental Impact
142
 
143
- <!-- Total emissions (in grams of CO2eq) and additional considerations, such as electricity usage, go here. Edit the suggested text below accordingly -->
144
 
145
- Carbon emissions can be estimated using the [Machine Learning Impact calculator](https://mlco2.github.io/impact#compute) presented in [Lacoste et al. (2019)](https://arxiv.org/abs/1910.09700).
146
 
147
- - **Hardware Type:** [More Information Needed]
148
- - **Hours used:** [More Information Needed]
149
- - **Cloud Provider:** [More Information Needed]
150
- - **Compute Region:** [More Information Needed]
151
- - **Carbon Emitted:** [More Information Needed]
152
 
153
- ## Technical Specifications [optional]
154
 
155
- ### Model Architecture and Objective
156
 
157
- [More Information Needed]
 
158
 
159
- ### Compute Infrastructure
160
 
161
- [More Information Needed]
162
 
163
- #### Hardware
 
 
164
 
165
- [More Information Needed]
166
 
167
- #### Software
168
 
169
- [More Information Needed]
170
 
171
- ## Citation [optional]
172
 
173
- <!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
174
 
175
- **BibTeX:**
176
 
177
- [More Information Needed]
178
 
179
- **APA:**
180
 
181
- [More Information Needed]
 
182
 
183
- ## Glossary [optional]
184
 
185
- <!-- If relevant, include terms and calculations in this section that can help readers understand the model or model card. -->
186
 
187
- [More Information Needed]
188
 
189
- ## More Information [optional]
190
 
191
- [More Information Needed]
192
 
193
- ## Model Card Authors [optional]
194
 
195
- [More Information Needed]
 
196
 
197
- ## Model Card Contact
198
 
199
- [More Information Needed]
200
 
 
201
 
 
 
 
1
  ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ pipeline_tag: text-generation
6
+ tags:
7
+ - pytorch
8
+ - mistral
9
+ - Gen-AI
10
+ - health-QnA
11
+ - medical
12
  ---
13
+ # MASHQA-Mistral-7B-Instruct
 
 
 
 
 
 
 
14
 
15
  ### Model Description
16
 
17
+ MASHQA-Mistral-7B-Instruct is a large language model fine-tuned on healthcare question-answer pairs to respond safely to the users' queries. It is based on the Mistral-7B Instruct Architecture.
18
+ - Model creator: [Garima Sohi](https://huggingface.co/sohi-g/MASHQA-Mistral-7B-Instruct)
19
+ - Original model: [Mistral-7B-Instruct](https://huggingface.co/mistralai/Mistral-7B-Instruct-v0.1)
20
+
21
+ ### Dataset Description
22
+ - Data Source: [MASHQA (Multiple Answer Spans Healthcare Question Answering) Data](https://drive.google.com/file/d/1ism3N3kMapliaORZQaQU8obNycF8rH9p/view)
23
+ - Data Description: Multiple question-answer pairs in JSON format.
24
 
 
25
 
26
+ ## Prompt template
 
 
 
 
 
 
27
 
28
+ ```
29
+ [INST]Act as a Multiple Answer Spans Healthcare Question Answering helpful assistant and answer the user's questions in details with reasoning. Do not give any false information. In case you don't have answer, specify why the question can't be answered.
30
+
31
+ ### Question:
32
+ {question}
33
 
34
+ ### Answer:
35
 
36
+ ```
37
+
38
+ ## Basics
39
+ *This section provides information about the model type, version, license, funders, release date, developers, and contact information.*
40
+ *It is useful for anyone who wants to reference the model.*
 
 
 
 
41
 
42
+
43
+ **Developed by:** [Garima Sohi](https://huggingface.co/sohi-g)
44
+
45
+ **Model Type:** Transformer-based Large Language Model
46
 
47
+ **Version:** 1.0.0
48
 
49
+ **Languages:** English
50
 
51
+ **License:** Apache 2.0
52
 
53
+ **Send Questions to:** garimasohi007@gmail.com
54
 
 
55
 
56
+ ## Technical Specifications
57
+ *This section includes details about the model objective and architecture, and the compute infrastructure.*
58
+ *It is useful for people interested in model development.*
59
 
60
+ ### Model Architecture and Objective
 
 
 
 
 
 
 
 
 
 
61
 
62
+ * Modified from Mistral-7B-Instruct
63
 
64
+ **Objective:** Safely respond to users' health-related queries.
65
+
66
+ ### Hardware and Software - Compute Infrastructure
67
 
68
+ * 4 NVIDIA L4 GPUs & 48 vCPUs
69
 
70
+ * Environment: PyTorch (pytorch-2.0 w/ CUDA-11.8; see [Github link](https://github.com/pytorch/pytorch))
71
 
72
+ * CPU: GCP G2 Standard 48 (Platform: Intel Cascade Lake) (Accelerator Optimized)
73
 
74
+ * CPU memory: 192GB RAM
75
 
76
+ * GPU memory: 30GB per GPU
77
 
78
+ ## Training
79
+ *This section provides information about the training.*
80
+ *It is useful for people who want to learn more about the model inputs and training footprint.*
81
 
82
+ The following bits and bytes quantization config was used during training:
83
 
84
+ * quant_method: bitsandbytes
85
+ * load_in_8bit: False
86
+ * load_in_4bit: True
87
+ * llm_int8_threshold: 6.0
88
+ * llm_int8_skip_modules: None
89
+ * llm_int8_enable_fp32_cpu_offload: False
90
+ * llm_int8_has_fp16_weight: False
91
+ * bnb_4bit_quant_type: nf4
92
+ * bnb_4bit_use_double_quant: True
93
+ * bnb_4bit_compute_dtype: float16
94
+
95
+ Framework versions
96
+ * PEFT 0.4.0
97
+
98
+
99
+ ## How to use
100
 
101
+ This model can be easily used and deployed using HuggingFace's ecosystem. This needs `transformers` and `accelerate` installed. The model can be downloaded as follows:
102
 
103
+ [MASHQA-Mistral-7B-Instruct](https://huggingface.co/sohi-g/MASHQA-Mistral-7B-Instruct)
104
 
105
+ ## Intended Use
106
 
107
+ This model is being created in order to enable public research on large language models (LLMs). LLMs are intended to be used for language generation or as a pre-trained base model that can be further fine-tuned for specific tasks. The use cases below are not exhaustive.
108
 
109
+ ### Direct Use
110
 
111
+ - Text generation
112
 
113
+ - Exploring characteristics of language generated by a language model
114
 
115
+ - Examples: Cloze tests, counterfactuals, generations with reframings
116
 
117
+ ### Downstream Use
118
 
119
+ - Tasks that leverage language models include: Information Extraction, Question Answering, Summarization
120
 
 
121
 
122
+ #### Out-of-scope Uses
123
 
124
+ Using the model in [high-stakes](#high-stakes) settings is out of scope for this model. The model is not designed for [critical decisions](#critical-decisions) nor uses with any material consequences on an individual's livelihood or wellbeing. The model outputs content that appears factual but may not be correct.
125
 
126
+ Out-of-scope Uses Include:
127
 
128
+ - Usage for evaluating or scoring individuals, such as for employment, education, or credit
129
 
130
+ - Applying the model for critical automatic decisions, generating factual content, creating reliable summaries, or generating predictions that must be correct
131
 
132
+ #### Misuse
133
 
134
+ Intentionally using the model for harm, violating [human rights](#human-rights), or other kinds of malicious activities, is a misuse of this model. This includes:
135
 
136
+ - Spam generation
137
 
138
+ - Disinformation and influence operations
139
 
140
+ - Disparagement and defamation
141
 
142
+ - Harassment and abuse
143
+
144
+ - [Deception](#deception)
145
 
146
+ - Unconsented impersonation and imitation
147
 
148
+ - Unconsented surveillance
149
 
150
+ - Generating content without attribution to the model, as specified in the [RAIL License, Use Restrictions](https://huggingface.co/spaces/bigscience/license)
151
 
152
+ ## Intended Users
153
 
154
+ ### Direct Users
155
 
156
+ - General Public
157
 
158
+ - Researchers
159
 
160
+ - Students
161
 
162
+ - Educators
163
 
164
+ - Engineers/developers
 
 
 
 
165
 
166
+ - Non-commercial entities
167
 
168
+ - Health Industry
169
 
170
+ # Risks and Limitations
171
+ *This section identifies foreseeable harms and misunderstandings.*
172
 
173
+ Model may:
174
 
175
+ - Overrepresent some viewpoints and underrepresent others
176
 
177
+ - Contain stereotypes
178
+
179
+ - Contain [personal information](#personal-data-and-information)
180
 
181
+ - Generate:
182
 
183
+ - Hateful, abusive, or violent language
184
 
185
+ - Discriminatory or prejudicial language
186
 
187
+ - Content that may not be appropriate for all settings, including sexual content
188
 
189
+ - Make errors, including producing incorrect information as if it were factual
190
 
191
+ - Generate irrelevant or repetitive outputs
192
 
193
+ - Induce users into attributing human traits to it, such as sentience or consciousness
194
 
 
195
 
196
+ # Evaluation
197
+ *This section describes the evaluation protocols and provides the results.*
198
 
 
199
 
200
+ **Train-time Evaluation:**
201
 
202
+ Final checkpoint after 500 epochs:
203
 
204
+ - Training Loss: 1.216
205
 
 
206
 
 
207
 
208
+ # Recommendations
209
+ *This section provides information on warnings and potential mitigations.*
210
 
211
+ - Indirect users should be made aware when the content they're working with is created by the LLM.
212
 
213
+ - Users should be aware of [Risks and Limitations](#risks-and-limitations), and include an appropriate age disclaimer or blocking interface as necessary.
214
 
215
+ - Users of the model should provide mechanisms for those affected to provide feedback, such as an email address for comments.
216
 
217
+ # Model Card Authors
218
+ Garima Sohi