Update README.md

README.md

@@ -0,0 +1,143 @@
+---
+license: gemma
+language:
+  - ko
+  - en
+tags:
+  - korean
+  - reasoning
+  - instruction-tuning
+  - fine-tuning
+  - gemma3
+  - sft
+---
+
+# 🧠 gemma-3-12b-it-Ko-Reasoning
+
+> A large-scale Korean reasoning model fine-tuned from **google/gemma-3-12b-it**, designed to excel in logical and multi-hop reasoning tasks in Korean.
+
+---
+
+## 📌 Overview
+
+**gemma-3-12b-it-Ko-Reasoning** is a fine-tuned version of [google/gemma-3-12b-it](https://huggingface.co/google/gemma-3-12b-it), specifically optimized for **logical reasoning in Korean**. This model is part of a broader research initiative to explore:
+
+- The **transition from multilingual reasoning LLMs** to **Korean-specialized reasoning models**
+- The enhancement of **non-reasoning Korean language models** into **reasoning-capable variants**
+- The development of open-access models that rival proprietary alternatives in complex reasoning tasks
+
+This model was fine-tuned using a large-scale Korean-English instruction dataset containing diverse multi-hop questions, symbolic logic tasks, and human-crafted reasoning steps.
+
+---
+
+## 🧪 Benchmark Results
+
+> - 📊 All benchmarks were measured using the **0-shot CoT (Chain-of-Thought)** method.
+> - 📊 The **Score** represents either the **accuracy (%)** of correct answers or a rating on a **1-10 scale** from a judge model.
+> - 📊 **LLM-as-a-judge** benchmarks were evaluated using **GPT-4o (2024-08-01-preview)**.
+
+| **Benchmark**    | **Score**     |
+|------------------|---------------|
+| GPQA diamond     | 61.3          |
+| GSM8K            | 59.6          |
+| HAERAE           | 73.9          |
+| KSM              | 66.7          |
+| LogicKor         | 8.56          |
+| Math500          | 77.8          |
+| MT-Bench         | 8.54          |
+| MT-Bench(Ko)     | 8.80          |
+
+---
+
+## 🧑‍💻 Usage
+
+Install Transformers >= 4.50:
+
+```bash
+pip install -U transformers
+```
+
+Basic example:
+
+```python
+from transformers import AutoProcessor, Gemma3ForConditionalGeneration
+from PIL import Image
+import requests
+import torch
+
+model_id = "DimensionSTP/gemma-3-12b-it-Ko-Reasoning"
+
+model = Gemma3ForConditionalGeneration.from_pretrained(
+    model_id, device_map="auto"
+).eval()
+
+processor = AutoProcessor.from_pretrained(model_id)
+
+messages = [
+    {
+        "role": "system",
+        "content": [{"type": "text", "text": "You are a helpful assistant."}]
+    },
+    {
+        "role": "user",
+        "content": [
+            {"type": "text", "text": "서울과 부산 중 어디가 더 커?"}
+        ]
+    }
+]
+
+inputs = processor.apply_chat_template(
+    messages, add_generation_prompt=True, tokenize=True,
+    return_dict=True, return_tensors="pt"
+).to(model.device, dtype=torch.bfloat16)
+
+input_len = inputs["input_ids"].shape[-1]
+
+with torch.inference_mode():
+    generation = model.generate(**inputs, max_new_tokens=8192, do_sample=False)
+    generation = generation[0][input_len:]
+
+decoded = processor.decode(generation, skip_special_tokens=True)
+print(decoded)
+```
+
+---
+
+## 🧠 Base Model: google/gemma-3-12b-it
+
+The base model, [google/gemma-3-12b-it](https://huggingface.co/google/gemma-3-12b-it), is a VLM developed by the Google team.
+For more technical details, refer to the [Gemma 3 Technical Report](https://arxiv.org/abs/2503.19786).
+
+---
+
+## 🧱 Model Architecture
+
+| Property         | Value                                |
+|------------------|--------------------------------------|
+| Architecture     | Gemma3ForConditionalGeneration       |
+| Parameters       | 12B                                  |
+| Context Length   | 128,000 tokens                       |
+| Tokenizer        | Gemma3Tokenizer (BPE)                |
+
+---
+
+## 📅 Release Date
+
+**Mar 2025**  
+This model was released in March 2025 as part of the **Ko-Reasoning Series**, which focuses on pushing the boundaries of open-source reasoning in Korean using modern LLMs.
+
+---
+
+## 📬 Contact
+
+For questions, collaborations, or deployment inquiries, please contact:
+
+- 🤖 Hugging Face: [https://huggingface.co/DimensionSTP](https://huggingface.co/DimensionSTP)
+- ✉️ Email: [[email protected]]
+
+---
+
+## 📦 Available Checkpoints
+
+- ✅ `main`: Final stable version from the `last` branch
+- ✅ All training artifacts available (tokenizer, config, model weights)