spow12 commited on
Commit
a956670
1 Parent(s): 062997f

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +161 -1
README.md CHANGED
@@ -89,4 +89,164 @@ conversation[-1]
89
 
90
  ### License
91
 
92
- This model is licensed under the cc-by-nc-4.0. which allows others to share and adapt the model for non-commercial purposes.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
89
 
90
  ### License
91
 
92
+ This model is licensed under the cc-by-nc-4.0. which allows others to share and adapt the model for non-commercial purposes.
93
+
94
+
95
+ # Here is Original Readme.md
96
+
97
+ # Qwen2-7B-Instruct
98
+
99
+ ## Introduction
100
+
101
+ Qwen2 is the new series of Qwen large language models. For Qwen2, we release a number of base language models and instruction-tuned language models ranging from 0.5 to 72 billion parameters, including a Mixture-of-Experts model. This repo contains the instruction-tuned 7B Qwen2 model.
102
+
103
+ Compared with the state-of-the-art opensource language models, including the previous released Qwen1.5, Qwen2 has generally surpassed most opensource models and demonstrated competitiveness against proprietary models across a series of benchmarks targeting for language understanding, language generation, multilingual capability, coding, mathematics, reasoning, etc.
104
+
105
+ Qwen2-7B-Instruct supports a context length of up to 131,072 tokens, enabling the processing of extensive inputs. Please refer to [this section](#processing-long-texts) for detailed instructions on how to deploy Qwen2 for handling long texts.
106
+
107
+ For more details, please refer to our [blog](https://qwenlm.github.io/blog/qwen2/), [GitHub](https://github.com/QwenLM/Qwen2), and [Documentation](https://qwen.readthedocs.io/en/latest/).
108
+ <br>
109
+
110
+ ## Model Details
111
+ Qwen2 is a language model series including decoder language models of different model sizes. For each size, we release the base language model and the aligned chat model. It is based on the Transformer architecture with SwiGLU activation, attention QKV bias, group query attention, etc. Additionally, we have an improved tokenizer adaptive to multiple natural languages and codes.
112
+
113
+ ## Training details
114
+ We pretrained the models with a large amount of data, and we post-trained the models with both supervised finetuning and direct preference optimization.
115
+
116
+
117
+ ## Requirements
118
+ The code of Qwen2 has been in the latest Hugging face transformers and we advise you to install `transformers>=4.37.0`, or you might encounter the following error:
119
+ ```
120
+ KeyError: 'qwen2'
121
+ ```
122
+
123
+ ## Quickstart
124
+
125
+ Here provides a code snippet with `apply_chat_template` to show you how to load the tokenizer and model and how to generate contents.
126
+
127
+ ```python
128
+ from transformers import AutoModelForCausalLM, AutoTokenizer
129
+ device = "cuda" # the device to load the model onto
130
+
131
+ model = AutoModelForCausalLM.from_pretrained(
132
+ "Qwen/Qwen2-7B-Instruct",
133
+ torch_dtype="auto",
134
+ device_map="auto"
135
+ )
136
+ tokenizer = AutoTokenizer.from_pretrained("Qwen/Qwen2-7B-Instruct")
137
+
138
+ prompt = "Give me a short introduction to large language model."
139
+ messages = [
140
+ {"role": "system", "content": "You are a helpful assistant."},
141
+ {"role": "user", "content": prompt}
142
+ ]
143
+ text = tokenizer.apply_chat_template(
144
+ messages,
145
+ tokenize=False,
146
+ add_generation_prompt=True
147
+ )
148
+ model_inputs = tokenizer([text], return_tensors="pt").to(device)
149
+
150
+ generated_ids = model.generate(
151
+ model_inputs.input_ids,
152
+ max_new_tokens=512
153
+ )
154
+ generated_ids = [
155
+ output_ids[len(input_ids):] for input_ids, output_ids in zip(model_inputs.input_ids, generated_ids)
156
+ ]
157
+
158
+ response = tokenizer.batch_decode(generated_ids, skip_special_tokens=True)[0]
159
+ ```
160
+
161
+ ### Processing Long Texts
162
+
163
+ To handle extensive inputs exceeding 32,768 tokens, we utilize [YARN](https://arxiv.org/abs/2309.00071), a technique for enhancing model length extrapolation, ensuring optimal performance on lengthy texts.
164
+
165
+ For deployment, we recommend using vLLM. You can enable the long-context capabilities by following these steps:
166
+
167
+ 1. **Install vLLM**: You can install vLLM by running the following command.
168
+
169
+ ```bash
170
+ pip install "vllm>=0.4.3"
171
+ ```
172
+
173
+ Or you can install vLLM from [source](https://github.com/vllm-project/vllm/).
174
+
175
+ 2. **Configure Model Settings**: After downloading the model weights, modify the `config.json` file by including the below snippet:
176
+ ```json
177
+ {
178
+ "architectures": [
179
+ "Qwen2ForCausalLM"
180
+ ],
181
+ // ...
182
+ "vocab_size": 152064,
183
+
184
+ // adding the following snippets
185
+ "rope_scaling": {
186
+ "factor": 4.0,
187
+ "original_max_position_embeddings": 32768,
188
+ "type": "yarn"
189
+ }
190
+ }
191
+ ```
192
+ This snippet enable YARN to support longer contexts.
193
+
194
+ 3. **Model Deployment**: Utilize vLLM to deploy your model. For instance, you can set up an openAI-like server using the command:
195
+
196
+ ```bash
197
+ python -m vllm.entrypoints.openai.api_server --served-model-name Qwen2-7B-Instruct --model path/to/weights
198
+ ```
199
+
200
+ Then you can access the Chat API by:
201
+
202
+ ```bash
203
+ curl http://localhost:8000/v1/chat/completions \
204
+ -H "Content-Type: application/json" \
205
+ -d '{
206
+ "model": "Qwen2-7B-Instruct",
207
+ "messages": [
208
+ {"role": "system", "content": "You are a helpful assistant."},
209
+ {"role": "user", "content": "Your Long Input Here."}
210
+ ]
211
+ }'
212
+ ```
213
+
214
+ For further usage instructions of vLLM, please refer to our [Github](https://github.com/QwenLM/Qwen2).
215
+
216
+ **Note**: Presently, vLLM only supports static YARN, which means the scaling factor remains constant regardless of input length, **potentially impacting performance on shorter texts**. We advise adding the `rope_scaling` configuration only when processing long contexts is required.
217
+
218
+ ## Evaluation
219
+
220
+ We briefly compare Qwen2-7B-Instruct with similar-sized instruction-tuned LLMs, including Qwen1.5-7B-Chat. The results are shown below:
221
+
222
+ | Datasets | Llama-3-8B-Instruct | Yi-1.5-9B-Chat | GLM-4-9B-Chat | Qwen1.5-7B-Chat | Qwen2-7B-Instruct |
223
+ | :--- | :---: | :---: | :---: | :---: | :---: |
224
+ | _**English**_ | | | | | |
225
+ | MMLU | 68.4 | 69.5 | **72.4** | 59.5 | 70.5 |
226
+ | MMLU-Pro | 41.0 | - | - | 29.1 | **44.1** |
227
+ | GPQA | **34.2** | - | **-** | 27.8 | 25.3 |
228
+ | TheroemQA | 23.0 | - | - | 14.1 | **25.3** |
229
+ | MT-Bench | 8.05 | 8.20 | 8.35 | 7.60 | **8.41** |
230
+ | _**Coding**_ | | | | | |
231
+ | Humaneval | 62.2 | 66.5 | 71.8 | 46.3 | **79.9** |
232
+ | MBPP | **67.9** | - | - | 48.9 | 67.2 |
233
+ | MultiPL-E | 48.5 | - | - | 27.2 | **59.1** |
234
+ | Evalplus | 60.9 | - | - | 44.8 | **70.3** |
235
+ | LiveCodeBench | 17.3 | - | - | 6.0 | **26.6** |
236
+ | _**Mathematics**_ | | | | | |
237
+ | GSM8K | 79.6 | **84.8** | 79.6 | 60.3 | 82.3 |
238
+ | MATH | 30.0 | 47.7 | **50.6** | 23.2 | 49.6 |
239
+ | _**Chinese**_ | | | | | |
240
+ | C-Eval | 45.9 | - | 75.6 | 67.3 | **77.2** |
241
+ | AlignBench | 6.20 | 6.90 | 7.01 | 6.20 | **7.21** |
242
+
243
+ ## Citation
244
+
245
+ If you find our work helpful, feel free to give us a cite.
246
+
247
+ ```
248
+ @article{qwen2,
249
+ title={Qwen2 Technical Report},
250
+ year={2024}
251
+ }
252
+ ```