初始化项目,由ModelHub XC社区提供模型

Model: dystrio/Llama-3.2-3B-Instruct-sculpt-default
Source: Original Platform
This commit is contained in:
ModelHub XC
2026-06-20 18:17:18 +08:00
commit cff2dd3779
8 changed files with 351 additions and 0 deletions

36
.gitattributes vendored Normal file
View File

@@ -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

150
README.md Normal file
View File

@@ -0,0 +1,150 @@
---
license: apache-2.0
library_name: transformers
pipeline_tag: text-generation
language:
- en
base_model: meta-llama/Llama-3.2-3B-Instruct
tags:
- dystrio
- sculpt
- pruned
- compressed
- efficient
- dense
- runtime-agnostic
- no-custom-kernels
- hf-drop-in
- drop-in-replacement
- smaller
- faster
- llama
datasets:
- wikitext
model-index:
- name: Dystrio Sculpt (Llama-3.2-3B-Instruct Default)
results:
- task:
type: text-generation
dataset:
name: WikiText-103 (validation)
type: wikitext
metrics:
- name: perplexity
type: perplexity
value: 17.1627
- name: ppl_ratio
type: ppl_ratio
value: 0.9678
---
# dystrio/Llama-3.2-3B-Instruct-sculpt-default
> **7% smaller, quality improved (0.9678x PPL), 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 **Default** tier of [Llama 3.2 3B Instruct](https://huggingface.co/meta-llama/Llama-3.2-3B-Instruct).
## Quick Start
```python
from transformers import AutoModelForCausalLM, AutoTokenizer
model = AutoModelForCausalLM.from_pretrained("dystrio/Llama-3.2-3B-Instruct-sculpt-default", torch_dtype="bfloat16", device_map="auto")
tokenizer = AutoTokenizer.from_pretrained("dystrio/Llama-3.2-3B-Instruct-sculpt-default")
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 [Llama 3.2 3B Instruct](https://huggingface.co/meta-llama/Llama-3.2-3B-Instruct) on A100 80GB, bf16:
| Model | PPL | PPL Ratio | Weights (GB) | Chat Prefill TPS | RAG TTFT p95 (ms) | Decode TPS |
|-------|-----|-----------|-------------|------------------|-------------------|------------|
| **Baseline** | 17.7333 | 1.0 | 5.984213 | 20742.1 | 75.219 | 74.7 |
| **sculpt-default** | 17.1627 | 0.9678 | 5.553549 | 21777.1 | 71.177 | 74.7 |
| **sculpt-production** | 21.554 | 1.2155 | 5.307455 | 22728.2 | 70.16 | 72.7 |
| **sculpt-throughput** | 26.9519 | 1.5198 | 4.999838 | 23116.0 | 69.412 | 72.3 |
| **sculpt-experimental** | 37.844 | 2.1341 | 4.446127 | 25457.5 | 68.204 | 73.1 |
### Key Metrics (this model)
| Metric | Value |
|--------|-------|
| **Weights memory** | 5.553549 GB (7% smaller) |
| **PPL ratio** | 0.9678 |
| **Chat prefill TPS** | 21777.1 (+5%) |
| **RAG TTFT p95** | 71.177 ms (-5%) |
| **Decode TPS** | 74.7 (flat) |
| **Parameters** | 2.98B |
## All Sculpt Tiers
| Tier | HuggingFace | Size | PPL Ratio | Use Case |
|------|-------------|------|-----------|----------|
| default | [dystrio/Llama-3.2-3B-Instruct-sculpt-default](https://huggingface.co/dystrio/Llama-3.2-3B-Instruct-sculpt-default) 👈 **this model** | 5.553549 GB | 0.9678 | Zero-regret: quality preserved, smaller footprint |
| production | [dystrio/Llama-3.2-3B-Instruct-sculpt-production](https://huggingface.co/dystrio/Llama-3.2-3B-Instruct-sculpt-production) | 5.307455 GB | 1.2155 | Practical savings with modest quality tradeoff |
| throughput | [dystrio/Llama-3.2-3B-Instruct-sculpt-throughput](https://huggingface.co/dystrio/Llama-3.2-3B-Instruct-sculpt-throughput) | 4.999838 GB | 1.5198 | Maximum usable compression for speed/edge |
| experimental | [dystrio/Llama-3.2-3B-Instruct-sculpt-experimental](https://huggingface.co/dystrio/Llama-3.2-3B-Instruct-sculpt-experimental) | 4.446127 GB | 2.1341 | 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.4360 | 0.3737 | -0.0623 |
| HellaSwag | 0.5329 | 0.4971 | -0.0358 |
| MMLU | 0.6223 | 0.5272 | -0.0951 |
| TruthfulQA MC2 | 0.5138 | 0.4625 | -0.0513 |

93
chat_template.jinja Normal file
View File

@@ -0,0 +1,93 @@
{{- bos_token }}
{%- if custom_tools is defined %}
{%- set tools = custom_tools %}
{%- endif %}
{%- if not tools_in_user_message is defined %}
{%- set tools_in_user_message = true %}
{%- endif %}
{%- if not date_string is defined %}
{%- if strftime_now is defined %}
{%- set date_string = strftime_now("%d %b %Y") %}
{%- else %}
{%- set date_string = "26 Jul 2024" %}
{%- endif %}
{%- endif %}
{%- if not tools is defined %}
{%- set tools = none %}
{%- endif %}
{#- This block extracts the system message, so we can slot it into the right place. #}
{%- if messages[0]['role'] == 'system' %}
{%- set system_message = messages[0]['content']|trim %}
{%- set messages = messages[1:] %}
{%- else %}
{%- set system_message = "" %}
{%- endif %}
{#- System message #}
{{- "<|start_header_id|>system<|end_header_id|>\n\n" }}
{%- if tools is not none %}
{{- "Environment: ipython\n" }}
{%- endif %}
{{- "Cutting Knowledge Date: December 2023\n" }}
{{- "Today Date: " + date_string + "\n\n" }}
{%- if tools is not none and not tools_in_user_message %}
{{- "You have access to the following functions. To call a function, please respond with JSON for a function call." }}
{{- 'Respond in the format {"name": function name, "parameters": dictionary of argument name and its value}.' }}
{{- "Do not use variables.\n\n" }}
{%- for t in tools %}
{{- t | tojson(indent=4) }}
{{- "\n\n" }}
{%- endfor %}
{%- endif %}
{{- system_message }}
{{- "<|eot_id|>" }}
{#- Custom tools are passed in a user message with some extra guidance #}
{%- if tools_in_user_message and not tools is none %}
{#- Extract the first user message so we can plug it in here #}
{%- if messages | length != 0 %}
{%- set first_user_message = messages[0]['content']|trim %}
{%- set messages = messages[1:] %}
{%- else %}
{{- raise_exception("Cannot put tools in the first user message when there's no first user message!") }}
{%- endif %}
{{- '<|start_header_id|>user<|end_header_id|>\n\n' -}}
{{- "Given the following functions, please respond with a JSON for a function call " }}
{{- "with its proper arguments that best answers the given prompt.\n\n" }}
{{- 'Respond in the format {"name": function name, "parameters": dictionary of argument name and its value}.' }}
{{- "Do not use variables.\n\n" }}
{%- for t in tools %}
{{- t | tojson(indent=4) }}
{{- "\n\n" }}
{%- endfor %}
{{- first_user_message + "<|eot_id|>"}}
{%- endif %}
{%- for message in messages %}
{%- if not (message.role == 'ipython' or message.role == 'tool' or 'tool_calls' in message) %}
{{- '<|start_header_id|>' + message['role'] + '<|end_header_id|>\n\n'+ message['content'] | trim + '<|eot_id|>' }}
{%- elif 'tool_calls' in message %}
{%- if not message.tool_calls|length == 1 %}
{{- raise_exception("This model only supports single tool-calls at once!") }}
{%- endif %}
{%- set tool_call = message.tool_calls[0].function %}
{{- '<|start_header_id|>assistant<|end_header_id|>\n\n' -}}
{{- '{"name": "' + tool_call.name + '", ' }}
{{- '"parameters": ' }}
{{- tool_call.arguments | tojson }}
{{- "}" }}
{{- "<|eot_id|>" }}
{%- elif message.role == "tool" or message.role == "ipython" %}
{{- "<|start_header_id|>ipython<|end_header_id|>\n\n" }}
{%- if message.content is mapping or message.content is iterable %}
{{- message.content | tojson }}
{%- else %}
{{- message.content }}
{%- endif %}
{{- "<|eot_id|>" }}
{%- endif %}
{%- endfor %}
{%- if add_generation_prompt %}
{{- '<|start_header_id|>assistant<|end_header_id|>\n\n' }}
{%- endif %}

40
config.json Normal file
View File

@@ -0,0 +1,40 @@
{
"architectures": [
"LlamaForCausalLM"
],
"attention_bias": false,
"attention_dropout": 0.0,
"bos_token_id": 128000,
"dtype": "bfloat16",
"eos_token_id": [
128001,
128008,
128009
],
"head_dim": 128,
"hidden_act": "silu",
"hidden_size": 3072,
"initializer_range": 0.02,
"intermediate_size": 7296,
"max_position_embeddings": 131072,
"mlp_bias": false,
"model_type": "llama",
"num_attention_heads": 24,
"num_hidden_layers": 28,
"num_key_value_heads": 8,
"pad_token_id": null,
"pretraining_tp": 1,
"rms_norm_eps": 1e-05,
"rope_parameters": {
"factor": 32.0,
"high_freq_factor": 4.0,
"low_freq_factor": 1.0,
"original_max_position_embeddings": 8192,
"rope_theta": 500000.0,
"rope_type": "llama3"
},
"tie_word_embeddings": true,
"transformers_version": "5.3.0",
"use_cache": true,
"vocab_size": 128256
}

12
generation_config.json Normal file
View File

@@ -0,0 +1,12 @@
{
"bos_token_id": 128000,
"do_sample": true,
"eos_token_id": [
128001,
128008,
128009
],
"temperature": 0.6,
"top_p": 0.9,
"transformers_version": "5.3.0"
}

3
model.safetensors Normal file
View File

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

3
tokenizer.json Normal file
View File

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

14
tokenizer_config.json Normal file
View File

@@ -0,0 +1,14 @@
{
"backend": "tokenizers",
"bos_token": "<|begin_of_text|>",
"clean_up_tokenization_spaces": true,
"eos_token": "<|eot_id|>",
"is_local": false,
"model_input_names": [
"input_ids",
"attention_mask"
],
"model_max_length": 131072,
"pad_token": "<|eot_id|>",
"tokenizer_class": "TokenizersBackend"
}