Initial commit

.gitattributes

@@ -0,0 +1,36 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.gguf filter=lfs diff=lfs merge=lfs -text

EXAONE-Deep-2.4B-BF16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ec74fc2e730ad5e9aad878144d9be7226ea20a1746dc138b22755399474a4917
+size 5339454080

EXAONE-Deep-2.4B-IQ4_XS.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:761eff8e448523c0ba37b4dae255a04d04e246cfa1b01d5e9379f2ac8037e800
+size 1513892480

EXAONE-Deep-2.4B-Q4_K_M.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e70e6c1714d9fe005578c35f6eea1c5d70d2a72e2cf801c8b9b811beba034369
+size 1644918400

EXAONE-Deep-2.4B-Q5_K_M.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9add15ef331ae06ad61fc550794d7acd3a1eb3b2e79f841caa8c93f318de72f6
+size 1910584960

EXAONE-Deep-2.4B-Q6_K.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:035a268fada5821c1d9e70b15baa2dbab31d075bb41db6da551fe524102c22b5
+size 2192855680

EXAONE-Deep-2.4B-Q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8a7df20b48dd67ca698b34c5cea312662a6ee988c1b113d600a953c82e4fd9fb
+size 2838846080

README.md

@@ -0,0 +1,126 @@
+---
+base_model: LGAI-EXAONE/EXAONE-Deep-2.4B
+base_model_relation: quantized
+license: other
+license_name: exaone
+license_link: LICENSE
+language:
+- en
+- ko
+tags:
+- lg-ai
+- exaone
+- exaone-deep
+pipeline_tag: text-generation
+library_name: transformers
+---
+
+<p align="center">
+<img src="assets/EXAONE_Symbol+BI_3d.png", width="300", style="margin: 40 auto;">
+<br>
+
+# EXAONE-Deep-2.4B-GGUF
+
+## Introduction
+
+We introduce EXAONE Deep, which exhibits superior capabilities in various reasoning tasks including math and coding benchmarks, ranging from 2.4B to 32B parameters developed and released by LG AI Research. Evaluation results show that 1) EXAONE Deep **2.4B** outperforms other models of comparable size, 2) EXAONE Deep **7.8B** outperforms not only open-weight models of comparable scale but also a proprietary reasoning model OpenAI o1-mini, and 3) EXAONE Deep **32B** demonstrates competitive performance against leading open-weight models.
+
+For more details, please refer to our [documentation](https://lgresearch.ai/data/upload/EXAONE_Deep__Model_Card.pdf), [blog](https://www.lgresearch.ai/news/view?seq=543) and [GitHub](https://github.com/LG-AI-EXAONE/EXAONE-Deep).
+
+<p align="center">
+<img src="assets/exaone_deep_overall_performance.png", width="100%", style="margin: 40 auto;">
+
+This repository contains the various precisions of the reasoning 2.4B language model in GGUF format, which contains the following features:
+
+- Number of Parameters (without embeddings): 2.14B
+- Number of Layers: 30
+- Number of Attention Heads: GQA with 32 Q-heads and 8 KV-heads
+- Vocab Size: 102,400
+- Context Length: 32,768 tokens
+- Tie Word Embeddings: True (unlike 7.8B and 32B models)
+- Quantization: `Q8_0`, `Q6_K`, `Q5_K_M`, `Q4_K_M`, `IQ4_XS` in GGUF format (also includes `BF16` weights)
+
+## Quickstart
+
+Here are the steps to run conversational inference with the model:
+
+1. Install llama.cpp. Please refer to the [llama.cpp repository](https://github.com/ggerganov/llama.cpp) for more details.
+
+2. Download EXAONE Deep model in GGUF format.
+
+```bash
+huggingface-cli download LGAI-EXAONE/EXAONE-Deep-2.4B-GGUF \
+    --include "EXAONE-Deep-2.4B-BF16*.gguf" \
+    --local-dir .
+```
+
+3. Run the model with llama.cpp in conversational mode. We set chat-template explicitly to handle reasoning steps properly. 
+
+```bash
+llama-cli -m ./EXAONE-Deep-2.4B-BF16.gguf \
+    -sys "" \
+    -c 32768 \
+    --temp 0.6 \
+    --top-p 0.95 \
+    --jinja \
+    --chat-template "{% for message in messages %}{% if loop.first and message['role'] != 'system' %}{{ '[|system|][|endofturn|]\n' }}{% endif %}{% set content = message['content'] %}{% if '</thought>' in content %}{% set content = content.split('</thought>')[-1].lstrip('\\n') %}{% endif %}{{ '[|' + message['role'] + '|]' + content }}{% if not message['role'] == 'user' %}{{ '[|endofturn|]' }}{% endif %}{% if not loop.last %}{{ '\n' }}{% endif %}{% endfor %}{% if add_generation_prompt %}{{ '\n[|assistant|]<thought>\n' }}{% endif %}"
+```
+
+> ### Note
+> The EXAONE Deep models are trained with an optimized configuration,
+> so we recommend following the [Usage Guideline](#usage-guideline) section to achieve optimal performance.
+
+## Evaluation
+
+You can check the evaluation results of original EXAONE Deep models at [GitHub](https://github.com/LG-AI-EXAONE/EXAONE-Deep) or our [documentation](https://lgresearch.ai/data/upload/EXAONE_Deep__Model_Card.pdf).
+
+## Deployment
+
+EXAONE Deep models can be inferred in the various frameworks, such as:
+- `TensorRT-LLM`
+- `vLLM`
+- `SGLang`
+- `llama.cpp`
+- `Ollama`
+
+Please refer to our [EXAONE Deep GitHub](https://github.com/LG-AI-EXAONE/EXAONE-Deep) for more details about the inference frameworks.
+
+## Quantization
+
+We provide the pre-quantized EXAONE Deep models with **AWQ** and several quantization types in **GGUF** format. Please refer to our [EXAONE Deep collection](https://huggingface.co/collections/LGAI-EXAONE/exaone-deep-67d119918816ec6efa79a4aa) to find corresponding quantized models.
+
+## Usage Guideline
+
+To achieve the expected performance, we recommend using the following configurations:
+
+1. Ensure the model starts with `<thought>\n` for reasoning steps. The model's output quality may be degraded when you omit it. You can easily apply this feature by using `tokenizer.apply_chat_template()` with `add_generation_prompt=True`. Please check the example code on [Quickstart](#quickstart) section.
+2. The reasoning steps of EXAONE Deep models enclosed by `<thought>\n...\n</thought>` usually have lots of tokens, so previous reasoning steps may be necessary to be removed in multi-turn situation. The provided tokenizer handles this automatically.
+3. Avoid using system prompt, and build the instruction on the user prompt. 
+4. When it comes to math problems, include **"Please reason step by step, and put your final answer within \boxed{}."** in your prompt. 
+5. In our evaluation, we use `temperature=0.6` and `top_p=0.95` for generation. 
+6. When evaluating the models, it is recommended to test multiple times to assess the expected performance accurately.
+
+## Limitation
+
+The EXAONE language model has certain limitations and may occasionally generate inappropriate responses. The language model generates responses based on the output probability of tokens, and it is determined during learning from training data. While we have made every effort to exclude personal, harmful, and biased information from the training data, some problematic content may still be included, potentially leading to undesirable responses. Please note that the text generated by EXAONE language model does not reflects the views of LG AI Research.
+
+- Inappropriate answers may be generated, which contain personal, harmful or other inappropriate information.
+- Biased responses may be generated, which are associated with age, gender, race, and so on.
+- The generated responses rely heavily on statistics from the training data, which can result in the generation of
+semantically or syntactically incorrect sentences.
+- Since the model does not reflect the latest information, the responses may be false or contradictory.
+
+LG AI Research strives to reduce potential risks that may arise from EXAONE language models. Users are not allowed
+to engage in any malicious activities (e.g., keying in illegal information) that may induce the creation of inappropriate
+outputs violating LG AI’s ethical principles when using EXAONE language models.
+
+## License
+
+The model is licensed under [EXAONE AI Model License Agreement 1.1 - NC](./LICENSE)
+
+## Citation
+ 
+TBU
+
+## Contact
+LG AI Research Technical Support: contact_us@lgresearch.ai