TheBloke commited on
Commit
be346d7
1 Parent(s): 872b861

Upload README.md

Browse files
Files changed (1) hide show
  1. README.md +34 -30
README.md CHANGED
@@ -1,4 +1,5 @@
1
  ---
 
2
  inference: false
3
  language:
4
  - zh
@@ -12,7 +13,6 @@ language:
12
  library_name: transformers
13
  license: llama2
14
  model_creator: OpenBuddy
15
- model_link: https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16
16
  model_name: OpenBuddy Llama2 70b v10.1
17
  model_type: llama
18
  pipeline_tag: text-generation
@@ -40,26 +40,28 @@ quantized_by: TheBloke
40
  - Model creator: [OpenBuddy](https://huggingface.co/OpenBuddy)
41
  - Original model: [OpenBuddy Llama2 70b v10.1](https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16)
42
 
 
43
  ## Description
44
 
45
  This repo contains GGUF format model files for [OpenBuddy's OpenBuddy Llama2 70b v10.1](https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16).
46
 
 
47
  <!-- README_GGUF.md-about-gguf start -->
48
  ### About GGUF
49
 
50
- GGUF is a new format introduced by the llama.cpp team on August 21st 2023. It is a replacement for GGML, which is no longer supported by llama.cpp.
51
 
52
- The key benefit of GGUF is that it is a extensible, future-proof format which stores more information about the model as metadata. It also includes significantly improved tokenization code, including for the first time full support for special tokens. This should improve performance, especially with models that use new special tokens and implement custom prompt templates.
53
 
54
- Here are a list of clients and libraries that are known to support GGUF:
55
- * [llama.cpp](https://github.com/ggerganov/llama.cpp).
56
- * [text-generation-webui](https://github.com/oobabooga/text-generation-webui), the most widely used web UI. Supports GGUF with GPU acceleration via the ctransformers backend - llama-cpp-python backend should work soon too.
57
- * [KoboldCpp](https://github.com/LostRuins/koboldcpp), now supports GGUF as of release 1.41! A powerful GGML web UI, with full GPU accel. Especially good for story telling.
58
- * [LM Studio](https://lmstudio.ai/), version 0.2.2 and later support GGUF. A fully featured local GUI with GPU acceleration on both Windows (NVidia and AMD), and macOS.
59
- * [LoLLMS Web UI](https://github.com/ParisNeo/lollms-webui), should now work, choose the `c_transformers` backend. A great web UI with many interesting features. Supports CUDA GPU acceleration.
60
- * [ctransformers](https://github.com/marella/ctransformers), now supports GGUF as of version 0.2.24! A Python library with GPU accel, LangChain support, and OpenAI-compatible AI server.
61
- * [llama-cpp-python](https://github.com/abetlen/llama-cpp-python), supports GGUF as of version 0.1.79. A Python library with GPU accel, LangChain support, and OpenAI-compatible API server.
62
- * [candle](https://github.com/huggingface/candle), added GGUF support on August 22nd. Candle is a Rust ML framework with a focus on performance, including GPU support, and ease of use.
63
 
64
  <!-- README_GGUF.md-about-gguf end -->
65
  <!-- repositories-available start -->
@@ -71,23 +73,30 @@ Here are a list of clients and libraries that are known to support GGUF:
71
  <!-- repositories-available end -->
72
 
73
  <!-- prompt-template start -->
74
- ## Prompt template: Vicuna-Short
75
 
76
  ```
77
- You are a helpful AI assistant.
 
 
 
 
 
78
 
79
- USER: {prompt}
80
- ASSISTANT:
81
 
82
  ```
83
 
84
  <!-- prompt-template end -->
 
 
85
  <!-- compatibility_gguf start -->
86
  ## Compatibility
87
 
88
- These quantised GGUF files are compatible with llama.cpp from August 21st 2023 onwards, as of commit [6381d4e110bd0ec02843a60bbeb8b6fc37a9ace9](https://github.com/ggerganov/llama.cpp/commit/6381d4e110bd0ec02843a60bbeb8b6fc37a9ace9)
89
 
90
- They are now also compatible with many third party UIs and libraries - please see the list at the top of the README.
91
 
92
  ## Explanation of quantisation methods
93
  <details>
@@ -109,14 +118,10 @@ Refer to the Provided Files table below to see what files use which methods, and
109
 
110
  | Name | Quant method | Bits | Size | Max RAM required | Use case |
111
  | ---- | ---- | ---- | ---- | ---- | ----- |
112
- | [openbuddy-llama2-70b-v10.1.Q6_K.gguf-split-b](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q6_K.gguf-split-b) | Q6_K | 6 | 19.96 GB| 22.46 GB | very large, extremely low quality loss |
113
  | [openbuddy-llama2-70b-v10.1.Q2_K.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q2_K.gguf) | Q2_K | 2 | 29.33 GB| 31.83 GB | smallest, significant quality loss - not recommended for most purposes |
114
  | [openbuddy-llama2-70b-v10.1.Q3_K_S.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_S.gguf) | Q3_K_S | 3 | 29.98 GB| 32.48 GB | very small, high quality loss |
115
  | [openbuddy-llama2-70b-v10.1.Q3_K_M.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_M.gguf) | Q3_K_M | 3 | 33.24 GB| 35.74 GB | very small, high quality loss |
116
  | [openbuddy-llama2-70b-v10.1.Q3_K_L.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_L.gguf) | Q3_K_L | 3 | 36.21 GB| 38.71 GB | small, substantial quality loss |
117
- | [openbuddy-llama2-70b-v10.1.Q8_0.gguf-split-b](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q8_0.gguf-split-b) | Q8_0 | 8 | 36.69 GB| 39.19 GB | very large, extremely low quality loss - not recommended |
118
- | [openbuddy-llama2-70b-v10.1.Q6_K.gguf-split-a](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q6_K.gguf-split-a) | Q6_K | 6 | 36.70 GB| 39.20 GB | very large, extremely low quality loss |
119
- | [openbuddy-llama2-70b-v10.1.Q8_0.gguf-split-a](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q8_0.gguf-split-a) | Q8_0 | 8 | 36.70 GB| 39.20 GB | very large, extremely low quality loss - not recommended |
120
  | [openbuddy-llama2-70b-v10.1.Q4_0.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_0.gguf) | Q4_0 | 4 | 38.94 GB| 41.44 GB | legacy; small, very high quality loss - prefer using Q3_K_M |
121
  | [openbuddy-llama2-70b-v10.1.Q4_K_S.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_K_S.gguf) | Q4_K_S | 4 | 39.14 GB| 41.64 GB | small, greater quality loss |
122
  | [openbuddy-llama2-70b-v10.1.Q4_K_M.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_K_M.gguf) | Q4_K_M | 4 | 41.49 GB| 43.99 GB | medium, balanced quality - recommended |
@@ -167,18 +172,15 @@ del openbuddy-llama2-70b-v10.1.Q8_0.gguf-split-a openbuddy-llama2-70b-v10.1.Q8_0
167
  <!-- README_GGUF.md-how-to-run start -->
168
  ## Example `llama.cpp` command
169
 
170
- Make sure you are using `llama.cpp` from commit [6381d4e110bd0ec02843a60bbeb8b6fc37a9ace9](https://github.com/ggerganov/llama.cpp/commit/6381d4e110bd0ec02843a60bbeb8b6fc37a9ace9) or later.
171
-
172
- For compatibility with older versions of llama.cpp, or for any third-party libraries or clients that haven't yet updated for GGUF, please use GGML files instead.
173
 
 
 
174
  ```
175
- ./main -t 10 -ngl 32 -m openbuddy-llama2-70b-v10.1.q4_K_M.gguf --color -c 4096 --temp 0.7 --repeat_penalty 1.1 -n -1 -p "You are a helpful AI assistant.\n\nUSER: Write a story about llamas\nASSISTANT:"
176
- ```
177
- Change `-t 10` to the number of physical CPU cores you have. For example if your system has 8 cores/16 threads, use `-t 8`. If offloading all layers to GPU, set `-t 1`.
178
 
179
  Change `-ngl 32` to the number of layers to offload to GPU. Remove it if you don't have GPU acceleration.
180
 
181
- Change `-c 4096` to the desired sequence length for this model. For extended sequence models - eg 8K, 16K, 32K - the necessary RoPE scaling parameters are read from the GGUF file and set by llama.cpp automatically.
182
 
183
  If you want to have a chat-style conversation, replace the `-p <PROMPT>` argument with `-i -ins`
184
 
@@ -235,10 +237,12 @@ For further support, and discussions on these models and AI in general, join us
235
 
236
  [TheBloke AI's Discord server](https://discord.gg/theblokeai)
237
 
238
- ## Thanks, and how to contribute.
239
 
240
  Thanks to the [chirper.ai](https://chirper.ai) team!
241
 
 
 
242
  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.
243
 
244
  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.
 
1
  ---
2
+ base_model: https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16
3
  inference: false
4
  language:
5
  - zh
 
13
  library_name: transformers
14
  license: llama2
15
  model_creator: OpenBuddy
 
16
  model_name: OpenBuddy Llama2 70b v10.1
17
  model_type: llama
18
  pipeline_tag: text-generation
 
40
  - Model creator: [OpenBuddy](https://huggingface.co/OpenBuddy)
41
  - Original model: [OpenBuddy Llama2 70b v10.1](https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16)
42
 
43
+ <!-- description start -->
44
  ## Description
45
 
46
  This repo contains GGUF format model files for [OpenBuddy's OpenBuddy Llama2 70b v10.1](https://huggingface.co/OpenBuddy/openbuddy-llama2-70b-v10.1-bf16).
47
 
48
+ <!-- description end -->
49
  <!-- README_GGUF.md-about-gguf start -->
50
  ### About GGUF
51
 
52
+ GGUF is a new format introduced by the llama.cpp team on August 21st 2023. It is a replacement for GGML, which is no longer supported by llama.cpp. GGUF offers numerous advantages over GGML, such as better tokenisation, and support for special tokens. It is also supports metadata, and is designed to be extensible.
53
 
54
+ Here is an incomplate list of clients and libraries that are known to support GGUF:
55
 
56
+ * [llama.cpp](https://github.com/ggerganov/llama.cpp). The source project for GGUF. Offers a CLI and a server option.
57
+ * [text-generation-webui](https://github.com/oobabooga/text-generation-webui), the most widely used web UI, with many features and powerful extensions. Supports GPU acceleration.
58
+ * [KoboldCpp](https://github.com/LostRuins/koboldcpp), a fully featured web UI, with GPU accel across all platforms and GPU architectures. Especially good for story telling.
59
+ * [LM Studio](https://lmstudio.ai/), an easy-to-use and powerful local GUI for Windows and macOS (Silicon), with GPU acceleration.
60
+ * [LoLLMS Web UI](https://github.com/ParisNeo/lollms-webui), a great web UI with many interesting and unique features, including a full model library for easy model selection.
61
+ * [Faraday.dev](https://faraday.dev/), an attractive and easy to use character-based chat GUI for Windows and macOS (both Silicon and Intel), with GPU acceleration.
62
+ * [ctransformers](https://github.com/marella/ctransformers), a Python library with GPU accel, LangChain support, and OpenAI-compatible AI server.
63
+ * [llama-cpp-python](https://github.com/abetlen/llama-cpp-python), a Python library with GPU accel, LangChain support, and OpenAI-compatible API server.
64
+ * [candle](https://github.com/huggingface/candle), a Rust ML framework with a focus on performance, including GPU support, and ease of use.
65
 
66
  <!-- README_GGUF.md-about-gguf end -->
67
  <!-- repositories-available start -->
 
73
  <!-- repositories-available end -->
74
 
75
  <!-- prompt-template start -->
76
+ ## Prompt template: OpenBuddy
77
 
78
  ```
79
+ You are a helpful, respectful and honest INTP-T AI Assistant named Buddy. You are talking to a human User.
80
+ Always answer as helpfully and logically as possible, while being safe. Your answers should not include any harmful, political, religious, unethical, racist, sexist, toxic, dangerous, or illegal content. Please ensure that your responses are socially unbiased and positive in nature.
81
+ If a question does not make any sense, or is not factually coherent, explain why instead of answering something not correct. If you don't know the answer to a question, please don't share false information.
82
+ You like to use emojis. You can speak fluently in many languages, for example: English, Chinese.
83
+ You cannot access the internet, but you have vast knowledge, cutoff: 2021-09.
84
+ You are trained by OpenBuddy team, (https://openbuddy.ai, https://github.com/OpenBuddy/OpenBuddy), you are based on LLaMA and Falcon transformers model, not related to GPT or OpenAI.
85
 
86
+ User: {prompt}
87
+ Assistant:
88
 
89
  ```
90
 
91
  <!-- prompt-template end -->
92
+
93
+
94
  <!-- compatibility_gguf start -->
95
  ## Compatibility
96
 
97
+ These quantised GGUFv2 files are compatible with llama.cpp from August 27th onwards, as of commit [d0cee0d36d5be95a0d9088b674dbb27354107221](https://github.com/ggerganov/llama.cpp/commit/d0cee0d36d5be95a0d9088b674dbb27354107221)
98
 
99
+ They are also compatible with many third party UIs and libraries - please see the list at the top of this README.
100
 
101
  ## Explanation of quantisation methods
102
  <details>
 
118
 
119
  | Name | Quant method | Bits | Size | Max RAM required | Use case |
120
  | ---- | ---- | ---- | ---- | ---- | ----- |
 
121
  | [openbuddy-llama2-70b-v10.1.Q2_K.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q2_K.gguf) | Q2_K | 2 | 29.33 GB| 31.83 GB | smallest, significant quality loss - not recommended for most purposes |
122
  | [openbuddy-llama2-70b-v10.1.Q3_K_S.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_S.gguf) | Q3_K_S | 3 | 29.98 GB| 32.48 GB | very small, high quality loss |
123
  | [openbuddy-llama2-70b-v10.1.Q3_K_M.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_M.gguf) | Q3_K_M | 3 | 33.24 GB| 35.74 GB | very small, high quality loss |
124
  | [openbuddy-llama2-70b-v10.1.Q3_K_L.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q3_K_L.gguf) | Q3_K_L | 3 | 36.21 GB| 38.71 GB | small, substantial quality loss |
 
 
 
125
  | [openbuddy-llama2-70b-v10.1.Q4_0.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_0.gguf) | Q4_0 | 4 | 38.94 GB| 41.44 GB | legacy; small, very high quality loss - prefer using Q3_K_M |
126
  | [openbuddy-llama2-70b-v10.1.Q4_K_S.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_K_S.gguf) | Q4_K_S | 4 | 39.14 GB| 41.64 GB | small, greater quality loss |
127
  | [openbuddy-llama2-70b-v10.1.Q4_K_M.gguf](https://huggingface.co/TheBloke/OpenBuddy-Llama2-70b-v10.1-GGUF/blob/main/openbuddy-llama2-70b-v10.1.Q4_K_M.gguf) | Q4_K_M | 4 | 41.49 GB| 43.99 GB | medium, balanced quality - recommended |
 
172
  <!-- README_GGUF.md-how-to-run start -->
173
  ## Example `llama.cpp` command
174
 
175
+ Make sure you are using `llama.cpp` from commit [d0cee0d36d5be95a0d9088b674dbb27354107221](https://github.com/ggerganov/llama.cpp/commit/d0cee0d36d5be95a0d9088b674dbb27354107221) or later.
 
 
176
 
177
+ ```shell
178
+ ./main -ngl 32 -m openbuddy-llama2-70b-v10.1.q4_K_M.gguf --color -c 4096 --temp 0.7 --repeat_penalty 1.1 -n -1 -p "You are a helpful, respectful and honest INTP-T AI Assistant named Buddy. You are talking to a human User.\nAlways answer as helpfully and logically as possible, while being safe. Your answers should not include any harmful, political, religious, unethical, racist, sexist, toxic, dangerous, or illegal content. Please ensure that your responses are socially unbiased and positive in nature.\nIf a question does not make any sense, or is not factually coherent, explain why instead of answering something not correct. If you don't know the answer to a question, please don't share false information.\nYou like to use emojis. You can speak fluently in many languages, for example: English, Chinese.\nYou cannot access the internet, but you have vast knowledge, cutoff: 2021-09.\nYou are trained by OpenBuddy team, (https://openbuddy.ai, https://github.com/OpenBuddy/OpenBuddy), you are based on LLaMA and Falcon transformers model, not related to GPT or OpenAI.\n\nUser: {prompt}\nAssistant:"
179
  ```
 
 
 
180
 
181
  Change `-ngl 32` to the number of layers to offload to GPU. Remove it if you don't have GPU acceleration.
182
 
183
+ Change `-c 4096` to the desired sequence length. For extended sequence models - eg 8K, 16K, 32K - the necessary RoPE scaling parameters are read from the GGUF file and set by llama.cpp automatically.
184
 
185
  If you want to have a chat-style conversation, replace the `-p <PROMPT>` argument with `-i -ins`
186
 
 
237
 
238
  [TheBloke AI's Discord server](https://discord.gg/theblokeai)
239
 
240
+ ## Thanks, and how to contribute
241
 
242
  Thanks to the [chirper.ai](https://chirper.ai) team!
243
 
244
+ Thanks to Clay from [gpus.llm-utils.org](llm-utils)!
245
+
246
  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.
247
 
248
  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.