yangapku commited on
Commit
24c7419
1 Parent(s): befdd36

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +134 -0
README.md ADDED
@@ -0,0 +1,134 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ language:
4
+ - en
5
+ pipeline_tag: text-generation
6
+ tags:
7
+ - chat
8
+ ---
9
+
10
+ # Qwen2-0.5B-Instruct
11
+
12
+ ## Introduction
13
+
14
+ 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 0.5B Qwen2 model.
15
+
16
+ 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.
17
+
18
+ Qwen2-0.5B-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.
19
+
20
+ For more details, please refer to our [blog](https://qwenlm.github.io/blog/qwen2/) and [GitHub](https://github.com/QwenLM/Qwen2).
21
+ <br>
22
+
23
+ ## Model Details
24
+ 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.
25
+
26
+ ## Training details
27
+ We pretrained the models with a large amount of data, and we post-trained the models with both supervised finetuning and direct preference optimization.
28
+
29
+
30
+ ## Requirements
31
+ 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:
32
+ ```
33
+ KeyError: 'qwen2'
34
+ ```
35
+
36
+ ## Quickstart
37
+
38
+ Here provides a code snippet with `apply_chat_template` to show you how to load the tokenizer and model and how to generate contents.
39
+
40
+ ```python
41
+ from transformers import AutoModelForCausalLM, AutoTokenizer
42
+ device = "cuda" # the device to load the model onto
43
+
44
+ model = AutoModelForCausalLM.from_pretrained(
45
+ "Qwen/Qwen2-0.5B-Instruct",
46
+ torch_dtype="auto",
47
+ device_map="auto"
48
+ )
49
+ tokenizer = AutoTokenizer.from_pretrained("Qwen/Qwen2-0.5B-Instruct")
50
+
51
+ prompt = "Give me a short introduction to large language model."
52
+ messages = [
53
+ {"role": "system", "content": "You are a helpful assistant."},
54
+ {"role": "user", "content": prompt}
55
+ ]
56
+ text = tokenizer.apply_chat_template(
57
+ messages,
58
+ tokenize=False,
59
+ add_generation_prompt=True
60
+ )
61
+ model_inputs = tokenizer([text], return_tensors="pt").to(device)
62
+
63
+ generated_ids = model.generate(
64
+ model_inputs.input_ids,
65
+ max_new_tokens=512
66
+ )
67
+ generated_ids = [
68
+ output_ids[len(input_ids):] for input_ids, output_ids in zip(model_inputs.input_ids, generated_ids)
69
+ ]
70
+
71
+ response = tokenizer.batch_decode(generated_ids, skip_special_tokens=True)[0]
72
+ ```
73
+
74
+ ### Processing Long Texts
75
+
76
+ 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.
77
+
78
+ For deployment, we recommend using vLLM. You can enable the long-context capabilities by following these steps:
79
+
80
+ 1. **Install vLLM**: Ensure you have the latest version from the main branch of [vLLM](https://github.com/vllm-project/vllm).
81
+
82
+ 2. **Configure Model Settings**: After downloading the model weights, modify the `config.json` file by including the below snippet:
83
+ ```json
84
+ {
85
+ "architectures": [
86
+ "Qwen2ForCausalLM"
87
+ ],
88
+ // ...
89
+ "vocab_size": 152064,
90
+
91
+ // adding the following snippets
92
+ "rope_scaling": {
93
+ "factor": 4.0,
94
+ "original_max_position_embeddings": 32768,
95
+ "type": "yarn"
96
+ }
97
+ }
98
+ ```
99
+ This snippet enable YARN to support longer contexts.
100
+
101
+ 3. **Model Deployment**: Utilize vLLM to deploy your model. For instance, you can set up an openAI-like server using the command:
102
+
103
+ ```bash
104
+ python -m vllm.entrypoints.openai.api_server --served-model-name Qwen2-0.5B-Instruct --model path/to/weights
105
+ ```
106
+
107
+ Then you can access the Chat API by:
108
+
109
+ ```bash
110
+ curl http://localhost:8000/v1/chat/completions \
111
+ -H "Content-Type: application/json" \
112
+ -d '{
113
+ "model": "Qwen2-0.5B-Instruct",
114
+ "messages": [
115
+ {"role": "system", "content": "You are a helpful assistant."},
116
+ {"role": "user", "content": "Your Long Input Here."}
117
+ ]
118
+ }'
119
+ ```
120
+
121
+ For further usage instructions of vLLM, please refer to our [Github](https://github.com/QwenLM/Qwen2).
122
+
123
+ **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.
124
+
125
+ ## Citation
126
+
127
+ If you find our work helpful, feel free to give us a cite.
128
+
129
+ ```
130
+ @article{qwen2,
131
+ title={Qwen2 Technical Report},
132
+ year={2024}
133
+ }
134
+ ```