Update README.md

README.md

@@ -1,58 +1,71 @@
-smollm_finetuning5 – Fine-Tuned SmolLM2 Model
+---
+library_name: transformers
+pipeline_tag: text-generation
+base_model: SmolAI/SmolLM2-1.7B
+license: apache-2.0
+language:
+  - en
+tags:
+  - smolllm2
+  - finetuned
+  - reasoning
+  - concise
+model_type: causal-lm
+---
 
-smollm_finetuning5 is a fine-tuned variant of the SmolLM2-1.7B model.
-The aim of this work was to adapt the base model using a lightweight instruction-tuning approach to improve coherence, reasoning, and general instruction-following on short prompts.
+# smollm_finetuning5 — Fine-Tuned SmolLM2-1.7B for Concise Instruction Reasoning
 
-The model is provided as a merged .safetensors checkpoint, meaning the LoRA adapters were fused into the base weights after training for easier deployment.
+*smollm_finetuning5* is a fine-tuned version of *SmolAI/SmolLM2-1.7B*, trained on synthetic instruction–response samples and concise reasoning data. The model is optimized to produce short, structured, and clear answers while improving general instruction-following behavior.
 
-Dataset Used
+The goal of this fine-tuning was to enhance reasoning clarity and response consistency in a compact 1.7B parameter model.
 
-The model was trained on the argilla/synthetic-concise-reasoning-sft-filtered dataset.
-This dataset includes:
+---
 
-instruction–response pairs
+## Features
 
-short reasoning sequences
+- Fine-tuned for concise and structured responses
+- Improved instruction-following capabilities
+- Handles short reasoning and explanation tasks
+- Lightweight and efficient (1.7B parameters)
+- Suitable for general-purpose educational and reasoning uses
 
-synthetic tasks designed to promote clear step-by-step thinking
+---
 
-concise explanations and simplified reasoning samples
+## Intended Use
 
-The dataset is filtered to remove excessively long or noisy examples, making it suitable for fine-tuning compact models that benefit from clean and simplified instructions.
+### Recommended
+- General question–answer interactions  
+- Explanation of simple topics  
+- Short reasoning steps  
+- Instruction–response tasks  
 
-Training Method
+### Not Recommended
+- High-stakes or decision-critical applications  
+- Domain-specific or specialized factual tasks  
+- Situations requiring verified accuracy  
 
-Fine-tuning was conducted using LoRA (Low-Rank Adaptation) to reduce hardware requirements and allow efficient experimentation.
-Key training characteristics:
+---
 
-Base model: SmolAI / SmolLM2-1.7B
+## Training Data
 
-Method: LoRA fine-tuning
+The model was fine-tuned on:
 
-Adapters were merged after training
+- argilla/synthetic-concise-reasoning-sft-filtered  
+- Instruction–answer pairs  
+- Synthetic reasoning prompts  
+- Concise explanation samples  
 
-Precision: FP32 safetensors
+The dataset consists of simplified synthetic data designed to enhance clarity, reasoning, and instruction handling.
 
-Training epochs: 3
+---
 
-Learning rate: 2e-4
+## Training Details
 
-Chat template included in the repository (chat_template.jinja)
+- Base Model: SmolAI/SmolLM2-1.7B  
+- Fine-Tuning Method: LoRA adapters (merged into final weights)  
+- Epochs: 3  
+- Learning Rate: 2e-4  
+- Loss: Causal language modeling  
+- Output Format: FP32 safetensors  
 
-The fine-tuning process focused on improving instruction clarity and response structure rather than domain specialization.
-
-Model Files
-
-The repository contains all necessary files to load the model with standard tooling:
-
-model.safetensors (merged model weights)
-
-config.json
-
-generation_config.json
-
-tokenizer.json, vocab.json, merges.txt
-
-special_tokens_map.json
-
-chat_template.jinja
+---