From bfba7e12358420fc5c03cd9b1e63f98330f66bdc Mon Sep 17 00:00:00 2001 From: ModelHub XC Date: Mon, 17 Aug 2026 16:59:17 +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: MrMeOrYou/Apertus-v1.1-4B-Instruct-GGUF Source: Original Platform --- .gitattributes | 36 +++++ Apertus-v1.1-4B-Instruct-BF16.gguf | 3 + README.md | 213 +++++++++++++++++++++++++++++ 3 files changed, 252 insertions(+) create mode 100644 .gitattributes create mode 100644 Apertus-v1.1-4B-Instruct-BF16.gguf create mode 100644 README.md diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..96c9c29 --- /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 +Apertus-v1.1-4B-Instruct-BF16.gguf filter=lfs diff=lfs merge=lfs -text diff --git a/Apertus-v1.1-4B-Instruct-BF16.gguf b/Apertus-v1.1-4B-Instruct-BF16.gguf new file mode 100644 index 0000000..69d51dd --- /dev/null +++ b/Apertus-v1.1-4B-Instruct-BF16.gguf @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:fb845a5f3f84f77c2d76bd33f4faa6ecd8165c20b45bf52e294186d34a8828cf +size 7658917248 diff --git a/README.md b/README.md new file mode 100644 index 0000000..2e6bf7a --- /dev/null +++ b/README.md @@ -0,0 +1,213 @@ +--- +license: apache-2.0 +base_model: swiss-ai/Apertus-v1.1-4B-Instruct +base_model_relation: quantized +library_name: gguf +pipeline_tag: text-generation +tags: +- gguf +- llama.cpp +- apertus +- multilingual +- conversational +- swiss-ai +- compliant +--- + +# Apertus-v1.1-4B-Instruct +> This repository contains a GGUF conversion of [swiss-ai/Apertus-v1.1-4B-Instruct](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct), created with [llama.cpp](https://github.com/ggml-org/llama.cpp). The available file is `Apertus-v1.1-4B-Instruct-BF16.gguf`, a BF16 GGUF conversion. + +![image/jpeg](https://cdn-uploads.huggingface.co/production/uploads/6639f08490b7db8dcbf1a2aa/YKux3SpTciL4O60L3Ol-6.jpeg) + +## Table of Contents + +1. [Model Summary](#model-summary) +2. [How to use](#how-to-use) +3. [Evaluation](#evaluation) +4. [Training](#training) +5. [Limitations](#limitations) +6. [Legal Aspects](#legal-aspects) + +--- + +## Model Summary + +Apertus-v1.1 is a series of highly efficient, 0.5-4B billion parameter language models designed to extend the fully-open and compliant Apertus ecosystem to highly constrained hardware environments. + +The models rely on a dense transformer architecture featuring grouped-query attention and xIELU activations. + +Instead of standard pre-training, Apertus-v1.1 models were created using pre-training distillation (PD) from the [Apertus-8B-2509](https://huggingface.co/swiss-ai/Apertus-8B-2509) teacher model. They were trained on 1.7T tokens from Phase 5 of the original Apertus data pipeline—the highest quality tier of filtered documents, code, and instruction samples without introducing any new data sources or licenses. Post-training included supervised fine-tuning (SFT) and alignment similar to that of the original Apertus. + +### Key features +- **Fully open model**: open weights + open data + full training details including all data and training recipes +- **Massively Multilingual**: 1811 natively supported languages +- **Compliant** Apertus is trained while respecting opt-out consent of data owners (even retrospectively), and avoiding memorization of training data +- **Cost-Effective Distillation**: Trained using a 90%/10% mix of KL-Divergence and label cross-entropy derived from the 8B teacher model, drastically reducing the required compute. +- **Hardware Optimized**: Specifically optimized for memory-limited scenarios like mobile and edge deployments, with quantized checkpoints available for Apple devices (MLX) in INT2, INT3, INT4, and INT6 formats. + +### Quantized Checkpoints + +This model family includes base pre-trained models and instruction-tuned models. + +For instruction-tuned models, we additionally provide high-quality quantization-aware distillation (QAD) checkpoints, obtained via the official [`qat-suite`](https://github.com/swiss-ai/qat-suite). We provide FP8 and NVFP4A16 checkpoints with vLLM inference in mind and INT3-6 checkpoints optimized for mobile usage on Apple devices. + +The full list of released checkpoints is shown below: + +| | BF16 | BF16 | FP8 | NVFP4A16 | INT3 | INT4 | INT6 | +|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:| +| | Base | Instruct | Instruct | Instruct | Instruct | Instruct | Instruct | +| **0.5B** | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct-vLLM-FP8) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct-vLLM-NVFP4A16) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct-MLX-INT3) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct-MLX-INT4) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-0.5B-Instruct-MLX-INT6) | +| **1.5B** | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct-vLLM-FP8) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct-vLLM-NVFP4A16) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct-MLX-INT3) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct-MLX-INT4) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-1.5B-Instruct-MLX-INT6) | +| **4B** | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct-vLLM-FP8) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct-vLLM-NVFP4A16) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct-MLX-INT3) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct-MLX-INT4) | [✅](https://huggingface.co/swiss-ai/Apertus-v1.1-4B-Instruct-MLX-INT6) | +| **8B** | [✅](https://huggingface.co/swiss-ai/Apertus-8B-2509) | [✅](https://huggingface.co/swiss-ai/Apertus-8B-Instruct-2509) | [✅](https://huggingface.co/swiss-ai/Apertus-8B-Instruct-2509-vLLM-FP8) | [✅](https://huggingface.co/swiss-ai/Apertus-8B-Instruct-2509-vLLM-NVFP4A16) | ❌ | [✅](https://huggingface.co/swiss-ai/Apertus-8B-Instruct-2509-MLX-INT4) | ❌ | + + +For more details refer to the original Apertus [technical report](https://arxiv.org/abs/2509.14233) and the new Apertus [distillation technical report](https://arxiv.org/abs/2605.29128). + +--- + +## How to use + +The modeling code for Apertus is available in transformers `v4.56.0` and later, so make sure to upgrade your transformers version. You can also load the model with the latest `vLLM` which uses transformers as a backend. +```bash +pip install -U transformers +``` + +```python +from transformers import AutoModelForCausalLM, AutoTokenizer + +model_name = "swiss-ai/Apertus-v1.1-4B-Instruct" +device = "cuda" # for GPU usage or "cpu" for CPU usage + +# load the tokenizer and the model +tokenizer = AutoTokenizer.from_pretrained(model_name) +model = AutoModelForCausalLM.from_pretrained( + model_name, +).to(device) + +# prepare the model input +prompt = "Give me a brief explanation of gravity in simple terms." +messages_think = [ + {"role": "user", "content": prompt} +] + +text = tokenizer.apply_chat_template( + messages_think, + tokenize=False, + add_generation_prompt=True, +) +model_inputs = tokenizer([text], return_tensors="pt", add_special_tokens=False).to(model.device) + +# Generate the output +generated_ids = model.generate(**model_inputs, max_new_tokens=32768) + +# Get and decode the output +output_ids = generated_ids[0][len(model_inputs.input_ids[0]) :] +print(tokenizer.decode(output_ids, skip_special_tokens=True)) +``` + +>[!TIP] +> We recommend setting `temperature=0.8` and `top_p=0.9` in the sampling parameters. + +--- + +## Evaluation + +**Post-Training Multilingual Evaluation:** Performance of the Apertus-v1.1 models across multilingual benchmarks compared to models in similar size classes. + +| *Model* | *Average* | MMLU | TruthfulQA | Arc | IF | LogiQA | +| :--- | :---: | :---: | :---: | :---: | :---: | :---: | +| **Apertus-v1.1-0.5B-Instruct** | 0.318 | 0.258 | 0.461 | 0.225 | 0.328 | 0.279 | +| **Apertus-v1.1-1.5B-Instruct** | 0.382 | 0.377 | 0.451 | 0.266 | 0.434 | 0.276 | +| **Apertus-v1.1-4B-Instruct** | 0.473 | 0.504 | 0.506 | 0.332 | 0.550 | 0.296 | +| **Apertus-8B-Instruct-2509** | 0.534 | 0.553 | 0.524 | 0.368 | 0.689 | 0.290 | +| EuroLLM-1.7B-Instruct | 0.291 | 0.260 | 0.433 | 0.250 | 0.222 | 0.269 | +| EuroLLM-9B-Instruct | 0.480 | 0.520 | 0.465 | 0.322 | 0.613 | 0.345 | +| gemma-3-270m-it | 0.289 | 0.242 | 0.465 | 0.215 | 0.236 | 0.205 | +| gemma-3-1b-it | 0.406 | 0.409 | 0.457 | 0.250 | 0.509 | 0.379 | +| gemma-3-4b-it | 0.497 | 0.547 | 0.492 | 0.316 | 0.635 | 0.411 | +| SmolLM2-1.7B-Instruct | 0.348 | 0.365 | 0.452 | 0.213 | 0.364 | 0.246 | +| SmolLM3-3B | 0.479 | 0.507 | 0.500 | 0.270 | 0.637 | 0.365 | +| Qwen3-0.6B | 0.401 | 0.377 | 0.464 | 0.222 | 0.541 | 0.353 | +| Qwen3-1.7B | 0.457 | 0.477 | 0.490 | 0.251 | 0.611 | 0.414 | +| Qwen3-4B | 0.521 | 0.581 | 0.497 | 0.274 | 0.733 | 0.500 | + +While Apertus-v1.1 demonstrates competitive baseline multilingual chatting performance, it may lack in specific capabilities such as advanced math and complex instruction following. + +--- + +## Training + +### Model Architecture + +**Apertus-v1.1-4B** + +* **Architecture Type:** Dense transformer decoder with grouped-query attention. +* **Layers:** 24. +* **Model Dimension:** 3072. +* **MLP Dimension:** 16384. +* **Heads (Q/KV):** 24/8. +* **Tied Embeddings:** No. +* **Activation Function:** xIELU. +* **Compute / Storage Size:** 3.8B/4.6B parameters. + +### Pre-Training Details + +* **Training Tokens:** 1.7T. +* **Optimizer:** AdEMAMix with WSD schedule and weight decay. +* **Sequence Handling:** Documents packed into chunks of 4096 tokens with cross-document attention masked. +* **Total Compute:** 2.0E22 FLOPs. + +### Software & hardware + +- **GPUs:** 64 GH200 +- **Pre-Training Distillation Framework:** [Megatron-LM](https://github.com/swiss-ai/Megatron-LM-Distill) +- **Post-Training Framework:** [posttraining](https://github.com/swiss-ai/posttraining) +- **Quantization Suite:** [qat-suite](https://github.com/swiss-ai/qat-suite) + +### Open resources +All elements used in the training process are made openly available +- **Training data reconstruction scripts:** [github.com/swiss-ai/pretrain-data](https://github.com/swiss-ai/pretrain-data) + +--- + +## Limitations + +Apertus can produce text on a variety of topics, but the generated content may not always be factually accurate, logically consistent, or free from biases present in the training data. These models should be used as assistive tools rather than definitive sources of information. Users should always verify important information and critically evaluate any generated content. + +--- + +## Legal Aspects + +The Apertus-v1.1 fully reuses the data of the original Apertus release, meaning the original data summary is representative of this release as well. + +#### EU AI Act Transparency Documentation and Code of Practice +- [Apertus_EU_Public_Summary.pdf](https://huggingface.co/swiss-ai/Apertus-70B-2509/blob/main/Apertus_EU_Public_Summary.pdf) +- [Apertus_EU_Code_of_Practice.pdf](https://huggingface.co/swiss-ai/Apertus-70B-2509/blob/main/Apertus_EU_Code_of_Practice.pdf) + +#### Data Protection and Copyright Requests +For removal requests of personally identifiable information (PII) or of copyrighted content, please contact the respective dataset owners or us directly +- llm-privacy-requests@swiss-ai.org +- llm-copyright-requests@swiss-ai.org + +#### Output Filter for PII +- Currently no output filter is provided. +- Please check this site regularly for an output filter that can be used on top of the Apertus LLM. The filter reflects data protection deletion requests which have been addressed to us as the developer of the Apertus LLM. It allows you to remove Personal Data contained in the model output. We strongly advise downloading and applying this output filter from this site every six months. + +## Contact +To contact us, please send an email to +llm-requests@swiss-ai.org + +## Citation +```bash +@misc{panferov2026apertusllmfamilyexpansion, + title={Apertus LLM Family Expansion via Distillation and Quantization}, + author={Andrei Panferov and Davit Melikidze and Martin Jaggi and Dan Alistarh}, + year={2026}, + eprint={2605.29128}, + archivePrefix={arXiv}, + primaryClass={cs.LG}, + url={[https://arxiv.org/abs/2605.29128](https://arxiv.org/abs/2605.29128)}, +} +``` +