NANI-Nithin commited on
Commit
656bd58
·
verified ·
1 Parent(s): 43c4cad

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +96 -4
README.md CHANGED
@@ -1,18 +1,110 @@
1
  ---
2
- base_model: inclusionAI/Ling-3.0-tiny
3
  language:
4
  - en
 
 
5
  tags:
6
  - gguf
 
7
  - quantized
8
  - moe
9
  - bailingmoev3
10
- - ling
 
 
 
11
  ---
12
 
13
- # Ling-3.0-tiny GGUF
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
14
 
15
- Community GGUF conversion of [inclusionAI/Ling-3.0-tiny](https://huggingface.co/inclusionAI/Ling-3.0-tiny).
16
 
17
  ## Reproducibility
18
 
 
1
  ---
 
2
  language:
3
  - en
4
+ license: apache-2.0
5
+ base_model: inclusionAI/Ling-3.0-tiny
6
  tags:
7
  - gguf
8
+ - llama.cpp
9
  - quantized
10
  - moe
11
  - bailingmoev3
12
+ - hybrid-model
13
+ - local-llm
14
+ - text-generation
15
+ pipeline_tag: text-generation
16
  ---
17
 
18
+ # Ling-3.0-tiny-GGUF
19
+
20
+ GGUF quantizations of [inclusionAI/Ling-3.0-tiny](https://huggingface.co/inclusionAI/Ling-3.0-tiny), converted for use with compatible `llama.cpp`-based runtimes.
21
+
22
+ This repository includes a complete selection of standard K-quants and importance-matrix (IQ) quantizations, so you can choose the best balance of model size, speed, and output quality for your hardware.
23
+
24
+ > **Runtime compatibility:** Ling-3.0-tiny uses the BailingMoeV3 / hybrid architecture. Use a runtime with explicit support for this architecture. Generic or older `llama.cpp` builds may not load these files correctly.
25
+
26
+ ## Available files
27
+
28
+ | Quantization | Best for |
29
+ |---|---|
30
+ | `F16` | Highest-fidelity baseline; re-quantization and high-memory systems |
31
+ | `Q8_0` | Near-F16 quality with substantially lower memory use |
32
+ | `Q6_K` | High-quality local inference |
33
+ | `Q5_K_M` | Strong quality-to-size balance |
34
+ | `Q5_K_S` | Slightly smaller alternative to Q5_K_M |
35
+ | `Q5_0` | Legacy-style 5-bit option |
36
+ | `Q4_K_M` | Recommended default for most users |
37
+ | `Q4_K_S` | Smaller Q4 K-quant alternative |
38
+ | `Q4_0` | Compact legacy-style 4-bit option |
39
+ | `IQ4_NL` | High-quality importance-matrix 4-bit option |
40
+ | `IQ4_XS` | Compact importance-matrix 4-bit option |
41
+ | `Q3_K_L` | Higher-quality 3-bit K-quant |
42
+ | `Q3_K_M` | Balanced 3-bit K-quant |
43
+ | `Q3_K_S` | Smaller 3-bit K-quant |
44
+ | `IQ3_M` | Strong quality-per-GB option for constrained systems |
45
+ | `IQ3_S` | Smaller 3-bit IQ option |
46
+ | `IQ3_XS` | Very compact IQ 3-bit option |
47
+ | `IQ3_XXS` | Extremely compact IQ 3-bit option |
48
+ | `Q2_K` | Low-memory K-quant option |
49
+ | `IQ2_M` | Compact IQ quant with better quality potential than very-low-bit options |
50
+ | `IQ2_S` | Low-memory IQ option |
51
+ | `IQ2_XS` | Very small IQ option |
52
+ | `IQ2_XXS` | Extremely small IQ option |
53
+ | `IQ1_M` | Experimental ultra-low-memory option |
54
+ | `IQ1_S` | Smallest experimental option |
55
+
56
+ ## Recommended downloads
57
+
58
+ | Your priority | Recommended file |
59
+ |---|---|
60
+ | Best quality | `Ling-3.0-tiny-F16.gguf` |
61
+ | Near-original quality | `Ling-3.0-tiny-Q8_0.gguf` |
62
+ | High quality with lower memory use | `Ling-3.0-tiny-Q6_K.gguf` |
63
+ | Best general-purpose choice | `Ling-3.0-tiny-Q4_K_M.gguf` |
64
+ | Small but capable | `Ling-3.0-tiny-IQ3_M.gguf` |
65
+ | Tight VRAM / RAM budget | `Ling-3.0-tiny-IQ2_M.gguf` |
66
+ | Experimental minimum size | `Ling-3.0-tiny-IQ1_S.gguf` |
67
+
68
+ For most users, start with **Q4_K_M**. If you have more RAM or VRAM, try **Q5_K_M**, **Q6_K**, or **Q8_0**. IQ quants can offer attractive quality-to-size trade-offs, but results and compatibility may vary by runtime and hardware.
69
+
70
+ ## Usage
71
+
72
+ Download one `.gguf` file, then run it with a compatible build of `llama.cpp`.
73
+
74
+ ```bash
75
+ llama-cli \
76
+ -m Ling-3.0-tiny-Q4_K_M.gguf \
77
+ -ngl 99 \
78
+ -c 4096 \
79
+ -p "Write a concise explanation of retrieval-augmented generation."
80
+ ```
81
+
82
+ `-ngl 99` attempts to offload all supported layers to the GPU. Remove it or set `-ngl 0` for CPU-only inference.
83
+
84
+ ## Important notes
85
+
86
+ - These files are quantized derivatives of the original model; output quality changes depending on the chosen quantization.
87
+ - Very low-bit quants, especially IQ1 and IQ2 variants, are intended for memory-constrained or experimental use and may noticeably reduce output quality.
88
+ - Use the original model’s license, terms, and usage requirements.
89
+ - Validate the selected quantization on your own workload before production use.
90
+
91
+ ## Conversion details
92
+
93
+ - Base model: [`inclusionAI/Ling-3.0-tiny`](https://huggingface.co/inclusionAI/Ling-3.0-tiny)
94
+ - Format: GGUF
95
+ - Conversion/runtime branch: BailingMoeV3-compatible `llama.cpp` fork
96
+ - Standard K-quants: generated from the F16 GGUF
97
+ - IQ quants: generated using an importance matrix calibrated on a text corpus
98
+
99
+ ## Credits
100
+
101
+ - Original model by [inclusionAI](https://huggingface.co/inclusionAI)
102
+ - GGUF conversion and quantization by [NANI-Nithin](https://huggingface.co/NANI-Nithin)
103
+ - GGUF tooling by the [llama.cpp](https://github.com/ggml-org/llama.cpp) community
104
+
105
+ ## Disclaimer
106
 
107
+ This is a community GGUF conversion and is not an official release by inclusionAI. Please report conversion, loading, or compatibility issues in this repository’s Discussions section.
108
 
109
  ## Reproducibility
110