Update README.md

README.md

@@ -12,19 +12,43 @@ base_model:
 pipeline_tag: image-text-to-text
 ---
 
-# Qwen3.8-max-Reasoning-Distilled-GGUF : GGUF
-
-This model was finetuned and converted to GGUF format using [Unsloth](https://github.com/unslothai/unsloth).
-
-**Example usage**:
-- For text only LLMs:    `llama-cli -hf khazarai/Qwen3.8-max-Reasoning-Distilled-GGUF --jinja`
-- For multimodal models: `llama-mtmd-cli -hf khazarai/Qwen3.8-max-Reasoning-Distilled-GGUF --jinja`
-
-## Available Model files:
-- `Qwen3.5-0.8B.BF16.gguf`
-- `Qwen3.5-0.8B.Q8_0.gguf`
-- `Qwen3.5-0.8B.Q6_K.gguf`
-- `Qwen3.5-0.8B.Q4_K_M.gguf`
-- `Qwen3.5-0.8B.F16-mmproj.gguf`
-This was trained 2x faster with [Unsloth](https://github.com/unslothai/unsloth)
-[<img src="https://raw.githubusercontent.com/unslothai/unsloth/main/images/unsloth%20made%20with%20love.png" width="200"/>](https://github.com/unslothai/unsloth)
+# Qwen3.8-max-Reasoning-Distilled
+
+**Qwen3.8-max-Reasoning-Distilled** is a compact, high-efficiency language model fine-tuned using Knowledge Distillation from Qwen3.8-max.
+
+It specifically addresses the common issue of overthinking loops and repetitive hesitations found in smaller raw reasoning models. By learning directly from high-quality reasoning traces, this model delivers concise, structured, and decisive Chain-of-Thought (CoT) outputs without wasting tokens on circular verification.
+
+## Key Features
+
+ - Streamlined Chain-of-Thought (CoT): Replaces verbose, rambling reasoning paths with direct, step-by-step logic.
+
+ - Elimination of Overthinking: Suppresses repetitive inner monologue loops (e.g., "Wait, let me re-verify...") that consume unnecessary tokens.
+
+ - Higher Inference Efficiency: Drastically reduces total generated token count while maintaining or improving final answer accuracy.
+
+ - Distilled Logic from Qwen3.8-max: Captures the complex evaluation heuristics of the teacher model into a smaller, faster student architecture.
+
+## Reasoning Quality Comparison
+
+Below is a comparison highlighting how distillation improves reasoning structure and eliminates repetitive loops:
+
+| **Feature** | **Qwen3.5-0.8B** | **Qwen3.8-max-Reasoning-Distilled** |
+|---|---|---|
+| **Logic Flow** | Frequent self-doubt, circular checks, hesitation | Linear, structured, and hypothesis-driven |
+| **Token Economy** | High token overhead spent on repetitive verification | Low token overhead with concise step evaluation |
+| **Option Analysis** | Reiterates choices multiple times without deciding | Evaluates each option once with clear justification |
+| **Decision Speed** | Slow convergence to final answer | Fast, decisive output generation |
+
+## Example Trace
+
+**Task**: Identify the beneficial effect of carpooling from multiple choice options.
+
+ - **Qwen3.5-0.8B**: "Evaluate option D... wait, let me check option E... actually, let me re-evaluate D... wait, is there a trick? Let me double-check..." (Overthinking Loop)
+ - **Qwen3.8-max-Reasoning-Distilled**: "Systematically evaluates choices A through H in a single pass $\rightarrow$ identifies option D as the primary environmental benefit $\rightarrow$ concludes decisively." (Clean & Direct)
+
+## Limitations
+
+While the model minimizes overthinking, extremely complex multi-step mathematical problems may still require prompting for explicit scratchpad steps.
+Always verify outputs when using the model for domain-critical tasks (e.g., medical, legal, or financial decisions).
+
+