Update README.md

README.md

@@ -1,12 +1,124 @@
 ---
+base_model: Qwen/Qwen3-1.7B
+model_name: Math Mini 1.7B (Preview)
+tags:
+- text-generation
+- text-generation-inference
+- transformers
+- qwen3
+- math
+- enosis-labs
+- math-mini
+- vllm # Tag for vLLM version
 license: apache-2.0
 language:
 - en
-base_model:
-- Qwen/Qwen3-1.7B
-library_name: adapter-transformers
-tags:
-- qwen
-- math
-- mini
----
+---
+
+# Math Mini 1.7B (Preview)
+
+**Math Mini 1.7B (Preview)** is a larger, more capable model developed by **Enosis Labs** as part of the "Mini Series." Building on the foundation of the 0.6B version, this 1.7B model delivers significantly improved performance, deeper reasoning, and greater accuracy in mathematical tasks. It is fine-tuned from the original `Qwen/Qwen3-1.7B` base model (not from Unsloth's pre-adapted versions).
+
+## Philosophy & Capabilities
+
+The Mini Series, along with the "Enosis Math" and "Enosis Code" models, incorporates step-by-step reasoning by default, enabling more efficient, clear, and well-founded answers. All models in the Math series have been trained with carefully curated step-by-step problem-solving datasets, resulting in a greater ability to reason and explain solutions in a structured way.
+
+**Math Mini 1.7B (Preview)** is optimized for:
+
+* **Basic and Intermediate Algebra:** Solving equations, manipulating expressions, and handling more complex algebraic problems.
+* **Arithmetic & Sequential Reasoning:** Calculations and breaking down problems into logical steps, with improved multi-step reasoning.
+* **Elementary & Intermediate Logic:** Applying deduction in mathematical contexts, now with broader coverage.
+* **Competition Problem Solving (Introductory to Intermediate):** Enhanced foundational and competition-style skills, adapted to the increased model scale.
+
+Larger models in the "Enosis Math" series address even more advanced topics such as calculus, higher algebra, and olympiad problems. The "Code Mini" and "Enosis Code" series are oriented towards programming and algorithmic tasks, maintaining the same philosophy of explicit and efficient reasoning.
+
+This model is a **preview version** and is under continuous improvement and evaluation.
+
+## Quick Start
+
+Available in Hugging Face Transformers format and for high-throughput inference servers like vLLM.
+
+### vLLM (Inference Server)
+
+Install vLLM:
+
+```bash
+pip install vllm
+```
+
+Start the vLLM server with the model (16-bit version):
+
+```bash
+vllm serve "enosislabs/math-mini-1.7b-preview-16bits"
+```
+
+Call the server using curl:
+
+```bash
+curl -X POST "http://localhost:8000/v1/chat/completions" \
+    -H "Content-Type: application/json" \
+    --data '{
+        "model": "enosislabs/math-mini-1.7b-preview-16bits",
+        "messages": [
+            {"role": "user", "content": "What is the capital of France?"}
+        ]
+    }'
+```
+
+### Transformers (Hugging Face)
+
+Use a pipeline as a high-level helper:
+
+```python
+from transformers import pipeline
+
+pipe = pipeline("text-generation", model="enosislabs/math-mini-1.7b-preview-16bits")
+messages = [
+    {"role": "user", "content": "Who are you?"},
+]
+pipe(messages)
+```
+
+## Prompt Format (Qwen3 ChatML)
+
+For best results, use the Qwen3 ChatML format. The `tokenizer.apply_chat_template` method handles this automatically.
+
+```text
+<|im_start|>system
+You are a helpful AI assistant. Provide a detailed step-by-step solution.
+<|im_end|>
+<|im_start|>user
+{user_question}
+<|im_end|>
+<|im_start|>assistant
+```
+
+## Acknowledgements
+
+* Fine-tuned from the original `Qwen/Qwen3-1.7B` base model.
+* Training process accelerated and optimized using [Unsloth](https://github.com/unslothai/unsloth) for efficiency, but not using Unsloth's pre-adapted weights.
+
+## Citation
+
+If you use this model, please cite:
+
+```bibtex
+@software{enosislabs_math_mini_1.7b_preview_2025,
+  author = {{Enosis Labs}},
+  title = {{Math Mini 1.7B (Preview)}},
+  year = {2025},
+  publisher = {Hugging Face},
+  version = {0.1-preview},
+  url = {https://huggingface.co/enosislabs/math-mini-1.7b-preview-16bits}
+}
+```
+
+<!--
+Key points:
+- Now 1.7B, with improved performance and reasoning over 0.6B.
+- Fine-tuned from the original Qwen3-1.7B, not Unsloth's pre-adapted weights.
+- Emphasizes default activation of step-by-step reasoning across the series.
+- Clear and modern examples for vLLM and Transformers.
+- ChatML prompt is central to the experience.
+- Assumes the repo contains the 1.7B model for both vLLM and Transformers.
+-->