buzzcraft commited on
Commit
d1ac8d8
β€’
1 Parent(s): 2050462

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +147 -0
README.md ADDED
@@ -0,0 +1,147 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ base_model: bineric/NorskGPT-Llama3-8b
3
+ tags:
4
+ - llama
5
+ - NorskGPT
6
+ - instruct
7
+ - finetune
8
+ language:
9
+ - no
10
+
11
+ license: cc-by-nc-sa-4.0
12
+ ---
13
+ # NorskGPT-Llama-3-8b-v0.1
14
+
15
+ This model is a Norwegian variant of
16
+ Meta-Llama-3-8B, fine-tuned on a carefully selected mix of Norwegian instruction pairs. The model is tuned to understand and generate text in Norwegain.
17
+
18
+
19
+ ## Intended Use
20
+
21
+ This model is free to use for personal and research use. However a commercial license is required for commerical applications.
22
+ This model can be used as an assistant-like chat. Try it out :)
23
+
24
+
25
+ ## Prompt Template
26
+
27
+ ```
28
+ <|im_start|>system
29
+ Du er NorskGPT ....<|im_end|>
30
+ <|im_start|>user
31
+ Hei<|im_end|>
32
+ <|im_start|>assistant
33
+ Hei, hva kan jeg hjelpe deg med?<|im_end|>
34
+ ```
35
+ <!-- description start -->
36
+ ## Description
37
+
38
+ This repo contains GGUF format model files for [NorskGPT-Llama3-8b](https://huggingface.co/bineric/NorskGPT-Llama3-8b).
39
+
40
+ ## License
41
+ [Attribution-NonCommercial-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-nc-sa/4.0/)
42
+
43
+
44
+ This model is free to use for personal and research use. However a commercial license is required for commerical applications.
45
+
46
+ You are free to:
47
+
48
+ Share β€” copy and redistribute the material in any medium or format
49
+ Adapt β€” remix, transform, and build upon the material
50
+ The licensor cannot revoke these freedoms as long as you follow the license terms.
51
+
52
+ Under the following terms:
53
+
54
+ Attribution β€” You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
55
+ NonCommercial β€” You may not use the material for commercial purposes .
56
+ ShareAlike β€” If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
57
+ No additional restrictions β€” You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
58
+
59
+
60
+ <!-- description end -->
61
+ <!-- README_GGUF.md-about-gguf start -->
62
+ ### About GGUF
63
+
64
+ Here is an incomplete list of clients and libraries that are known to support GGUF:
65
+
66
+ * [llama.cpp](https://github.com/ggerganov/llama.cpp). The source project for GGUF. Offers a CLI and a server option.
67
+ * [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.
68
+ * [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.
69
+ * [GPT4All](https://gpt4all.io/index.html), a free and open source local running GUI, supporting Windows, Linux and macOS with full GPU accel.
70
+ * [LM Studio](https://lmstudio.ai/), an easy-to-use and powerful local GUI for Windows and macOS (Silicon), with GPU acceleration. Linux available, in beta as of 27/11/2023.
71
+ * [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.
72
+ * [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.
73
+ * [llama-cpp-python](https://github.com/abetlen/llama-cpp-python), a Python library with GPU accel, LangChain support, and OpenAI-compatible API server.
74
+ * [candle](https://github.com/huggingface/candle), a Rust ML framework with a focus on performance, including GPU support, and ease of use.
75
+ * [ctransformers](https://github.com/marella/ctransformers), a Python library with GPU accel, LangChain support, and OpenAI-compatible AI server. Note, as of time of writing (November 27th 2023), ctransformers has not been updated in a long time and does not support many recent models.
76
+
77
+ <!-- README_GGUF.md-about-gguf end -->
78
+
79
+ ## Prompt template: ChatML
80
+
81
+ ```
82
+ <|im_start|>system
83
+ {system_message}<|im_end|>
84
+ <|im_start|>user
85
+ {prompt}<|im_end|>
86
+ <|im_start|>assistant
87
+
88
+ ```
89
+
90
+ <!-- prompt-template end -->
91
+
92
+
93
+
94
+
95
+ ## Explanation of quantisation methods
96
+
97
+ <details>
98
+ <summary>Click to see details</summary>
99
+
100
+ The new methods available are:
101
+
102
+ * GGML_TYPE_Q2_K - "type-1" 2-bit quantization in super-blocks containing 16 blocks, each block having 16 weight. Block scales and mins are quantized with 4 bits. This ends up effectively using 2.5625 bits per weight (bpw)
103
+ * GGML_TYPE_Q3_K - "type-0" 3-bit quantization in super-blocks containing 16 blocks, each block having 16 weights. Scales are quantized with 6 bits. This end up using 3.4375 bpw.
104
+ * GGML_TYPE_Q4_K - "type-1" 4-bit quantization in super-blocks containing 8 blocks, each block having 32 weights. Scales and mins are quantized with 6 bits. This ends up using 4.5 bpw.
105
+ * GGML_TYPE_Q5_K - "type-1" 5-bit quantization. Same super-block structure as GGML_TYPE_Q4_K resulting in 5.5 bpw
106
+ * GGML_TYPE_Q6_K - "type-0" 6-bit quantization. Super-blocks with 16 blocks, each block having 16 weights. Scales are quantized with 8 bits. This ends up using 6.5625 bpw
107
+
108
+ Refer to the Provided Files table below to see what files use which methods, and how.
109
+ </details>
110
+ <!-- compatibility_gguf end -->
111
+
112
+ <!-- README_GGUF.md-provided-files start -->
113
+ ## Provided files
114
+
115
+ | Name | Quant method | Bits | Size | Max RAM required | Use case |
116
+ | ---- | ---- | ---- | ---- | ---- | ----- |
117
+ | NorskGPT-Llama3-8b.Q2_K.gguf | Q2_K | 2 | 2.72 GB| 5.22 GB | significant quality loss - not recommended for most purposes |
118
+ | NorskGPT-Llama3-8b.Q3_K_S.gguf | Q3_K_S | 3 | 3.16 GB| 5.66 GB | very small, high quality loss |
119
+ | NorskGPT-Llama3-8b.Q3_K_M.gguf| Q3_K_M | 3 | 3.52 GB| 6.02 GB | very small, high quality loss |
120
+ | NorskGPT-Llama3-8b.Q3_K_L.gguf | Q3_K_L | 3 | 3.82 GB| 6.32 GB | small, substantial quality loss |
121
+ | NorskGPT-Llama3-8b.Q4_0.gguf| Q4_0 | 4 | 4.11 GB| 6.61 GB | legacy; small, very high quality loss - prefer using Q3_K_M |
122
+ | NorskGPT-Llama3-8b.Q4_K_S.gguf | Q4_K_S | 4 | 4.14 GB| 6.64 GB | small, greater quality loss |
123
+ | NorskGPT-Llama3-8b.Q4_K_M.gguf | Q4_K_M | 4 | 4.37 GB| 6.87 GB | medium, balanced quality - recommended |
124
+ | NorskGPT-Llama3-8b.Q5_0.gguf | Q5_0 | 5 | 5.00 GB| 7.50 GB | legacy; medium, balanced quality - prefer using Q4_K_M |
125
+ | NorskGPT-Llama3-8b.Q5_K_S.gguf | Q5_K_S | 5 | 5.00 GB| 7.50 GB | large, low quality loss - recommended |
126
+ | NorskGPT-Llama3-8b.Q5_K_M.gguf | Q5_K_M | 5 | 5.13 GB| 7.63 GB | large, very low quality loss - recommended |
127
+ | NorskGPT-Llama3-8b.Q6_K.gguf| Q6_K | 6 | 5.94 GB| 8.44 GB | very large, extremely low quality loss |
128
+ | NorskGPT-Llama3-8b.Q8_0.gguf | Q8_0 | 8 | 7.70 GB| 10.20 GB | very large, extremely low quality loss - not recommended |
129
+
130
+ **Note**: the above RAM figures assume no GPU offloading. If layers are offloaded to the GPU, this will reduce RAM usage and use VRAM instead.
131
+
132
+
133
+
134
+ <!-- README_GGUF.md-provided-files end -->
135
+
136
+ <!-- README_GGUF.md-how-to-download start -->
137
+ ## How to download GGUF files
138
+
139
+ **Note for manual downloaders:** You almost never want to clone the entire repo! Multiple different quantisation formats are provided, and most users only want to pick and download a single file.
140
+
141
+ The following clients/libraries will automatically download models for you, providing a list of available models to choose from:
142
+
143
+ * LM Studio
144
+ * LoLLMS Web UI
145
+ * Faraday.dev
146
+
147
+ Thanks to [TheBloke](https://huggingface.co/TheBloke) for preparing an amazing README on how to use GGUF models