Skip to content

[docs] Eagle3 qwen3 draft model support#24977

Merged
ggerganov merged 5 commits into
ggml-org:masterfrom
kashif:eagle3-qwen3
Jun 25, 2026
Merged

[docs] Eagle3 qwen3 draft model support#24977
ggerganov merged 5 commits into
ggml-org:masterfrom
kashif:eagle3-qwen3

Conversation

@kashif

@kashif kashif commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Overview

This pull request adds support for the EAGLE-3 draft model format in the speculative decoding system. The changes include updating model mappings, import lists, and documentation to describe how to use EAGLE-3 as a draft model for speculative decoding.

Support for EAGLE-3 draft models:

  • Added "Eagle3LlamaForCausalLM" to the model type mapping in conversion/__init__.py to recognize EAGLE-3 draft models as Llama-based.
  • Included "Eagle3LlamaForCausalLM" in the import list of supported models in conversion/llama.py.

Documentation updates:

  • Added a new section in docs/speculative.md describing EAGLE-3 draft model usage, conversion steps, and compatibility with existing formats.
  • Updated the command-line help in docs/speculative.md to include draft-eagle3 as a valid --spec-type option.

Additional information

Requirements

@kashif kashif requested a review from CISC as a code owner June 24, 2026 15:48
@github-actions github-actions Bot added documentation Improvements or additions to documentation python python script changes labels Jun 24, 2026
@CISC

CISC commented Jun 24, 2026

Copy link
Copy Markdown
Member

cc/ @ruixiang63 Review please. :)

@ruixiang63 ruixiang63 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for updating this! I left some comments and overall looks good to me.
Please also add eagle3 in --spec-type section: https://github.com/kashif/llama.cpp/blob/5e579af58657e73aa44d484168da5fa2b492fe62/docs/speculative.md#--spec-type-type

Comment thread docs/speculative.md Outdated
Comment thread docs/speculative.md
Comment thread docs/speculative.md
@ruixiang63

Copy link
Copy Markdown
Member

LGTM. cc @CISC

@CISC CISC added the merge ready A maintainer can use this label to indicate that they consider the changes final and ready to merge. label Jun 25, 2026
@ggerganov ggerganov merged commit e8ecce5 into ggml-org:master Jun 25, 2026
5 checks passed
papamoose pushed a commit to papamoose/llama.cpp that referenced this pull request Jun 27, 2026
* eagle3: accept Eagle3LlamaForCausalLM draft checkpoints

* docs: add eagle3 speculative decoding section

* docs: address eagle3 review comments

* docs: add more angelslim eagle3 models

* docs: add gpt-oss eagle3 models and link to pr 18039
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation merge ready A maintainer can use this label to indicate that they consider the changes final and ready to merge. python python script changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants