kd13 commited on
Commit
794c7d1
·
verified ·
1 Parent(s): 9191277

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +35 -24
README.md CHANGED
@@ -2,7 +2,7 @@
2
  base_model: kd13/Type-o1-mini-instruct
3
  library_name: gguf
4
  pipeline_tag: text-generation
5
- license: apache-2.0
6
  language:
7
  - en
8
  - hi
@@ -10,22 +10,22 @@ tags:
10
  - gguf
11
  - llama.cpp
12
  - quantized
13
- - text-generation
14
  ---
15
 
16
  # Type-o1-mini-instruct - GGUF
17
 
18
- GGUF quantizations of [kd13/Type-o1-mini-instruct](https://huggingface.co/kd13/Type-o1-mini-instruct), a compact
19
- general-purpose instruct model (~1B parameters) for everyday assistant use.
20
 
21
  Converted with [llama.cpp](https://github.com/ggml-org/llama.cpp).
22
-
23
  The IQ quant was produced with an importance matrix; the rest are static quants.
24
 
 
 
 
 
25
  ## Provided quants
26
 
27
- Sorted by size, which is not the same as sorted by quality. IQ-quants are often
28
- preferable to non-IQ quants of a similar size.
29
 
30
  | Link | Type | Size/GB | Notes |
31
  |:-----|:-----|--------:|:------|
@@ -44,33 +44,44 @@ preferable to non-IQ quants of a similar size.
44
 
45
  ## Which one should I pick?
46
 
47
- For a model this small the practical range is **Q4_K_M through Q8_0**. A 1B model has
48
- little redundancy to give up, so the very low-bit quants lose more than they would on a
49
- 7B. `Q2_K` and `Q3_K_S` are included for completeness rather than as recommendations.
 
 
 
 
 
 
 
 
 
 
 
 
50
 
51
  ## Usage
52
 
53
- With llama.cpp:
54
 
55
  ```bash
56
- llama-cli -m Type-o1-mini-instruct.Q4_K_M.gguf -cnv
 
 
57
  ```
58
 
59
- With Ollama:
 
 
60
 
61
  ```bash
62
- ollama run hf.co/kd13/Type-o1-mini-instruct-GGUF:Q4_K_M
63
  ```
64
 
65
- Also works with LM Studio, koboldcpp, text-generation-webui, and anything else built on
66
- llama.cpp. If you are new to GGUF files, the llama.cpp README covers the basics
67
- including how to handle multi-part files.
68
 
69
- ## Notes and limitations
70
 
71
- Everything in the [base model card](https://huggingface.co/kd13/Type-o1-mini-instruct) applies here.
72
- In short: this is an experimental small assistant, best suited to general chat, study
73
- help, writing assistance, summarization, English/Hindi translation, and beginner Python.
74
- It is not suited to production code generation, non-Python languages, or medical, legal
75
- or financial decisions. Quantization does not improve any of that - it makes it slightly
76
- worse in exchange for a smaller file. Verify important outputs and test generated code.
 
2
  base_model: kd13/Type-o1-mini-instruct
3
  library_name: gguf
4
  pipeline_tag: text-generation
5
+ license: mit
6
  language:
7
  - en
8
  - hi
 
10
  - gguf
11
  - llama.cpp
12
  - quantized
 
13
  ---
14
 
15
  # Type-o1-mini-instruct - GGUF
16
 
17
+ GGUF quantizations of [kd13/Type-o1-mini-instruct](https://huggingface.co/kd13/Type-o1-mini-instruct), a compact general-purpose instruct model (~1B parameters) for everyday assistant use.
 
18
 
19
  Converted with [llama.cpp](https://github.com/ggml-org/llama.cpp).
 
20
  The IQ quant was produced with an importance matrix; the rest are static quants.
21
 
22
+ > **Read the Usage section before running these files.** This model uses a custom chat
23
+ > template, so llama.cpp requires the `--jinja` flag. Without it you will get
24
+ > `this custom template is not supported`.
25
+
26
  ## Provided quants
27
 
28
+ Sorted by size, which is not the same as sorted by quality. IQ-quants are often preferable to non-IQ quants of a similar size.
 
29
 
30
  | Link | Type | Size/GB | Notes |
31
  |:-----|:-----|--------:|:------|
 
44
 
45
  ## Which one should I pick?
46
 
47
+ For a model this small the practical range is **Q4_K_M through Q8_0**. A 1B model has little redundancy to give up, so the very low-bit quants lose more than they would on a 7B. `Q2_K` and `Q3_K_S` are included for completeness rather than as recommendations.
48
+
49
+ ## Chat template
50
+
51
+ This model was fine-tuned on a custom template, not the standard Llama 3 header format.
52
+ Each message is wrapped as:
53
+
54
+ '''
55
+ <|begin_of_text|>{role}
56
+ {content}<|end_of_text|>
57
+ '''
58
+
59
+ and generation is prompted with a trailing `<|begin_of_text|>assistant\n`. The full Jinja template is embedded in every GGUF file in this repo, so any runtime with Jinja support applies it automatically.
60
+
61
+ Because this format is not one of llama.cpp's built-in recognised templates, its C++ template matcher will reject it. Passing `--jinja` tells llama.cpp to use the embedded Jinja template instead, which is what you want.
62
 
63
  ## Usage
64
 
65
+ ### llama.cpp
66
 
67
  ```bash
68
+ llama-completion -m Type-o1-mini-instruct.Q4_K_M.gguf --jinja \
69
+ -sys "You are a helpful assistant." \
70
+ -p "Explain photosynthesis in two sentences."
71
  ```
72
 
73
+ Recent llama.cpp builds renamed `llama-cli` to `llama-completion`; on older builds use `llama-cli` with the same flags. For raw text completion with no template applied at all, add `-no-cnv` and drop `--jinja`.
74
+
75
+ Server:
76
 
77
  ```bash
78
+ llama-server -m Type-o1-mini-instruct.Q4_K_M.gguf --jinja -c 4096
79
  ```
80
 
81
+ Omitting `--jinja` produces `this custom template is not supported` — that is a template-matching error, not a corrupt file.
 
 
82
 
83
+ ### Ollama
84
 
85
+ ```bash
86
+ ollama run hf.co/kd13/Type-o1-mini-instruct-GGUF:Q4_K_M
87
+ ```