Downloads ยท 30 days
9.3K
68% of all-time downloads
skt/A.X-K2-EAGLE3
A.X-K2-EAGLE3 is a text generation model from skt. Use it when you need the model to write or continue text. It is set up for vllm. The card lists the license as apache-2.0.
<p align="center" <a href="https://huggingface.co/collections/skt/ax-k2"๐ค Models</a | <a href="https://github.com/SKT-AI/A.X-K2"๐ฅ๏ธ Github</a | <a href="https://github.com/SKT-AI/A.X-K2/blob/main/AXK2TechReport.pdf"๏ฟฝโฆ
Downloads ยท 30 days
9.3K
68% of all-time downloads
All-time downloads
13.7K
Public
Parameters
3B
6 GB on disk
Likes
8
Public
Click a slice to open those files.
.safetensors6 GB ยท 100%
From the Hugging Face model README
A.X K2 EAGLE3 is an EAGLE3 speculative-decoding draft model for A.X K2, SK Telecom's 688B-total / 33B-active Mixture-of-Experts foundation model.
Paired with A.X K2 at its native 256K context, the draft accelerates decoding by proposing multiple candidate tokens per step that A.X K2 verifies in a single forward pass, without changing what the target model would have generated on its own. In production-traffic serving it delivers up to 1.64ร throughput and 28% lower time-per-output-token, with the largest gains at low-to-moderate concurrency.
This is a drafter-only checkpoint: it has no standalone use and is loaded automatically by vLLM alongside A.X K2 as a --speculative-config argument.
Eagle3DeepseekV2ForCausalLM, a single-layer MLA decoder that consumes three auxiliary hidden states from A.X K2's layers 2, 30, and 58 (early / middle / late signal) and combines them through a per-auxiliary-state RMSNorm (fc_norm) before the fusion layer.draft_vocab_size equals A.X K2's full 163,840-token vocabulary, so no target-to-draft ID remapping is needed at the logits boundary.| Property | Value |
|---|---|
| Architecture | Eagle3DeepseekV2 (1-layer MLA decoder) |
| Target model | skt/A.X-K2 (256K, fused attention gate) |
| Hidden size | 7168 |
| Auxiliary hidden-state layers | 2, 30, 58 (of A.X K2's 61 layers) |
| Combine-layer normalization | Per-auxiliary-state RMSNorm before fc (fc_norm: true) |
| Vocab size | 163,840 (unpruned, matches target) |
| Context length | 262,144 tokens (256K), YaRN factor 2.0 |
| Checkpoint precision | fp16 |
| Checkpoint size | ~5.6 GiB |
Recommended num_speculative_tokens | 3 |
Measured on production-representative mixed traffic (k=3, concurrency 16) against A.X K2 serving without a draft:
| Metric | Result |
|---|---|
| Throughput | 1.64ร |
| Time-per-output-token (TPOT) | โ28% (36.9 โ 26.5 ms) |
| Mean accepted length | 2.24 tokens/step |
Speedup is workload-dependent and concentrated in the memory-bandwidth-bound regime:
A.X K2 EAGLE3 is served through the same SKT-AI/vllm fork used for A.X K2 itself โ upstream vLLM v0.23.0 plus A.X K2 support:
git clone -b axk2-v0.23.0 https://github.com/SKT-AI/vllm.git
cd vllm
pip install -e . # see the vLLM docs for build prerequisites
Add a single --speculative-config argument to your existing A.X K2 serving command โ everything else stays the same:
vllm serve skt/A.X-K2 --tensor-parallel-size <N> \
--tool-call-parser hermes \
--reasoning-parser deepseek_v3 \
--speculative-config '{"method": "eagle3", "model": "skt/A.X-K2-EAGLE3", "num_speculative_tokens": 3}'
A few things worth knowing before you turn this on in production:
--data-parallel-size > 1 with async scheduling has a known upstream vLLM failure mode: if one DP rank's request exceeds the draft's usable context while a peer rank's does not, that rank skips its draft forward and drops the collectives the other ranks still issue, desynchronizing the DP group into a hang (RPC call to sample_tokens timed out; tracked upstream at vllm-project/vllm#44954). The axk2-v0.23.0 branch carries this fix, so DP deployments on the current branch do not need a workaround.A.X K2 EAGLE3 is a serving-time accelerator for A.X K2 and is released under Apache-2.0 for the same research and commercial uses as A.X K2 itself. It has no independent function outside of that pairing: use it wherever you serve A.X K2 at 256K and want lower latency at unchanged output quality.
This draft has not been validated with any target other than A.X K2 at 256K, and should not be assumed compatible with future A.X K2 variants at different context lengths or with unrelated models. All intended-use and out-of-scope guidance for A.X K2 itself applies equally here, since the draft does not change what A.X K2 generates.
For questions about A.X K2 EAGLE3 โ including compatibility, deployment, and licensing โ contact the A.X team at [email protected]. Please send reports of vulnerabilities, harmful outputs, suspected misuse, or copyright infringement claims to the same address.
If you use A.X K2 EAGLE3 in your research, please cite the A.X K2 technical report:
@techreport{axk2-2026,
title={A.X K2 Technical Report},
author={SK Telecom},
year={2026},
institution={SK Telecom},
url={https://github.com/SKT-AI/A.X-K2/blob/main/A_X_K2_Tech_Report.pdf},
}