From 5bc63c28b3fceddf888865dd3c38bf766e5aa964 Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Tue, 14 Jul 2026 19:12:09 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=96=E9=A1=B9=E7=9B=AE?= =?UTF-8?q?=EF=BC=8C=E7=94=B1ModelHub=20XC=E7=A4=BE=E5=8C=BA=E6=8F=90?= =?UTF-8?q?=E4=BE=9B=E6=A8=A1=E5=9E=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Model: dystrio/gemma-2-2b-it-sculpt-experimental Source: Original Platform --- .gitattributes | 36 ++++++++++ README.md | 150 +++++++++++++++++++++++++++++++++++++++++ chat_template.jinja | 4 ++ config.json | 68 +++++++++++++++++++ generation_config.json | 11 +++ model.safetensors | 3 + tokenizer.json | 3 + tokenizer_config.json | 19 ++++++ 8 files changed, 294 insertions(+) create mode 100644 .gitattributes create mode 100644 README.md create mode 100644 chat_template.jinja create mode 100644 config.json create mode 100644 generation_config.json create mode 100644 model.safetensors create mode 100644 tokenizer.json create mode 100644 tokenizer_config.json diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..52373fe --- /dev/null +++ b/.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 +tokenizer.json filter=lfs diff=lfs merge=lfs -text diff --git a/README.md b/README.md new file mode 100644 index 0000000..a6315a2 --- /dev/null +++ b/README.md @@ -0,0 +1,150 @@ +--- +license: apache-2.0 +library_name: transformers +pipeline_tag: text-generation +language: + - en +base_model: google/gemma-2-2b-it +tags: + - dystrio + - sculpt + - pruned + - compressed + - efficient + - dense + - runtime-agnostic + - no-custom-kernels + - hf-drop-in + - drop-in-replacement + - smaller + - faster + - gemma +datasets: + - wikitext +model-index: + - name: Dystrio Sculpt (gemma-2-2b-it Experimental) + results: + - task: + type: text-generation + dataset: + name: WikiText-103 (validation) + type: wikitext + metrics: + - name: perplexity + type: perplexity + value: 48.9699 + - name: ppl_ratio + type: ppl_ratio + value: 1.8995 +--- + +# dystrio/gemma-2-2b-it-sculpt-experimental + +> **30% smaller, +23% faster prefill, drop-in replacement. No custom kernels. No runtime changes.** + +Dystrio Sculpt structurally compresses transformer models, producing dense models that load with standard `transformers` — no custom code, no new ops, no deployment friction. + +This is the **Experimental** tier of [gemma 2 2b it](https://huggingface.co/google/gemma-2-2b-it). + +## Quick Start + +```python +from transformers import AutoModelForCausalLM, AutoTokenizer + +model = AutoModelForCausalLM.from_pretrained("dystrio/gemma-2-2b-it-sculpt-experimental", torch_dtype="bfloat16", device_map="auto") +tokenizer = AutoTokenizer.from_pretrained("dystrio/gemma-2-2b-it-sculpt-experimental") + +inputs = tokenizer("The future of AI inference is", return_tensors="pt").to(model.device) +outputs = model.generate(**inputs, max_new_tokens=100) +print(tokenizer.decode(outputs[0], skip_special_tokens=True)) +``` + +## Benchmark Results + +All tiers compiled from [gemma 2 2b it](https://huggingface.co/google/gemma-2-2b-it) on A100 80GB, bf16: + +| Model | PPL | PPL Ratio | Weights (GB) | Chat Prefill TPS | RAG TTFT p95 (ms) | Decode TPS | +|-------|-----|-----------|-------------|------------------|-------------------|------------| +| **Baseline** | 25.7807 | 1.0 | 4.869591 | 21611.9 | 70.251 | 59.6 | +| **sculpt-default** | 20.5854 | 0.7985 | 4.441124 | 23065.3 | 69.007 | 60.0 | +| **sculpt-production** | 22.4118 | 0.8693 | 4.226891 | 23404.0 | 66.554 | 60.7 | +| **sculpt-throughput** | 29.8372 | 1.1573 | 3.969811 | 24330.1 | 64.529 | 59.3 | +| **sculpt-experimental** | 48.9699 | 1.8995 | 3.412804 | 26496.2 | 60.97 | 59.5 | + +### Key Metrics (this model) + +| Metric | Value | +|--------|-------| +| **Weights memory** | 3.412804 GB (30% smaller) | +| **PPL ratio** | 1.8995 | +| **Chat prefill TPS** | 26496.2 (+23%) | +| **RAG TTFT p95** | 60.97 ms (-13%) | +| **Decode TPS** | 59.5 (flat) | +| **Parameters** | 1.83B | + +## All Sculpt Tiers + +| Tier | HuggingFace | Size | PPL Ratio | Use Case | +|------|-------------|------|-----------|----------| +| default | [dystrio/gemma-2-2b-it-sculpt-default](https://huggingface.co/dystrio/gemma-2-2b-it-sculpt-default) | 4.441124 GB | 0.7985 | Zero-regret: quality preserved, smaller footprint | +| production | [dystrio/gemma-2-2b-it-sculpt-production](https://huggingface.co/dystrio/gemma-2-2b-it-sculpt-production) | 4.226891 GB | 0.8693 | Practical savings with modest quality tradeoff | +| throughput | [dystrio/gemma-2-2b-it-sculpt-throughput](https://huggingface.co/dystrio/gemma-2-2b-it-sculpt-throughput) | 3.969811 GB | 1.1573 | Maximum usable compression for speed/edge | +| experimental | [dystrio/gemma-2-2b-it-sculpt-experimental](https://huggingface.co/dystrio/gemma-2-2b-it-sculpt-experimental) 👈 **this model** | 3.412804 GB | 1.8995 | Boundary exploration, maximum structural compression | + +## What is Dystrio Sculpt? + +Dystrio Sculpt compiles transformer models into smaller, faster variants. Output models: + +- Are **dense** (not sparse) — standard architecture, fewer parameters +- Load with **standard HuggingFace Transformers** — no custom code needed +- Require **no custom kernels** and **no runtime changes** +- Work as a one-step compile before deployment +- Stack with quantization (AWQ, GPTQ, GGUF) for compound savings + +## Compatibility + +- ✅ HuggingFace Transformers +- ✅ vLLM +- ✅ TGI (Text Generation Inference) +- ✅ llama.cpp / GGUF conversion +- ✅ AWQ / GPTQ quantization +- ✅ Any framework that loads standard safetensors + +## Benchmark Environment + +- **GPU**: NVIDIA A100-SXM4-80GB +- **dtype**: bf16 +- **Torch**: 2.10.0+cu128 +- **Transformers**: 5.3.0 +- **Deterministic**: True +- Single-GPU, standard HuggingFace Transformers, no custom kernels. + +## Metric Definitions + +- **PPL ratio**: WikiText-103 perplexity relative to baseline. <1.0 = quality improved. +- **Prefill TPS**: Tokens per second during prompt encoding (higher = faster). +- **TTFT p95**: Time to first token at 95th percentile (lower = faster). +- **Decode TPS**: Tokens per second during generation (higher = faster). +- **Weights (GB)**: Model parameter memory (deterministic, runtime-independent). + +## Citation + +```bibtex +@misc{dystrio_sculpt_2026, + title={Dystrio Sculpt: Structural Compilation for Transformer LLMs}, + author={Dystrio}, + year={2026}, + url={https://huggingface.co/dystrio} +} +``` + +## Downstream Benchmarks (lm-eval) + +Evaluated with [lm-eval-harness](https://github.com/EleutherAI/lm-evaluation-harness) on A100-80GB, bf16, zero-shot. + +| Benchmark | Baseline | This Model | Delta | +|-----------|:--------:|:----------:|:-----:| +| ARC-Challenge | 0.5094 | 0.2645 | -0.2449 | +| HellaSwag | 0.5375 | 0.3577 | -0.1798 | +| MMLU | 0.5691 | 0.2304 | -0.3387 | +| TruthfulQA MC2 | 0.5322 | 0.5040 | -0.0282 | diff --git a/chat_template.jinja b/chat_template.jinja new file mode 100644 index 0000000..923ec25 --- /dev/null +++ b/chat_template.jinja @@ -0,0 +1,4 @@ +{{ bos_token }}{% if messages[0]['role'] == 'system' %}{{ raise_exception('System role not supported') }}{% endif %}{% for message in messages %}{% if (message['role'] == 'user') != (loop.index0 % 2 == 0) %}{{ raise_exception('Conversation roles must alternate user/assistant/user/assistant/...') }}{% endif %}{% if (message['role'] == 'assistant') %}{% set role = 'model' %}{% else %}{% set role = message['role'] %}{% endif %}{{ '' + role + ' +' + message['content'] | trim + ' +' }}{% endfor %}{% if add_generation_prompt %}{{'model +'}}{% endif %} \ No newline at end of file diff --git a/config.json b/config.json new file mode 100644 index 0000000..3345c37 --- /dev/null +++ b/config.json @@ -0,0 +1,68 @@ +{ + "architectures": [ + "Gemma2ForCausalLM" + ], + "attention_bias": false, + "attention_dropout": 0.0, + "attn_logit_softcapping": 50.0, + "bos_token_id": 2, + "cache_implementation": "hybrid", + "dtype": "bfloat16", + "eos_token_id": [ + 1, + 107 + ], + "final_logit_softcapping": 30.0, + "head_dim": 256, + "hidden_act": "gelu_pytorch_tanh", + "hidden_activation": "gelu_pytorch_tanh", + "hidden_size": 2304, + "initializer_range": 0.02, + "intermediate_size": 4864, + "layer_types": [ + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention", + "sliding_attention", + "full_attention" + ], + "max_position_embeddings": 8192, + "model_type": "gemma2", + "num_attention_heads": 8, + "num_hidden_layers": 26, + "num_key_value_heads": 4, + "pad_token_id": 0, + "query_pre_attn_scalar": 256, + "rms_norm_eps": 1e-06, + "rope_parameters": { + "rope_theta": 10000.0, + "rope_type": "default" + }, + "sliding_window": 4096, + "tie_word_embeddings": true, + "transformers_version": "5.3.0", + "use_bidirectional_attention": null, + "use_cache": true, + "vocab_size": 256000 +} diff --git a/generation_config.json b/generation_config.json new file mode 100644 index 0000000..002d333 --- /dev/null +++ b/generation_config.json @@ -0,0 +1,11 @@ +{ + "_from_model_config": true, + "bos_token_id": 2, + "cache_implementation": "hybrid", + "eos_token_id": [ + 1, + 107 + ], + "pad_token_id": 0, + "transformers_version": "5.3.0" +} diff --git a/model.safetensors b/model.safetensors new file mode 100644 index 0000000..40f912b --- /dev/null +++ b/model.safetensors @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:dbe6949d0f3375fb35666a17e03de8b30e7dd9252458962c2a32d10f4707c5c5 +size 3664504264 diff --git a/tokenizer.json b/tokenizer.json new file mode 100644 index 0000000..ea03cf9 --- /dev/null +++ b/tokenizer.json @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6994501c3d2c96eda15f5cb4d75ffd2cb41fa8e53e9cafc73db6adae158bf147 +size 34362970 diff --git a/tokenizer_config.json b/tokenizer_config.json new file mode 100644 index 0000000..eabc4ed --- /dev/null +++ b/tokenizer_config.json @@ -0,0 +1,19 @@ +{ + "backend": "tokenizers", + "bos_token": "", + "clean_up_tokenization_spaces": false, + "eos_token": "", + "extra_special_tokens": [ + "", + "" + ], + "is_local": false, + "mask_token": "", + "model_max_length": 1000000000000000019884624838656, + "pad_token": "", + "sp_model_kwargs": {}, + "spaces_between_special_tokens": false, + "tokenizer_class": "GemmaTokenizer", + "unk_token": "", + "use_default_system_prompt": false +}