TheBloke commited on
Commit
2efd1c2
1 Parent(s): 805b23b

Upload README.md

Browse files
Files changed (1) hide show
  1. README.md +406 -0
README.md ADDED
@@ -0,0 +1,406 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ base_model: Open-Orca/Mistral-7B-OpenOrca
3
+ datasets:
4
+ - Open-Orca/OpenOrca
5
+ inference: false
6
+ language:
7
+ - en
8
+ library_name: transformers
9
+ license: apache-2.0
10
+ model_creator: OpenOrca
11
+ model_name: Mistral 7B OpenOrca
12
+ model_type: mistral
13
+ pipeline_tag: text-generation
14
+ prompt_template: '<|im_start|>system
15
+
16
+ {system_message}<|im_end|>
17
+
18
+ <|im_start|>user
19
+
20
+ {prompt}<|im_end|>
21
+
22
+ <|im_start|>assistant
23
+
24
+ '
25
+ quantized_by: TheBloke
26
+ ---
27
+
28
+ <!-- header start -->
29
+ <!-- 200823 -->
30
+ <div style="width: auto; margin-left: auto; margin-right: auto">
31
+ <img src="https://i.imgur.com/EBdldam.jpg" alt="TheBlokeAI" style="width: 100%; min-width: 400px; display: block; margin: auto;">
32
+ </div>
33
+ <div style="display: flex; justify-content: space-between; width: 100%;">
34
+ <div style="display: flex; flex-direction: column; align-items: flex-start;">
35
+ <p style="margin-top: 0.5em; margin-bottom: 0em;"><a href="https://discord.gg/theblokeai">Chat & support: TheBloke's Discord server</a></p>
36
+ </div>
37
+ <div style="display: flex; flex-direction: column; align-items: flex-end;">
38
+ <p style="margin-top: 0.5em; margin-bottom: 0em;"><a href="https://www.patreon.com/TheBlokeAI">Want to contribute? TheBloke's Patreon page</a></p>
39
+ </div>
40
+ </div>
41
+ <div style="text-align:center; margin-top: 0em; margin-bottom: 0em"><p style="margin-top: 0.25em; margin-bottom: 0em;">TheBloke's LLM work is generously supported by a grant from <a href="https://a16z.com">andreessen horowitz (a16z)</a></p></div>
42
+ <hr style="margin-top: 1.0em; margin-bottom: 1.0em;">
43
+ <!-- header end -->
44
+
45
+ # Mistral 7B OpenOrca - AWQ
46
+ - Model creator: [OpenOrca](https://huggingface.co/Open-Orca)
47
+ - Original model: [Mistral 7B OpenOrca](https://huggingface.co/Open-Orca/Mistral-7B-OpenOrca)
48
+
49
+ <!-- description start -->
50
+ ## Description
51
+
52
+ This repo contains AWQ model files for [OpenOrca's Mistral 7B OpenOrca](https://huggingface.co/Open-Orca/Mistral-7B-OpenOrca).
53
+
54
+
55
+ ### About AWQ
56
+
57
+ AWQ is an efficient, accurate and blazing-fast low-bit weight quantization method, currently supporting 4-bit quantization. Compared to GPTQ, it offers faster Transformers-based inference.
58
+
59
+ It is also now supported by continuous batching server [vLLM](https://github.com/vllm-project/vllm), allowing use of Llama AWQ models for high-throughput concurrent inference in multi-user server scenarios.
60
+
61
+ As of September 25th 2023, preliminary Llama-only AWQ support has also been added to [Huggingface Text Generation Inference (TGI)](https://github.com/huggingface/text-generation-inference).
62
+
63
+ Note that, at the time of writing, overall throughput is still lower than running vLLM or TGI with unquantised models, however using AWQ enables using much smaller GPUs which can lead to easier deployment and overall cost savings. For example, a 70B model can be run on 1 x 48GB GPU instead of 2 x 80GB.
64
+ <!-- description end -->
65
+ <!-- repositories-available start -->
66
+ ## Repositories available
67
+
68
+ * [AWQ model(s) for GPU inference.](https://huggingface.co/TheBloke/Mistral-7B-OpenOrca-AWQ)
69
+ * [GPTQ models for GPU inference, with multiple quantisation parameter options.](https://huggingface.co/TheBloke/Mistral-7B-OpenOrca-GPTQ)
70
+ * [2, 3, 4, 5, 6 and 8-bit GGUF models for CPU+GPU inference](https://huggingface.co/TheBloke/Mistral-7B-OpenOrca-GGUF)
71
+ * [OpenOrca's original unquantised fp16 model in pytorch format, for GPU inference and for further conversions](https://huggingface.co/Open-Orca/Mistral-7B-OpenOrca)
72
+ <!-- repositories-available end -->
73
+
74
+ <!-- prompt-template start -->
75
+ ## Prompt template: ChatML
76
+
77
+ ```
78
+ <|im_start|>system
79
+ {system_message}<|im_end|>
80
+ <|im_start|>user
81
+ {prompt}<|im_end|>
82
+ <|im_start|>assistant
83
+
84
+ ```
85
+
86
+ <!-- prompt-template end -->
87
+
88
+
89
+ <!-- README_AWQ.md-provided-files start -->
90
+ ## Provided files, and AWQ parameters
91
+
92
+ For my first release of AWQ models, I am releasing 128g models only. I will consider adding 32g as well if there is interest, and once I have done perplexity and evaluation comparisons, but at this time 32g models are still not fully tested with AutoAWQ and vLLM.
93
+
94
+ Models are released as sharded safetensors files.
95
+
96
+ | Branch | Bits | GS | AWQ Dataset | Seq Len | Size |
97
+ | ------ | ---- | -- | ----------- | ------- | ---- |
98
+ | [main](https://huggingface.co/TheBloke/Mistral-7B-OpenOrca-AWQ/tree/main) | 4 | 128 | [wikitext](https://huggingface.co/datasets/wikitext/viewer/wikitext-2-v1/test) | 32768 | 4.15 GB
99
+
100
+ <!-- README_AWQ.md-provided-files end -->
101
+
102
+ <!-- README_AWQ.md-use-from-vllm start -->
103
+ ## Serving this model from vLLM
104
+
105
+ Documentation on installing and using vLLM [can be found here](https://vllm.readthedocs.io/en/latest/).
106
+
107
+ Note: at the time of writing, vLLM has not yet done a new release with AWQ support.
108
+
109
+ If you try the vLLM examples below and get an error about `quantization` being unrecognised, or other AWQ-related issues, please install vLLM from Github source.
110
+
111
+ - When using vLLM as a server, pass the `--quantization awq` parameter, for example:
112
+
113
+ ```shell
114
+ python3 python -m vllm.entrypoints.api_server --model TheBloke/Mistral-7B-OpenOrca-AWQ --quantization awq --dtype half
115
+ ```
116
+
117
+ When using vLLM from Python code, pass the `quantization=awq` parameter, for example:
118
+
119
+ ```python
120
+ from vllm import LLM, SamplingParams
121
+
122
+ prompts = [
123
+ "Hello, my name is",
124
+ "The president of the United States is",
125
+ "The capital of France is",
126
+ "The future of AI is",
127
+ ]
128
+ sampling_params = SamplingParams(temperature=0.8, top_p=0.95)
129
+
130
+ llm = LLM(model="TheBloke/Mistral-7B-OpenOrca-AWQ", quantization="awq", dtype="half")
131
+
132
+ outputs = llm.generate(prompts, sampling_params)
133
+
134
+ # Print the outputs.
135
+ for output in outputs:
136
+ prompt = output.prompt
137
+ generated_text = output.outputs[0].text
138
+ print(f"Prompt: {prompt!r}, Generated text: {generated_text!r}")
139
+ ```
140
+ <!-- README_AWQ.md-use-from-vllm start -->
141
+
142
+ <!-- README_AWQ.md-use-from-tgi start -->
143
+ ## Serving this model from Text Generation Inference (TGI)
144
+
145
+ Use TGI version 1.1.0 or later. The official Docker container is: `ghcr.io/huggingface/text-generation-inference:1.1.0`
146
+
147
+ Example Docker parameters:
148
+
149
+ ```shell
150
+ --model-id TheBloke/Mistral-7B-OpenOrca-AWQ --port 3000 --quantize awq --max-input-length 3696 --max-total-tokens 4096 --max-batch-prefill-tokens 4096
151
+ ```
152
+
153
+ Example Python code for interfacing with TGI (requires huggingface-hub 0.17.0 or later):
154
+
155
+ ```shell
156
+ pip3 install huggingface-hub
157
+ ```
158
+
159
+ ```python
160
+ from huggingface_hub import InferenceClient
161
+
162
+ endpoint_url = "https://your-endpoint-url-here"
163
+
164
+ prompt = "Tell me about AI"
165
+ prompt_template=f'''<|im_start|>system
166
+ {system_message}<|im_end|>
167
+ <|im_start|>user
168
+ {prompt}<|im_end|>
169
+ <|im_start|>assistant
170
+
171
+ '''
172
+
173
+ client = InferenceClient(endpoint_url)
174
+ response = client.text_generation(prompt,
175
+ max_new_tokens=128,
176
+ do_sample=True,
177
+ temperature=0.7,
178
+ top_p=0.95,
179
+ top_k=40,
180
+ repetition_penalty=1.1)
181
+
182
+ print(f"Model output: {response}")
183
+ ```
184
+ <!-- README_AWQ.md-use-from-tgi end -->
185
+
186
+ <!-- README_AWQ.md-use-from-python start -->
187
+ ## How to use this AWQ model from Python code
188
+
189
+ ### Install the necessary packages
190
+
191
+ Requires: [AutoAWQ](https://github.com/casper-hansen/AutoAWQ) 0.1.1 or later
192
+
193
+ ```shell
194
+ pip3 install autoawq
195
+ ```
196
+
197
+ If you have problems installing [AutoAWQ](https://github.com/casper-hansen/AutoAWQ) using the pre-built wheels, install it from source instead:
198
+
199
+ ```shell
200
+ pip3 uninstall -y autoawq
201
+ git clone https://github.com/casper-hansen/AutoAWQ
202
+ cd AutoAWQ
203
+ pip3 install .
204
+ ```
205
+
206
+ ### You can then try the following example code
207
+
208
+ ```python
209
+ from awq import AutoAWQForCausalLM
210
+ from transformers import AutoTokenizer
211
+
212
+ model_name_or_path = "TheBloke/Mistral-7B-OpenOrca-AWQ"
213
+
214
+ # Load model
215
+ model = AutoAWQForCausalLM.from_quantized(model_name_or_path, fuse_layers=True,
216
+ trust_remote_code=False, safetensors=True)
217
+ tokenizer = AutoTokenizer.from_pretrained(model_name_or_path, trust_remote_code=False)
218
+
219
+ prompt = "Tell me about AI"
220
+ prompt_template=f'''<|im_start|>system
221
+ {system_message}<|im_end|>
222
+ <|im_start|>user
223
+ {prompt}<|im_end|>
224
+ <|im_start|>assistant
225
+
226
+ '''
227
+
228
+ print("\n\n*** Generate:")
229
+
230
+ tokens = tokenizer(
231
+ prompt_template,
232
+ return_tensors='pt'
233
+ ).input_ids.cuda()
234
+
235
+ # Generate output
236
+ generation_output = model.generate(
237
+ tokens,
238
+ do_sample=True,
239
+ temperature=0.7,
240
+ top_p=0.95,
241
+ top_k=40,
242
+ max_new_tokens=512
243
+ )
244
+
245
+ print("Output: ", tokenizer.decode(generation_output[0]))
246
+
247
+ """
248
+ # Inference should be possible with transformers pipeline as well in future
249
+ # But currently this is not yet supported by AutoAWQ (correct as of September 25th 2023)
250
+ from transformers import pipeline
251
+
252
+ print("*** Pipeline:")
253
+ pipe = pipeline(
254
+ "text-generation",
255
+ model=model,
256
+ tokenizer=tokenizer,
257
+ max_new_tokens=512,
258
+ do_sample=True,
259
+ temperature=0.7,
260
+ top_p=0.95,
261
+ top_k=40,
262
+ repetition_penalty=1.1
263
+ )
264
+
265
+ print(pipe(prompt_template)[0]['generated_text'])
266
+ """
267
+ ```
268
+ <!-- README_AWQ.md-use-from-python end -->
269
+
270
+ <!-- README_AWQ.md-compatibility start -->
271
+ ## Compatibility
272
+
273
+ The files provided are tested to work with:
274
+
275
+ - [AutoAWQ](https://github.com/casper-hansen/AutoAWQ)
276
+ - [vLLM](https://github.com/vllm-project/vllm)
277
+ - [Huggingface Text Generation Inference (TGI)](https://github.com/huggingface/text-generation-inference)
278
+
279
+ TGI merged AWQ support on September 25th, 2023: [TGI PR #1054](https://github.com/huggingface/text-generation-inference/pull/1054). Use the `:latest` Docker container until the next TGI release is made.
280
+
281
+ <!-- README_AWQ.md-compatibility end -->
282
+
283
+ <!-- footer start -->
284
+ <!-- 200823 -->
285
+ ## Discord
286
+
287
+ For further support, and discussions on these models and AI in general, join us at:
288
+
289
+ [TheBloke AI's Discord server](https://discord.gg/theblokeai)
290
+
291
+ ## Thanks, and how to contribute
292
+
293
+ Thanks to the [chirper.ai](https://chirper.ai) team!
294
+
295
+ Thanks to Clay from [gpus.llm-utils.org](llm-utils)!
296
+
297
+ I've had a lot of people ask if they can contribute. I enjoy providing models and helping people, and would love to be able to spend even more time doing it, as well as expanding into new projects like fine tuning/training.
298
+
299
+ If you're able and willing to contribute it will be most gratefully received and will help me to keep providing more models, and to start work on new AI projects.
300
+
301
+ Donaters will get priority support on any and all AI/LLM/model questions and requests, access to a private Discord room, plus other benefits.
302
+
303
+ * Patreon: https://patreon.com/TheBlokeAI
304
+ * Ko-Fi: https://ko-fi.com/TheBlokeAI
305
+
306
+ **Special thanks to**: Aemon Algiz.
307
+
308
+ **Patreon special mentions**: Pierre Kircher, Stanislav Ovsiannikov, Michael Levine, Eugene Pentland, Andrey, 준교 김, Randy H, Fred von Graf, Artur Olbinski, Caitlyn Gatomon, terasurfer, Jeff Scroggin, James Bentley, Vadim, Gabriel Puliatti, Harry Royden McLaughlin, Sean Connelly, Dan Guido, Edmond Seymore, Alicia Loh, subjectnull, AzureBlack, Manuel Alberto Morcote, Thomas Belote, Lone Striker, Chris Smitley, Vitor Caleffi, Johann-Peter Hartmann, Clay Pascal, biorpg, Brandon Frisco, sidney chen, transmissions 11, Pedro Madruga, jinyuan sun, Ajan Kanaga, Emad Mostaque, Trenton Dambrowitz, Jonathan Leane, Iucharbius, usrbinkat, vamX, George Stoitzev, Luke Pendergrass, theTransient, Olakabola, Swaroop Kallakuri, Cap'n Zoog, Brandon Phillips, Michael Dempsey, Nikolai Manek, danny, Matthew Berman, Gabriel Tamborski, alfie_i, Raymond Fosdick, Tom X Nguyen, Raven Klaugh, LangChain4j, Magnesian, Illia Dulskyi, David Ziegler, Mano Prime, Luis Javier Navarrete Lozano, Erik Bjäreholt, 阿明, Nathan Dryer, Alex, Rainer Wilmers, zynix, TL, Joseph William Delisle, John Villwock, Nathan LeClaire, Willem Michiel, Joguhyik, GodLy, OG, Alps Aficionado, Jeffrey Morgan, ReadyPlayerEmma, Tiffany J. Kim, Sebastain Graf, Spencer Kim, Michael Davis, webtim, Talal Aujan, knownsqashed, John Detwiler, Imad Khwaja, Deo Leter, Jerry Meng, Elijah Stavena, Rooh Singh, Pieter, SuperWojo, Alexandros Triantafyllidis, Stephen Murray, Ai Maven, ya boyyy, Enrico Ros, Ken Nordquist, Deep Realms, Nicholas, Spiking Neurons AB, Elle, Will Dee, Jack West, RoA, Luke @flexchar, Viktor Bowallius, Derek Yates, Subspace Studios, jjj, Toran Billups, Asp the Wyvern, Fen Risland, Ilya, NimbleBox.ai, Chadd, Nitin Borwankar, Emre, Mandus, Leonard Tan, Kalila, K, Trailburnt, S_X, Cory Kujawski
309
+
310
+
311
+ Thank you to all my generous patrons and donaters!
312
+
313
+ And thank you again to a16z for their generous grant.
314
+
315
+ <!-- footer end -->
316
+
317
+ # Original model card: OpenOrca's Mistral 7B OpenOrca
318
+
319
+
320
+ <p><h1>🐋 TBD 🐋</h1></p>
321
+
322
+
323
+ ![OpenOrca Logo](https://huggingface.co/datasets/Open-Orca/OpenOrca/resolve/main/OpenOrcaLogo.png "OpenOrca Logo")
324
+ [<img src="https://raw.githubusercontent.com/OpenAccess-AI-Collective/axolotl/main/image/axolotl-badge-web.png" alt="Built with Axolotl" width="200" height="32"/>](https://github.com/OpenAccess-AI-Collective/axolotl)
325
+
326
+
327
+ # OpenOrca - Mistral - 7B - 8k
328
+
329
+ We have used our own [OpenOrca dataset](https://huggingface.co/datasets/Open-Orca/OpenOrca) to fine-tune on top of [Mistral 7B](https://huggingface.co/mistralai/Mistral-7B-v0.1).
330
+ This dataset is our attempt to reproduce the dataset generated for Microsoft Research's [Orca Paper](https://arxiv.org/abs/2306.02707).
331
+ We use [OpenChat](https://huggingface.co/openchat) packing, trained with [Axolotl](https://github.com/OpenAccess-AI-Collective/axolotl).
332
+
333
+ This release is trained on a curated filtered subset of most of our GPT-4 augmented data.
334
+ It is the same subset of our data as was used in our [OpenOrcaxOpenChat-Preview2-13B model](https://huggingface.co/Open-Orca/OpenOrcaxOpenChat-Preview2-13B).
335
+
336
+ HF Leaderboard evals place this model as #2 for all models smaller than 30B at release time, outperforming all but one 13B model.
337
+
338
+ TBD
339
+
340
+ Want to visualize our full (pre-filtering) dataset? Check out our [Nomic Atlas Map](https://atlas.nomic.ai/map/c1b88b47-2d9b-47e0-9002-b80766792582/2560fd25-52fe-42f1-a58f-ff5eccc890d2).
341
+
342
+ [<img src="https://huggingface.co/Open-Orca/OpenOrca-Preview1-13B/resolve/main/OpenOrca%20Nomic%20Atlas.png" alt="Atlas Nomic Dataset Map" width="400" height="400" />](https://atlas.nomic.ai/map/c1b88b47-2d9b-47e0-9002-b80766792582/2560fd25-52fe-42f1-a58f-ff5eccc890d2)
343
+
344
+
345
+ We are in-process with training more models, so keep a look out on our org for releases coming soon with exciting partners.
346
+
347
+ We will also give sneak-peak announcements on our Discord, which you can find here:
348
+
349
+ https://AlignmentLab.ai
350
+
351
+ or on the OpenAccess AI Collective Discord for more information about Axolotl trainer here:
352
+
353
+ https://discord.gg/5y8STgB3P3
354
+
355
+ # Prompt Template
356
+
357
+ We used [OpenAI's Chat Markup Language (ChatML)](https://github.com/openai/openai-python/blob/main/chatml.md) format, with `<|im_start|>` and `<|im_end|>` tokens added to support this.
358
+
359
+ ## Example Prompt Exchange
360
+
361
+ TBD
362
+
363
+ # Evaluation
364
+
365
+ We have evaluated using the methodology and tools for the HuggingFace Leaderboard, and find that we have significantly improved upon the base model.
366
+
367
+ TBD
368
+
369
+ ## HuggingFaceH4 Open LLM Leaderboard Performance
370
+
371
+ TBD
372
+
373
+ ## GPT4ALL Leaderboard Performance
374
+
375
+ TBD
376
+
377
+ # Dataset
378
+
379
+ We used a curated, filtered selection of most of the GPT-4 augmented data from our OpenOrca dataset, which aims to reproduce the Orca Research Paper dataset.
380
+
381
+
382
+ # Training
383
+
384
+ We trained with 8x A6000 GPUs for 62 hours, completing 4 epochs of full fine tuning on our dataset in one training run.
385
+ Commodity cost was ~$400.
386
+
387
+ # Citation
388
+
389
+ ```bibtex
390
+ @misc{mukherjee2023orca,
391
+ title={Orca: Progressive Learning from Complex Explanation Traces of GPT-4},
392
+ author={Subhabrata Mukherjee and Arindam Mitra and Ganesh Jawahar and Sahaj Agarwal and Hamid Palangi and Ahmed Awadallah},
393
+ year={2023},
394
+ eprint={2306.02707},
395
+ archivePrefix={arXiv},
396
+ primaryClass={cs.CL}
397
+ }
398
+ @misc{longpre2023flan,
399
+ title={The Flan Collection: Designing Data and Methods for Effective Instruction Tuning},
400
+ author={Shayne Longpre and Le Hou and Tu Vu and Albert Webson and Hyung Won Chung and Yi Tay and Denny Zhou and Quoc V. Le and Barret Zoph and Jason Wei and Adam Roberts},
401
+ year={2023},
402
+ eprint={2301.13688},
403
+ archivePrefix={arXiv},
404
+ primaryClass={cs.AI}
405
+ }
406
+ ```