Skip to main content
logo

documentation SpecBundle DeepWiki

github badge slack badge license

📍 Overview

SpecForge is an ecosystem project developed by the SGLang team. It is a framework for training speculative decoding models so that you can smoothly port them over to the SGLang serving framework to speed up your inference.

We have seen many open-source projects for speculative decoding, but most of them are not well-maintained or not directly compatible with SGLang. We prepared this project because we wish that the open-source community can enjoy a speculative decoding framework that is

  • regularly maintained by the SpecForge team: the code is runnable out-of-the-box
  • directly compatible with SGLang: there is no additional efforts for porting to SGLang
  • provides local offline and server-only online-disaggregated training through one runtime, including the supported data, tensor, and sequence parallel topologies

Check out our documentation to get started.

🔧 Supported Methods

Every method uses the same typed training entry point:

specforge train --config examples/configs/qwen3-8b-eagle3-disaggregated.yaml

The typed deployment.trainer topology self-launches trainer DP and EAGLE3 offline USP process groups. A single-node disaggregated config also supervises its SpecForge producer and consumer; Mooncake and SGLang remain externally managed services, and online target parallelism belongs to SGLang. There are no method-specific Python training entry points.

Method Description Example config Optimization
EAGLE3 Feature-based autoregressive drafting Online / Offline / Disaggregated offline LK loss
P-EAGLE Parallel EAGLE Online —
EAGLE3.1 Feature-based autoregressive drafting with attention drift Online —
DFlash Block-parallel drafting Online / Disaggregated D-PACE
Domino DFlash with GRU logit correction Online / Disaggregated —
DSpark Confidence-Scheduled Semi-Autoregressive Generation Disaggregated —

See the training guide for the supported method/topology matrix and the disaggregated guide for the online/offline launch workflows. Unsupported combinations are rejected during config validation or run assembly instead of falling back to an older trainer.

🚀 Accelerate with SpecBundle

SpecBundle is a collection of production-grade speculative decoding models that are released by the SpecForge team and our industry partners. They provide higher acceptance rate compared to the existing open-source checkpoints over a wide range of domains. Together with SGLang, you can experience up to 4x speedup for inference. Check out our resources below:

Item Link
📝 Documentation Link
📊 Performance Dashboard Link
🤗 Hugging Face Collection Link

🎉 News

  • [2026-08] 🎉 Released SpecBundle (phase 2) and SpecForge v0.3.0. Check out our blog at LMSYS.org
  • [2026-07] 🚀 Day0 supported two flagship dspark draft model, Inkling and Kimi-K3.
  • [2026-07] 🔥 Supported full disaggregation of training and inference in online training.
  • [2026-07] 🔥 Added DSpark online training for DFlash draft models.
  • [2026-06] 🔥 Added D-PACE as an optional loss for DFlash training.
  • [2026-06] 🔥 Added Domino online training for DFlash draft models.
  • [2026-01] 🔥 Added DFlash block-parallel online training with SGLang serving support.
  • [2025-12] 🎉 Released SpecBundle (phase 1) and SpecForge v0.2.0. Check out our blog at LMSYS.org
  • [2025-08] 🔔 SpecForge is listed as a flagship project in LMSYS. Congratulations to the SpecForge team!
  • [2025-08] 🔥 SpecForge powered the Eagle3 draft model for GPT-OSS. Check out the blog at LMSYS.org
  • [2025-07] 🔥 SpecForge is released together with Llama4-Eagle3 checkpoints. Check out our blog at LMSYS.org

✨ Acknowledgements

acknowledgements

We would like to express our sincere gratitude to the official EAGLE team, especially Hongyang Zhang and Yuhui Li, for their invaluable contributions and support. Our thanks also go to the NVIDIA team—particularly Avery H and Izzy Putterman—and to the Google team, especially Ying Wang, for their insightful discussions and generous assistance throughout the project.

We are especially grateful to Meituan for their strong backing and meaningful contributions, which played a vital role in driving this project forward.

This project has also been inspired by many outstanding open-source projects from the LLM community, including EAGLE, BaldEagle, and TensorRT-Model-Optimizer and others. Their contributions and shared knowledge have greatly benefited our work.

💡 Special Thanks to Voltage Park

We would like to extend our sincere thanks to Voltage Park, our official infrastructure partner. As part of a formal collaboration with the SGLang team, Voltage Park provided critical GPU resources that empowered us to train and evaluate large-scale speculative decoding models efficiently and reliably. This partnership was instrumental in making SpecForge possible. We deeply appreciate Voltage Park’s mission to make cutting-edge AI infrastructure more accessible, and we look forward to continued collaboration as we push the boundaries of open-source LLM serving and optimization.

📃 Citation

@article{li2026specforge,
  title={{SpecForge}: A flexible and efficient open-source training framework for speculative decoding},
  author={Li, Shenggui and Wang, Chao and Zhu, Yikai and Wang, Yubo and Yin, Fan and Shi, Shuai and Chen, Yefei and Dong, Xiaomin and Chen, Qiaoling and Pan, Jin and others},
  journal={arXiv preprint arXiv:2603.18567},
  year={2026}
}

@misc{specforge2025,
  title={SpecForge: Train speculative decoding models effortlessly},
  author={Shenggui Li, Yikai Zhu, Chao Wang, Fan Yin, Shuai Shi, Yubo Wang, Yi Zhang, Yingyi Huang, Haoshuai Zheng, Yineng Zhang},
  year={2025},
  publisher={GitHub},
  howpublished={\url{https://github.com/sgl-project/specforge}},
}

Metadata

Release files for specforge 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for specforge 0.2.0
File Size Uploaded Provenance Actions
specforge-0.2.0.tar.gz 323.4 kB With provenance Details for specforge-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for specforge 0.2.0
File Interpreter ABI Platform Actions
specforge-0.2.0-py3-none-any.whl Python 3 none any Details for specforge-0.2.0-py3-none-any.whl

Total release size: 708.6 kB

Release files / specforge-0.2.0.tar.gz

Download URL specforge-0.2.0.tar.gz
Size 323.4 kB
Tags Source
SHA-256 checksum
How to use checksums
018f679e13ba2af7cbed55ca2c652c9e29332be07cb589a604f81ad9da3f81f7
BLAKE2b-256 checksum
How to use checksums
1be7e573027e70e2440f6a3f2be9d79cd35dfe5c1b1aa2fb181b30d9187bf79d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

Release files / specforge-0.2.0-py3-none-any.whl

Download URL specforge-0.2.0-py3-none-any.whl
Size 385.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbc79517adf483c6a8beea52561b1a8c8c8a99a54c820b47d2033a73966b55b0
BLAKE2b-256 checksum
How to use checksums
3f6c4e73daa6588e76e89b66f789717b34992380b2574d855ba08a51d6fb732a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

Security for specforge 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for specforge-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page