Eagle 3.1: Collaboration Between the EAGLE Team, vLLM Team, and TorchSpec Team
Recorded: May 26, 2026, 1:15 p.m.
| Original | Summarized |
EAGLE 3.1: Advancing Speculative Decoding Through Collaboration Between the EAGLE Team, vLLM, and TorchSpec | vLLM BlogMenuSearch DocsDocumentationBlogEventsContactCommunityGitHubThemeDocsBlogEventsContactCommunitySearch⌘JBlogEAGLE 3.1: Advancing Speculative Decoding Through Collaboration Between the EAGLE Team, vLLM, and TorchSpecMay 26, 20264 min readEAGLE Team, vLLM Team, and TorchSpec Team#speculative-decoding#performanceEAGLE 3.1 InnovationsEAGLE 3.1 Training with TorchSpecEAGLE 3.1 Integration with vLLMOpen-Source Collaboration Across the EcosystemTable of ContentsThe EAGLE series — including EAGLE 1, EAGLE 2, and EAGLE 3 — has become one of the most widely adopted and practically deployed families of speculative decoding algorithms across both research and production systems. FC normalization after each target hidden state and before the FC layer Intuitively, the post-norm design makes the method behave more like recursively invoking the drafter across decoding steps, rather than simply appending additional layers to the target model. Better training-time to inference-time extrapolation In long-context workloads, EAGLE 3.1 achieves up to 2× longer acceptance length compared with EAGLE 3. FC normalization support At the same time, backward compatibility with existing EAGLE 3 checkpoints is fully preserved. As a result, EAGLE 3.1 draft models can be plugged directly through the same speculative-decoding code path, for example: |
The EAGLE team, alongside the vLLM team and the TorchSpec team, jointly introduce EAGLE 3.1, representing a significant advancement in the robustness, efficiency, and deployability of speculative decoding algorithms. This development addresses performance fragility observed in speculative decoding, which often degrades when encountering variations in chat templates, long-context inputs, or out-of-distribution system prompts. The EAGLE team identified the root cause of this fragility as a phenomenon termed attention drift, where increasing speculation depth causes the drafter to shift its attention away from sink tokens toward its own generated tokens. This instability arose from two underlying issues: an imbalance in the fused input representation as higher-layer hidden states began to dominate the drafter input, and the growth in hidden-state magnitude across speculation steps due to the unnormalized residual path. To resolve these issues and enhance stability across diverse deployment scenarios, EAGLE 3.1 incorporates two key architectural improvements. First, it implements FC normalization after each target hidden state and before the subsequent FC layer. Second, it feeds the resulting post-normalized hidden states into the next decoding step. This post-normalized design is intended to make the method behave more like recursively invoking the drafter across decoding steps, rather than simply stacking additional layers onto the target model. These changes have resulted in demonstrably improved robustness, including better training-time to inference-time extrapolation, stronger long-context robustness, increased resilience to variations in chat templates and system prompts, and more stable acceptance lengths across various serving environments. In long-context workloads specifically, EAGLE 3.1 demonstrated the capability to achieve up to two times longer acceptance lengths compared to the previous EAGLE 3 model. TorchSpec has provided efficient training support for EAGLE 3.1 and future speculative decoding algorithms, streamlining the experimentation workflows and reducing training overhead. Furthermore, leveraging both TorchSpec and vLLM, the teams trained and open-sourced an EAGLE 3.1 draft model for the Kimi K2.6, serving as a practical example of deploying EAGLE 3.1 with TorchSpec training and vLLM serving support. The EAGLE 3.1 architecture is integrated into vLLM as a configuration-driven extension of the existing EAGLE 3 implementation. This integration includes support for FC normalization, post-norm hidden-state feedback, and the removal of hardcoded assumptions regarding target hidden states. Crucially, backward compatibility with existing EAGLE 3 checkpoints is fully preserved, allowing EAGLE 3.1 draft models to be plugged directly into the same speculative-decoding code path within vLLM. This seamless integration is demonstrated through the ability to upgrade draft models in production vLLM serving environments smoothly. The support has been incorporated into the main branch of vLLM and will be available in nightly releases and the upcoming v0.22.0 release. Benchmarking the Kimi K2.6 EAGLE 3.1 draft model on Kimi-K2.6-NVFP4 using vLLM yielded a 2.03 times higher per-user output throughput at concurrency level one, with the speedup remaining meaningful as concurrency increased, showing a 1.71 times speedup at concurrency four and 1.66 times at concurrency sixteen on the SPEED-Bench coding dataset. This collaboration exemplifies open-source synergy, combining algorithmic research from EAGLE, production system optimization from vLLM, and efficient training infrastructure from TorchSpec to advance token efficiency within the broader LLM ecosystem. |