daniloreddy commited on
Commit
e826d05
·
verified ·
1 Parent(s): 1f8a2d3

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +39 -25
README.md CHANGED
@@ -6,42 +6,56 @@ tags:
6
  - gguf
7
  - quantized
8
  - text-generation
9
- - qwen
10
- - instruct
11
- - chat
 
 
12
  ---
13
 
14
- # Qwen3.5-9B GGUF - High-Quality Quantizations
15
 
16
- This repository provides **GGUF** quantized versions of the [Qwen/Qwen3.5-9B](https://huggingface.co/Qwen/Qwen3.5-9B) model, optimized for local execution using `llama.cpp`.
17
 
18
- > [!IMPORTANT]
19
- > **NOT A BASE MODEL:** These files are based on the standard **Qwen3.5-9B** release, which is the **Instruction Tuned (Chat)** version. It is specifically designed to follow instructions, engage in dialogue, and act as a conversational assistant.
 
 
20
 
21
- ## Available Quantization Formats
22
 
23
  | File | Method | Bit | Description |
24
  | :--- | :--- | :--- | :--- |
25
- | **Q4_K_M.gguf** | Q4_K_M | 4-bit | **Recommended.** Best balance between speed and intelligence. |
26
- | **Q5_K_M.gguf** | Q5_K_M | 5-bit | High precision. Best for logical reasoning and structured output. |
27
- | **Q5_K_S.gguf** | Q5_K_S | 5-bit | High precision, slightly more efficient than Q5_K_M. |
28
- | **Q4_K_S.gguf** | Q4_K_S | 4-bit | Fast/Light. Optimized for maximum performance on CPU. |
29
- | **Q8_0.gguf** | Q8_0 | 8-bit | Near-lossless. Maximum fidelity to the original weights. |
30
- | **mmproj-f16.gguf** | F16 | 16-bit | **Vision Projector.** Required for image/video tasks. Keep in F16 for best accuracy. |
31
 
32
- ## Quantization Details
33
- All models were quantized locally using the latest version of `llama.cpp`. K-Quants were used to ensure the best trade-off between perplexity and resource consumption on CPU-based systems.
 
 
34
 
35
- - **Quantization Date:** March 8, 2026
36
- - **Tooling:** `llama-quantize` (llama.cpp)
37
- - **Source Precision:** FP16 (Official weights)
38
 
39
- ## Usage Instructions
 
 
 
 
 
 
 
 
40
 
41
- ### 1. Multimodal Support (Vision/Image Analysis)
42
- To allow the model to "see" images, you need to load the Vision Projector (`mmproj`). This component translates visual data into a format the LLM can process.
 
 
43
 
44
- ### 2. Running with llama-server (Recommended for GUI/API)
45
- To launch a local server with vision support:
46
  ```bash
47
- ./llama-server -m Qwen3.5-9B_Q4_K_M.gguf --mmproj mmproj-model-f16.gguf -n 512
 
 
6
  - gguf
7
  - quantized
8
  - text-generation
9
+ - lightweight
10
+ - lmstudio
11
+ - jan
12
+ - cobalt
13
+ - text-generation-webui
14
  ---
15
 
16
+ # Qwen3.5-9B - GGUF High-Quality Quantizations
17
 
18
+ This repository provides **GGUF** quantized versions of the [Qwen/Qwen3.5-9B](https://huggingface.co/Qwen/Qwen3.5-9B) model, optimized for local execution using `llama.cpp` and compatible ecosystems.
19
 
20
+ ## 📌 Version Notes
21
+ All quantizations were generated from the official **FP16** weights.
22
+ - **Target:** Efficient execution on consumer hardware, mobile/edge devices, and systems with limited memory.
23
+ - **Performance:** The output quality (reasoning, coherence, and accuracy) is strictly dependent on the base model's parameter scale (9B).
24
 
25
+ ## 📊 Quantization Table
26
 
27
  | File | Method | Bit | Description |
28
  | :--- | :--- | :--- | :--- |
29
+ | **fp16.gguf** | FP16 | 16-bit | **Original Weights.** No quantization applied. Maximum fidelity. |
30
+ | **Q8_0.gguf** | Q8_0 | 8-bit | **Near-lossless.** Practically identical to the original model with lower memory footprint. |
31
+ | **Q5_K_M.gguf** | Q5_K_M | 5-bit | **High Precision.** Minimizes quantization error for critical tasks. |
32
+ | **Q4_K_M.gguf** | Q4_K_M | 4-bit | **Recommended.** Best balance between speed and performance. |
33
+ | **Q4_K_S.gguf** | Q4_K_S | 4-bit | **Fast/Small.** Optimized for maximum throughput and low RAM usage. |
 
34
 
35
+ ## 🛠️ Technical Details
36
+ - **Quantization Date:** 2026-03-07
37
+ - **Tool used:** `llama-quantize` (llama.cpp)
38
+ - **Method:** K-Quantization (optimized for AVX2/AVX-512 and modern GPU architectures).
39
 
40
+ ## 🚀 How to Use
41
+ # Start a local OpenAI-compatible server with a web UI:
 
42
 
43
+ ### llama.cpp (CLI) using model from HuggingFace
44
+ ```bash
45
+ ./llama-cli -hf daniloreddy/Qwen3.5-9B_GGUF:Q4_K_M -p "User: Hello! Assistant:" -n 512 --temp 0.7
46
+ ```
47
+
48
+ ### llama.cpp (CLI) using downloaded model
49
+ ```bash
50
+ ./llama-cli -m path/to/Qwen3.5-9B_Q4_K_M.gguf -p "User: Hello! Assistant:" -n 512 --temp 0.7
51
+ ```
52
 
53
+ ### llama.cpp (SERVER) using model from HuggingFace
54
+ ```bash
55
+ ./llama-server -hf daniloreddy/Qwen3.5-9B_GGUF:Q4_K_M --port 8080 -c 4096
56
+ ```
57
 
58
+ ### llama.cpp (SERVER) using downloaded model
 
59
  ```bash
60
+ ./llama-server -m /path/to/Qwen3.5-9B_Q4_K_M.gguf --port 8080 -c 4096
61
+ ```