Update README.md

README.md

@@ -9,4 +9,79 @@ library_name: transformers
 tags:
 - qwq
 - reasoning
----
+---
+# **QwQ-Math-IO-500M [ Qwen Base ]**
+
+QwQ-Math-IO-500M is a fine-tuned variant of Qwen2.5-0.5B, specifically optimized for mathematical problem-solving, input-output reasoning, and text generation tasks. This model contains 494 million parameters and uses FP16 tensor type for efficient inference. It leverages the robust architecture of Qwen2.5 and has undergone further enhancements to excel in structured reasoning, complex mathematical operations, and multilingual support.
+
+---
+
+## **Key Features**
+
+1. **Base Model**: Derived from [Qwen/Qwen2.5-0.5B](https://huggingface.co/Qwen/Qwen2.5-0.5B).
+2. **Finetuned on Instruction and Math Data**: Built upon Qwen2.5-0.5B-Instruct with specialized datasets for better instruction-following and mathematical reasoning.
+3. **Specialization**:
+   - Advanced mathematical problem-solving and reasoning.
+   - Enhanced input-output tasks for structured outputs (JSON, tables).
+   - Support for long-form content generation.
+   - Multilingual capabilities (over 29 languages).
+4. **Optimized for Long Context**: Supports input contexts up to 128K tokens with generation capability up to 8K tokens.
+
+---
+
+## **Datasets Used**
+
+The model was fine-tuned on high-quality datasets explicitly curated for Chain of Thought (CoT) reasoning, mathematical problem-solving, and long-context tasks. Notable datasets include:
+
+1. **[amphora/QwQ-LongCoT-130K](https://huggingface.co/datasets/amphora/QwQ-LongCoT-130K)**: 133k samples focused on complex CoT reasoning.
+2. **[qingy2024/QwQ-LongCoT-Verified-130K](https://huggingface.co/datasets/qingy2024/QwQ-LongCoT-Verified-130K)**: 467k verified samples emphasizing detailed step-by-step reasoning.
+3. **[gghfez/QwQ-LongCoT-130K-cleaned](https://huggingface.co/datasets/gghfez/QwQ-LongCoT-130K-cleaned)**: 125k cleaned samples for high-accuracy reasoning tasks.
+
+---
+
+## **Running the Model**
+
+To run the model using the Transformers library:
+
+```python
+# Install necessary libraries
+# pip install transformers torch
+
+from transformers import AutoTokenizer, AutoModelForCausalLM
+import torch
+
+tokenizer = AutoTokenizer.from_pretrained("prithivMLmods/QwQ-Math-IO-500M")
+model = AutoModelForCausalLM.from_pretrained(
+    "prithivMLmods/QwQ-Math-IO-500M",
+    torch_dtype=torch.float16,
+    device_map="auto",
+)
+
+input_text = "Solve the equation: 2x + 5 = 15."
+input_ids = tokenizer(input_text, return_tensors="pt").to("cuda")
+
+outputs = model.generate(**input_ids, max_new_tokens=100)
+print(tokenizer.decode(outputs[0], skip_special_tokens=True))
+```
+
+---
+
+## **Limitations**
+
+1. **Bias and Fairness**: Despite fine-tuning efforts, biases from the training data may persist. Users should critically assess model outputs.
+2. **Contextual Understanding**: While optimized for long contexts, the model may still occasionally misinterpret highly ambiguous prompts.
+3. **Mathematical Accuracy**: Although fine-tuned for math tasks, complex or highly specialized problems may require verification.
+4. **Real-Time Knowledge**: The model's knowledge is limited to its training data and does not include real-time or post-training updates.
+5. **Safety Considerations**: Safety alignment has been performed, but users should monitor outputs to avoid inappropriate content.
+6. **Resource Requirements**: Running the model efficiently requires a GPU with sufficient memory.
+
+---
+
+## **Intended Use Cases**
+
+1. **Mathematical Assistance**: Solving equations, performing calculations, and explaining mathematical concepts.
+2. **Conversational AI**: Enhanced dialogue capabilities with nuanced understanding and context retention.
+3. **Educational Assistance**: Generating detailed explanations, tutorials, and step-by-step guides.
+4. **Content Creation**: Assisting in writing blogs, articles, and creative content.
+5. **Multilingual Applications**: Supporting content generation and translation across multiple languages.
+6. **Data Generation**: Producing structured outputs such as JSON and tables for various applications.