Upload 6 files

.gitattributes

@@ -33,3 +33,7 @@ saved_model/**/* 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
+crystal-think-v2-q4_k_m.gguf filter=lfs diff=lfs merge=lfs -text
+crystal-think-v2-q5_k_m.gguf filter=lfs diff=lfs merge=lfs -text
+crystal-think-v2-q6_k.gguf filter=lfs diff=lfs merge=lfs -text
+crystal-think-v2-q8_0.gguf filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,200 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (which shall not include a work that constitutes a Contribution).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based upon (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and derivative works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control
+   systems, and issue tracking systems that are managed by, or on behalf
+   of, the Licensor for the purpose of discussing and improving the Work,
+   but excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to use, reproduce, modify, display, perform,
+   sublicense, and distribute the Work and such Derivative Works in
+   Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright notice to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. IN NO EVENT AND UNDER NO LEGAL THEORY,
+   WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE,
+   UNLESS REQUIRED BY APPLICABLE LAW (SUCH AS DELIBERATE AND GROSSLY
+   NEGLIGENT ACTS) OR AGREED TO IN WRITING, SHALL ANY CONTRIBUTOR BE
+   LIABLE TO YOU FOR DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL,
+   INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER ARISING AS A
+   RESULT OF THIS LICENSE OR OUT OF THE USE OR INABILITY TO USE THE
+   WORK (INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOSS OF GOODWILL,
+   WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL
+   OTHER COMMERCIAL DAMAGES OR LOSSES), EVEN IF SUCH CONTRIBUTOR
+   HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+9. Accepting Warranty or Additional Liability. When redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same page as the copyright notice for easier identification within
+   third-party archives.
+
+Copyright 2025 Pink Pixel
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. 

README.md

@@ -1,3 +1,275 @@
 ---
 license: apache-2.0
+language:
+- en
+library_name: gguf
+pipeline_tag: text-generation
+tags:
+- mathematical-reasoning
+- qwen3
+- gguf
+- quantized
+- math
+- reasoning
+- fine-tuned
+base_model: PinkPixel/Crystal-Think-V2
+quantized_by: PinkPixel
 ---
+
+# 🧠 Crystal Think V2 - GGUF Quantized ✨
+
+**Optimized GGUF Quantizations for Efficient Mathematical Reasoning**
+
+> **🔗 Original Model:** [PinkPixel/Crystal-Think-V2](https://huggingface.co/PinkPixel/Crystal-Think-V2)  
+> **📦 Quantized by:** Pink Pixel  
+> **🏷️ License:** Apache 2.0  
+
+---
+
+## 📋 About This Repository
+
+This repository contains **GGUF quantized versions** of Crystal Think V2, an advanced mathematical reasoning model based on Qwen3-4B. These quantized versions are optimized for **efficient inference** while maintaining excellent mathematical reasoning capabilities.
+
+### 🎯 Original Model Features
+- 🧮 **Advanced Mathematical Reasoning** with enhanced chain-of-thought
+- 📐 **Multi-step Problem Solving** with clear explanations
+- 💻 **Mathematical Code Generation** and algorithm explanation
+- 🎯 **Enhanced `<think></think>` Reasoning Format**
+- 📊 **85.2% GSM8K accuracy** (+8.8% over base Qwen3-4B)
+
+---
+
+## 📦 Available Quantizations
+
+| Quantization | File Size | Use Case | Memory Required | Quality |
+|-------------|-----------|----------|-----------------|---------|
+| **Q4_K_M** | 2.3GB | Balanced efficiency | ~6GB RAM | Good |
+| **Q5_K_M** | 2.7GB | Better quality | ~7GB RAM | Very Good |
+| **Q6_K** | 3.1GB | High quality | ~8GB RAM | Excellent |
+| **Q8_0** | 4.0GB | Maximum quality | ~10GB RAM | Near-Original |
+
+### 💡 **Quantization Guide:**
+- **Q4_K_M** - Best for limited hardware, good performance
+- **Q5_K_M** - Recommended balance of speed and quality  
+- **Q6_K** - High quality with reasonable speed
+- **Q8_0** - Near-original quality, slower inference
+
+---
+
+## 🚀 Quick Start
+
+### Using llama.cpp
+
+```bash
+# Download your preferred quantization
+wget https://huggingface.co/PinkPixel/Crystal-Think-V2-GGUF/resolve/main/crystal-think-v2-q5_k_m.gguf
+
+# Run with llama.cpp
+./llama.cpp/main -m crystal-think-v2-q5_k_m.gguf -p "Solve this step by step: If x + 2y = 10 and 2x - y = 5, find x and y." -n 512
+```
+
+### Using llama-cpp-python
+
+```python
+from llama_cpp import Llama
+
+# Load the model
+llm = Llama(
+    model_path="crystal-think-v2-q5_k_m.gguf",
+    n_ctx=4096,  # Context length
+    n_threads=8, # CPU threads
+    verbose=False
+)
+
+# Mathematical reasoning example
+prompt = """Solve this step by step:
+A rectangle has a length that is 3 more than twice its width. If the perimeter is 42 cm, what are the dimensions?
+
+Use <think></think> for your reasoning."""
+
+response = llm(
+    prompt,
+    max_tokens=512,
+    temperature=0.7,
+    stop=["</SOLUTION>", "<|endoftext|>"]
+)
+
+print(response["choices"][0]["text"])
+```
+
+### Using Ollama
+
+```bash
+# Create Modelfile
+echo 'FROM ./crystal-think-v2-q5_k_m.gguf' > Modelfile
+
+# Create Ollama model
+ollama create crystal-think-v2 -f Modelfile
+
+# Run the model
+ollama run crystal-think-v2 "What is the derivative of x^3 + 2x^2 - 5?"
+```
+
+---
+
+## 🎯 Enhanced Reasoning Format
+
+Crystal Think V2 uses a structured reasoning approach:
+
+```
+<think>
+[Step-by-step reasoning process]
+- Variable definitions
+- Equation setup
+- Mathematical operations
+- Verification steps
+</think>
+
+<SOLUTION>
+[Final organized answer]
+1) Specific results
+2) Numerical values
+3) Units and context
+</SOLUTION>
+```
+
+---
+
+## 📊 Performance Benchmarks
+
+### Original Model Performance
+| Benchmark | Score | Improvement over Base |
+|-----------|-------|----------------------|
+| **GSM8K** | 85.2% | +8.8% |
+| **MATH** | 42.1% | +10.4% |
+| **Algebra** | 78.9% | +13.7% |
+| **Geometry** | 71.3% | +12.5% |
+| **Code Math** | 82.6% | +13.5% |
+
+### GGUF Quantization Impact
+- **Q8_0**: ~99% original performance
+- **Q6_K**: ~97% original performance  
+- **Q5_K_M**: ~95% original performance
+- **Q4_K_M**: ~92% original performance
+
+---
+
+## 💻 Hardware Requirements
+
+### Minimum Requirements
+| Quantization | RAM | VRAM (GPU) | CPU |
+|-------------|-----|-----------|-----|
+| Q4_K_M | 6GB | 4GB | 4 cores |
+| Q5_K_M | 7GB | 5GB | 4 cores |
+| Q6_K | 8GB | 6GB | 6 cores |
+| Q8_0 | 10GB | 8GB | 8 cores |
+
+### Recommended for Best Performance
+- **CPU**: Modern 8+ core processor
+- **RAM**: 16GB+ system memory
+- **GPU**: 8GB+ VRAM (optional, for GPU acceleration)
+
+---
+
+## 🔧 Installation & Dependencies
+
+### llama.cpp
+```bash
+git clone https://github.com/ggerganov/llama.cpp
+cd llama.cpp
+make
+```
+
+### llama-cpp-python
+```bash
+pip install llama-cpp-python
+# For GPU support (optional)
+CMAKE_ARGS="-DLLAMA_CUBLAS=on" pip install llama-cpp-python
+```
+
+### Ollama
+```bash
+# Install Ollama
+curl -fsSL https://ollama.com/install.sh | sh
+```
+
+---
+
+## 📚 Usage Examples
+
+### Basic Mathematical Problem
+```
+Input: "What is the integral of 2x + 3?"
+Expected: Step-by-step integration with explanation
+```
+
+### Complex Word Problem
+```
+Input: "A train travels 120 miles in 2 hours, then 180 miles in 3 hours. What's the average speed?"
+Expected: Detailed solution with calculations
+```
+
+### Algebraic Reasoning
+```
+Input: "Solve the system: 3x + 2y = 12, x - y = 1"
+Expected: Systematic solution using substitution or elimination
+```
+
+---
+
+## 🔗 Related Links
+
+- **🏠 Original Model:** [PinkPixel/Crystal-Think-V2](https://huggingface.co/PinkPixel/Crystal-Think-V2)
+- **📖 Model Documentation:** [Crystal Think V2 README](https://huggingface.co/PinkPixel/Crystal-Think-V2/blob/main/README.md)
+- **🛠️ llama.cpp:** [GitHub Repository](https://github.com/ggerganov/llama.cpp)
+- **🐍 llama-cpp-python:** [PyPI Package](https://pypi.org/project/llama-cpp-python/)
+
+---
+
+## ⚠️ Limitations
+
+- **Domain Focus**: Optimized for mathematical reasoning; may be less effective for general conversation
+- **Quantization Trade-offs**: Lower quantizations may show reduced accuracy on complex problems
+- **Language**: Primarily trained on English mathematical content
+- **Hardware Dependency**: Performance varies significantly with hardware specifications
+
+---
+
+## 📈 Benchmarking Your Setup
+
+Test your quantization choice with this sample problem:
+
+```
+Prompt: "A rectangular garden has a length that is 4 meters more than twice its width. The garden is surrounded by a walkway that is 2 meters wide on all sides. If the total area (garden + walkway) is 294 square meters, find the dimensions of the garden."
+
+Expected: The model should show step-by-step reasoning and arrive at width ≈ 8.13m, length ≈ 20.26m
+```
+
+---
+
+## 🤝 Contributing
+
+Found an issue with the quantizations or have suggestions for improvements? Please open an issue or reach out!
+
+---
+
+## 📧 Contact & Support
+
+- **Developer:** Pink Pixel
+- **GitHub:** [https://github.com/pinkpixel-dev](https://github.com/pinkpixel-dev)
+- **Website:** [https://pinkpixel.dev](https://pinkpixel.dev)
+- **Email:** [admin@pinkpixel.dev](mailto:admin@pinkpixel.dev)
+
+---
+
+## 🙏 Acknowledgments
+
+- **Original Model:** Crystal Think V2 by Pink Pixel
+- **Base Model:** [Qwen/Qwen3-4B](https://huggingface.co/Qwen/Qwen3-4B) by Qwen Team
+- **Quantization Tools:** [llama.cpp](https://github.com/ggerganov/llama.cpp) by Georgi Gerganov
+- **Training Dataset:** [NVIDIA OpenMathReasoning](https://huggingface.co/datasets/nvidia/OpenMathReasoning)
+
+---
+
+**Made with ❤️ by Pink Pixel** ✨  
+*"Dream it, Pixel it"* 

crystal-think-v2-q4_k_m.gguf

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

crystal-think-v2-q5_k_m.gguf

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

crystal-think-v2-q6_k.gguf

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

crystal-think-v2-q8_0.gguf

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