commit 7c5ecf9f6f6b92da38f771c4fc8da23539659fdd Author: ModelHub XC Date: Sun Jul 12 03:30:08 2026 +0800 初始化项目，由ModelHub XC社区提供模型 Model: LGAI-EXAONE/EXAONE-Deep-2.4B-GGUF Source: Original Platform diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..53d7257 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,47 @@ +*.7z filter=lfs diff=lfs merge=lfs -text +*.arrow filter=lfs diff=lfs merge=lfs -text +*.bin filter=lfs diff=lfs merge=lfs -text +*.bin.* filter=lfs diff=lfs merge=lfs -text +*.bz2 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 +*.model filter=lfs diff=lfs merge=lfs -text +*.msgpack 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 +*.pt filter=lfs diff=lfs merge=lfs -text +*.pth filter=lfs diff=lfs merge=lfs -text +*.rar filter=lfs diff=lfs merge=lfs -text +saved_model/**/* 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 +*.xz filter=lfs diff=lfs merge=lfs -text +*.zip filter=lfs diff=lfs merge=lfs -text +*.zstandard filter=lfs diff=lfs merge=lfs -text +*.tfevents* filter=lfs diff=lfs merge=lfs -text +*.db* filter=lfs diff=lfs merge=lfs -text +*.ark* filter=lfs diff=lfs merge=lfs -text +**/*ckpt*data* filter=lfs diff=lfs merge=lfs -text +**/*ckpt*.meta filter=lfs diff=lfs merge=lfs -text +**/*ckpt*.index filter=lfs diff=lfs merge=lfs -text +*.safetensors filter=lfs diff=lfs merge=lfs -text +*.ckpt filter=lfs diff=lfs merge=lfs -text +*.gguf* filter=lfs diff=lfs merge=lfs -text +*.ggml filter=lfs diff=lfs merge=lfs -text +*.llamafile* filter=lfs diff=lfs merge=lfs -text +*.pt2 filter=lfs diff=lfs merge=lfs -text +*.mlmodel filter=lfs diff=lfs merge=lfs -text +*.npy filter=lfs diff=lfs merge=lfs -text +*.npz filter=lfs diff=lfs merge=lfs -text +*.pickle filter=lfs diff=lfs merge=lfs -text +*.pkl filter=lfs diff=lfs merge=lfs -text +*.tar filter=lfs diff=lfs merge=lfs -text +*.wasm filter=lfs diff=lfs merge=lfs -text +*.zst filter=lfs diff=lfs merge=lfs -text +*tfevents* filter=lfs diff=lfs merge=lfs -text \ No newline at end of file diff --git a/EXAONE-Deep-2.4B-BF16.gguf b/EXAONE-Deep-2.4B-BF16.gguf new file mode 100644 index 0000000..e5a07ad --- /dev/null +++ b/EXAONE-Deep-2.4B-BF16.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:ec74fc2e730ad5e9aad878144d9be7226ea20a1746dc138b22755399474a4917 +size 5339454080 diff --git a/EXAONE-Deep-2.4B-IQ4_XS.gguf b/EXAONE-Deep-2.4B-IQ4_XS.gguf new file mode 100644 index 0000000..65b4308 --- /dev/null +++ b/EXAONE-Deep-2.4B-IQ4_XS.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:761eff8e448523c0ba37b4dae255a04d04e246cfa1b01d5e9379f2ac8037e800 +size 1513892480 diff --git a/EXAONE-Deep-2.4B-Q4_K_M.gguf b/EXAONE-Deep-2.4B-Q4_K_M.gguf new file mode 100644 index 0000000..f3031cd --- /dev/null +++ b/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 diff --git a/EXAONE-Deep-2.4B-Q5_K_M.gguf b/EXAONE-Deep-2.4B-Q5_K_M.gguf new file mode 100644 index 0000000..7783230 --- /dev/null +++ b/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 diff --git a/EXAONE-Deep-2.4B-Q6_K.gguf b/EXAONE-Deep-2.4B-Q6_K.gguf new file mode 100644 index 0000000..898f3f0 --- /dev/null +++ b/EXAONE-Deep-2.4B-Q6_K.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:035a268fada5821c1d9e70b15baa2dbab31d075bb41db6da551fe524102c22b5 +size 2192855680 diff --git a/EXAONE-Deep-2.4B-Q8_0.gguf b/EXAONE-Deep-2.4B-Q8_0.gguf new file mode 100644 index 0000000..1cfdf92 --- /dev/null +++ b/EXAONE-Deep-2.4B-Q8_0.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8a7df20b48dd67ca698b34c5cea312662a6ee988c1b113d600a953c82e4fd9fb +size 2838846080 diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..6a427ac --- /dev/null +++ b/LICENSE @@ -0,0 +1,162 @@ +EXAONE AI Model License Agreement 1.1 - NC + +This License Agreement (“Agreement”) is entered into between you (“Licensee”) and LG Management Development +Institute Co., Ltd. (“Licensor”), governing the use of the EXAONE AI Model (“Model”). By downloading, +installing, copying, or using the Model, you agree to comply with and be bound by the terms of this Agreement. +If you do not agree to all the terms, you must not download, install, copy, or use the Model. This Agreement +constitutes a binding legal agreement between the Licensee and Licensor. + +1. Definitions + 1.1 Model: The artificial intelligence model provided by Licensor, which includes any software, + algorithms, machine learning models, or related components supplied by Licensor. This definition extends + to encompass all updates, enhancements, improvements, bug fixes, patches, or other modifications that may + be provided by Licensor from time to time, whether automatically or manually implemented. + 1.2 Derivatives: Any modifications, alterations, enhancements, improvements, adaptations, or derivative + works of the Model created by Licensee or any third party. This includes changes made to the Model's + architecture, parameters, data processing methods, or any other aspect of the Model that results in a + modification of its functionality or output. + 1.3 Output: Any data, results, content, predictions, analyses, insights, or other materials generated by + the Model or Derivatives, regardless of whether they are in their original form or have been further + processed or modified by the Licensee. This includes, but is not limited to, textual or numerical produced + directly or indirectly through the use of the Model. + 1.4 Licensor: LG Management Development Institute Co., Ltd., the owner, developer, and provider of the + EXAONE AI Model. The Licensor holds all rights, title, and interest in the Model and is responsible for + granting licenses to use the Model under the terms specified in this Agreement. + 1.5 Licensee: The individual, organization, corporation, academic institution, government agency, or other + entity using or intending to use the Model under the terms and conditions of this Agreement. The Licensee + is responsible for ensuring compliance with the Agreement by all authorized users who access or utilize + the Model on behalf of the Licensee. + +2. License Grant + 2.1 Grant of License: Subject to the terms and conditions outlined in this Agreement, the Licensor hereby + grants the Licensee a limited, non-exclusive, non-transferable, worldwide, and revocable license to: + a. Access, download, install, and use the Model solely for research purposes. This includes + evaluation, testing, academic research, experimentation, and participation in competitions, provided + that such participation is in a non-commercial context. Notwithstanding Section 3.1, the Licensee may + only provide the Model or Derivatives for a competition if no commercial license is granted to the + competition organizer or any third party. + b. Publicly disclose research results and findings derived from the use of the Model or Derivatives, + including publishing papers or presentations. + c. Modify the Model and create Derivatives based on the Model, provided that such modifications and + Derivatives are used exclusively for research purposes. The Licensee may conduct experiments, perform + analyses, and apply custom modifications to the Model to explore its capabilities and performance + under various scenarios. If the Model is modified, the modified Model must include “EXAONE” at the + beginning of its name. + d. Distribute the Model and Derivatives in each case with a copy of this Agreement. + 2.2 Scope of License: The license granted herein does not authorize the Licensee to use the Model for any + purpose not explicitly permitted under this Agreement. Any use beyond the scope of this license, including + any commercial application or external distribution, is strictly prohibited unless explicitly agreed upon + in writing by the Licensor. + +3. Restrictions + 3.1 Commercial Use: The Licensee is expressly prohibited from using the Model, Derivatives, or Output for + any commercial purposes, including but not limited to, developing or deploying products, services, or + applications that generate revenue, whether directly or indirectly. Any commercial exploitation of the + Model or its derivatives requires a separate commercial license agreement with the Licensor. Furthermore, + the Licensee shall not use the Model, Derivatives or Output to develop or improve other models. + 3.2 Reverse Engineering: The Licensee shall not decompile, disassemble, reverse engineer, or attempt to + derive the source code, underlying ideas, algorithms, or structure of the Model, except to the extent that + such activities are expressly permitted by applicable law. Any attempt to bypass or circumvent + technological protection measures applied to the Model is strictly prohibited. + 3.3 Unlawful Use: The Licensee shall not use the Model and Derivatives for any illegal, fraudulent, or + unauthorized activities, nor for any purpose that violates applicable laws or regulations. This includes + but is not limited to the creation, distribution, or dissemination of malicious, deceptive, or unlawful + content. + 3.4 Ethical Use: The Licensee shall ensure that the Model or Derivatives is used in an ethical and + responsible manner, adhering to the following guidelines: + a. The Model and Derivatives shall not be used to generate, propagate, or amplify false, misleading, + or harmful information, including fake news, misinformation, or disinformation. + b. The Model and Derivatives shall not be employed to create, distribute, or promote content that is + discriminatory, harassing, defamatory, abusive, or otherwise offensive to individuals or groups based + on race, gender, sexual orientation, religion, nationality, or other protected characteristics. + c. The Model and Derivatives shall not infringe on the rights of others, including intellectual + property rights, privacy rights, or any other rights recognized by law. The Licensee shall obtain all + necessary permissions and consents before using the Model and Derivatives in a manner that may impact + the rights of third parties. + d. The Model and Derivatives shall not be used in a way that causes harm, whether physical, mental, + emotional, or financial, to individuals, organizations, or communities. The Licensee shall take all + reasonable measures to prevent misuse or abuse of the Model and Derivatives that could result in harm + or injury. + +4. Ownership + 4.1 Intellectual Property: All rights, title, and interest in and to the Model, including any + modifications, Derivatives, and associated documentation, are and shall remain the exclusive property of + the Licensor. The Licensee acknowledges that this Agreement does not transfer any ownership rights to the + Licensee. All trademarks, service marks, and logos associated with the Model are the property of the + Licensor. + 4.2 Output: All rights, title, and interest in and to the Output generated by the Model and Derivatives + whether in its original form or modified, are and shall remain the exclusive property of the Licensor. + Licensee may use, modify, and distribute the Output and its derivatives for research purpose. The Licensee + shall not claim ownership of the Output except as expressly provided in this Agreement. The Licensee may + use the Output solely for the purposes permitted under this Agreement and shall not exploit the Output for + unauthorized or commercial purposes. + 4.3 Attribution: In any publication or presentation of results obtained using the Model, the Licensee + shall provide appropriate attribution to the Licensor, citing the Model's name and version, along with any + relevant documentation or references specified by the Licensor. + +5. No Warranty + 5.1 “As-Is” Basis: The Model, Derivatives, and Output are provided on an “as-is” and “as-available” basis, + without any warranties or representations of any kind, whether express, implied, or statutory. The + Licensor disclaims all warranties, including but not limited to, implied warranties of merchantability, + fitness for a particular purpose, accuracy, reliability, non-infringement, or any warranty arising from + the course of dealing or usage of trade. + 5.2 Performance and Reliability: The Licensor does not warrant or guarantee that the Model, Derivatives or + Output will meet the Licensee’s requirements, that the operation of the Model, Derivatives or Output will + be uninterrupted or error-free, or that defects in the Model will be corrected. The Licensee acknowledges + that the use of the Model, Derivatives or Output is at its own risk and that the Model, Derivatives or + Output may contain bugs, errors, or other limitations. + 5.3 No Endorsement: The Licensor does not endorse, approve, or certify any results, conclusions, or + recommendations derived from the use of the Model. The Licensee is solely responsible for evaluating the + accuracy, reliability, and suitability of the Model for its intended purposes. + +6. Limitation of Liability + 6.1 No Liability for Damages: To the fullest extent permitted by applicable law, in no event shall the + Licensor be liable for any special, incidental, indirect, consequential, exemplary, or punitive damages, + including but not limited to, damages for loss of business profits, business interruption, loss of + business information, loss of data, or any other pecuniary or non-pecuniary loss arising out of or in + connection with the use or inability to use the Model, Derivatives or any Output, even if the Licensor has + been advised of the possibility of such damages. + 6.2 Indemnification: The Licensee agrees to indemnify, defend, and hold harmless the Licensor, its + affiliates, officers, directors, employees, and agents from and against any claims, liabilities, damages, + losses, costs, or expenses (including reasonable attorneys' fees) arising out of or related to the + Licensee's use of the Model, any Derivatives, or any Output, including any violation of this Agreement or + applicable laws. + +7. Termination + 7.1 Termination by Licensor: The Licensor reserves the right to terminate this Agreement and revoke the + Licensee’s rights to use the Model at any time, with or without cause, and without prior notice if the + Licensee breaches any of the terms or conditions of this Agreement. Termination shall be effective + immediately upon notice. + 7.2 Effect of Termination: Upon termination of this Agreement, the Licensee must immediately cease all use + of the Model, Derivatives, and Output and destroy all copies of the Model, Derivatives, and Output in its + possession or control, including any backup or archival copies. The Licensee shall certify in writing to + the Licensor that such destruction has been completed. + 7.3 Survival: The provisions of this Agreement that by their nature should survive termination, including + but not limited to, Sections 4 (Ownership), 5 (No Warranty), 6 (Limitation of Liability), and this Section + 7 (Termination), shall continue to apply after termination. + +8. Governing Law + 8.1 Governing Law: This Agreement shall be governed by and construed in accordance with the laws of the + Republic of Korea, without regard to its conflict of laws principles. + 8.2 Arbitration: Any disputes, controversies, or claims arising out of or relating to this Agreement, + including its existence, validity, interpretation, performance, breach, or termination, shall be referred + to and finally resolved by arbitration administered by the Korean Commercial Arbitration Board (KCAB) in + accordance with the International Arbitration Rules of the Korean Commercial Arbitration Board in force at + the time of the commencement of the arbitration. The seat of arbitration shall be Seoul, Republic of + Korea. The tribunal shall consist of one arbitrator. The language of the arbitration shall be English. + +9. Alterations + 9.1 Modifications: The Licensor reserves the right to modify or amend this Agreement at any time, in its + sole discretion. Any modifications will be effective upon posting the updated Agreement on the Licensor’s + website or through other means of communication. The Licensee is responsible for reviewing the Agreement + periodically for changes. Continued use of the Model after any modifications have been made constitutes + acceptance of the revised Agreement. + 9.2 Entire Agreement: This Agreement constitutes the entire agreement between the Licensee and Licensor + concerning the subject matter hereof and supersedes all prior or contemporaneous oral or written + agreements, representations, or understandings. Any terms or conditions of any purchase order or other + document submitted by the Licensee in connection with the Model that are in addition to, different from, + or inconsistent with the terms and conditions of this Agreement are not binding on the Licensor and are + void. + +By downloading, installing, or using the EXAONE AI Model, the Licensee acknowledges that it has read, +understood, and agrees to be bound by the terms and conditions of this Agreement. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..8385323 --- /dev/null +++ b/README.md @@ -0,0 +1,136 @@ +--- +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 +--- + +

+ +
+ +# 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://arxiv.org/abs/2503.12524), [blog](https://www.lgresearch.ai/news/view?seq=543) and [GitHub](https://github.com/LG-AI-EXAONE/EXAONE-Deep). + +

+ + +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 '' in content %}{% set content = content.split('')[-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|]\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://arxiv.org/abs/2503.12524). + +## Deployment + +EXAONE Deep models can be inferred in the various frameworks, such as: +- `TensorRT-LLM` +- `vLLM` +- `SGLang` +- `llama.cpp` +- `Ollama` +- `LM-Studio` + +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 `\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 `\n...\n` 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. Additional instructions help the models reason more deeply, so that the models generate better output. + - For math problems, the instructions **"Please reason step by step, and put your final answer within \boxed{}."** are helpful. + - For more information on our evaluation setting including prompts, please refer to our [Documentation](https://arxiv.org/abs/2503.12524). +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 + +``` +@article{exaone-deep, + title={EXAONE Deep: Reasoning Enhanced Language Models}, + author={{LG AI Research}}, + journal={arXiv preprint arXiv:2503.12524}, + year={2025} +} +``` + +## Contact +LG AI Research Technical Support: contact_us@lgresearch.ai \ No newline at end of file diff --git a/assets/EXAONE_Symbol+BI_3d.png b/assets/EXAONE_Symbol+BI_3d.png new file mode 100644 index 0000000..d2a9060 Binary files /dev/null and b/assets/EXAONE_Symbol+BI_3d.png differ diff --git a/assets/exaone_deep_overall_performance.png b/assets/exaone_deep_overall_performance.png new file mode 100644 index 0000000..42b1c05 Binary files /dev/null and b/assets/exaone_deep_overall_performance.png differ diff --git a/configuration.json b/configuration.json new file mode 100644 index 0000000..bbeeda1 --- /dev/null +++ b/configuration.json @@ -0,0 +1 @@ +{"framework": "pytorch", "task": "text-generation", "allow_remote": true} \ No newline at end of file