---
license: creativeml-openrail-m
language:
- en
base_model:
- prithivMLmods/QwQ-LCoT-3B-Instruct
pipeline_tag: text-generation
tags:
- text-generation-inference
- long-CoT
- 3B
- Instruct
- QwQ
- 8-bit
- F16
datasets:
- amphora/QwQ-LongCoT-130K
library_name: transformers
---
### **QwQ-LCoT-3B-Instruct-GGUF Model Card**

The **QwQ-LCoT-3B-Instruct** model is a lightweight, instruction-tuned language model designed for complex reasoning and explanation tasks. It is fine-tuned on the **Qwen2.5-3B-Instruct** base model using the **QwQ-LongCoT-130K** dataset, focusing on **long-chain-of-thought (LCoT)** reasoning for enhanced logical comprehension and detailed output generation.

| **File Name**                         | **Size**       | **Description**                                  | **Upload Status**  |
|----------------------------------------|----------------|-------------------------------------------------|--------------------|
| `.gitattributes`                       | 1.79 kB        | Specifies LFS tracking for large files.         | Uploaded           |
| `Modelfile`                            | 1.69 kB        | Possibly metadata or additional configuration.  | Uploaded           |
| `QwQ-LCoT-3B-Instruct.F16.gguf`        | 6.18 GB        | Model weights in full precision (FP16).         | Uploaded (LFS)     |
| `QwQ-LCoT-3B-Instruct.Q4_K_M.gguf`     | 1.93 GB        | Quantized model weights (Q4_K_M).               | Uploaded (LFS)     |
| `QwQ-LCoT-3B-Instruct.Q5_K_M.gguf`     | 2.22 GB        | Quantized model weights (Q5_K_M).               | Uploaded (LFS)     |
| `QwQ-LCoT-3B-Instruct.Q8_0.gguf`       | 3.29 GB        | Quantized model weights (Q8_0).                 | Uploaded (LFS)     |
| `README.md`                            | 42 Bytes       | Initial commit for project documentation.       | Uploaded           |
| `config.json`                          | 29 Bytes       | Minimal configuration file for the model.       | Uploaded           |

### **Sample Long CoT:**

![Screenshot 2024-12-13 211732.png](https://cdn-uploads.huggingface.co/production/uploads/65bb837dbfb878f46c77de4c/Mgm9LmQZlFZmglKYwEDYA.png)

### **Key Features:**

1. **Long Chain-of-Thought Reasoning:**  
   - Specifically designed to generate comprehensive, step-by-step explanations for complex queries.

2. **Lightweight and Efficient:**  
   - With only 3 billion parameters, it is optimized for systems with limited computational resources without compromising reasoning capabilities.

3. **Instruction Optimization:**  
   - Fine-tuned to follow prompts and provide concise, actionable, and structured responses.

---

### **Training Details:**

- **Base Model:** [Qwen2.5-3B-Instruct](#)  
- **Dataset:** [amphora/QwQ-LongCoT-130K](#)  
  - Comprising 133,000 annotated samples focusing on logical tasks and structured thinking.
---

### **Capabilities:**

1. **Text Generation:**  
   - Provides detailed, structured, and logical text outputs tailored to user prompts.

2. **Reasoning Tasks:**  
   - Solves step-by-step problems in math, logic, and science.

3. **Educational Assistance:**  
   - Generates coherent explanations for academic and research purposes.

4. **Dialogue and Summarization:**  
   - Handles conversational queries and summarizes long documents effectively.

---

### **Usage Instructions:**

1. **Setup:**
   Download all model files and ensure compatibility with the Hugging Face Transformers library.

2. **Loading the Model:**
   ```python
   from transformers import AutoModelForCausalLM, AutoTokenizer
   
   model_name = "prithivMLmods/QwQ-LCoT-3B-Instruct"
   tokenizer = AutoTokenizer.from_pretrained(model_name)
   model = AutoModelForCausalLM.from_pretrained(model_name)
   ```

3. **Generate Long-Chain Reasoning Outputs:**
   ```python
   input_text = "Explain the process of photosynthesis step-by-step."
   inputs = tokenizer(input_text, return_tensors="pt")
   outputs = model.generate(**inputs, max_length=300, temperature=0.5)
   print(tokenizer.decode(outputs[0], skip_special_tokens=True))
   ```

4. **Customize Output Generation:**  
   Modify the `generation_config.json` file for different scenarios:
   - **`temperature`**: Controls randomness (lower = deterministic, higher = creative).  
   - **`max_length`**: Sets response length.  
   - **`top_p`**: Adjusts sampling for diversity in outputs.

---

# Run with Ollama [ Ollama Run ]

## Overview

Ollama is a powerful tool that allows you to run machine learning models effortlessly. This guide will help you download, install, and run your own GGUF models in just a few minutes.

## Table of Contents

- [Download and Install Ollama](#download-and-install-ollama)
- [Steps to Run GGUF Models](#steps-to-run-gguf-models)
  - [1. Create the Model File](#1-create-the-model-file)
  - [2. Add the Template Command](#2-add-the-template-command)
  - [3. Create and Patch the Model](#3-create-and-patch-the-model)
- [Running the Model](#running-the-model)
- [Sample Usage](#sample-usage)

## Download and Install Ollama🦙

To get started, download Ollama from [https://ollama.com/download](https://ollama.com/download) and install it on your Windows or Mac system.

## Steps to Run GGUF Models

### 1. Create the Model File
First, create a model file and name it appropriately. For example, you can name your model file `metallama`.

### 2. Add the Template Command
In your model file, include a `FROM` line that specifies the base model file you want to use. For instance:

```bash
FROM Llama-3.2-1B.F16.gguf
```

Ensure that the model file is in the same directory as your script.

### 3. Create and Patch the Model
Open your terminal and run the following command to create and patch your model:

```bash
ollama create metallama -f ./metallama
```

Once the process is successful, you will see a confirmation message.

To verify that the model was created successfully, you can list all models with:

```bash
ollama list
```

Make sure that `metallama` appears in the list of models.

---

## Running the Model

To run your newly created model, use the following command in your terminal:

```bash
ollama run metallama
```

### Sample Usage / Test

In the command prompt, you can execute:

```bash
D:\>ollama run metallama
```

You can interact with the model like this:

```plaintext
>>> write a mini passage about space x
Space X, the private aerospace company founded by Elon Musk, is revolutionizing the field of space exploration.
With its ambitious goals to make humanity a multi-planetary species and establish a sustainable human presence in
the cosmos, Space X has become a leading player in the industry. The company's spacecraft, like the Falcon 9, have
demonstrated remarkable capabilities, allowing for the transport of crews and cargo into space with unprecedented
efficiency. As technology continues to advance, the possibility of establishing permanent colonies on Mars becomes
increasingly feasible, thanks in part to the success of reusable rockets that can launch multiple times without
sustaining significant damage. The journey towards becoming a multi-planetary species is underway, and Space X
plays a pivotal role in pushing the boundaries of human exploration and settlement.
```
---

## Conclusion

With these simple steps, you can easily download, install, and run your own models using Ollama. Whether you're exploring the capabilities of Llama or building your own custom models, Ollama makes it accessible and efficient.


- This README provides clear instructions and structured information to help users navigate the process of using Ollama effectively. Adjust any sections as needed based on your specific requirements or additional details you may want to include.

---