Instructions to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF # Run inference directly in the terminal: llama cli -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF # Run inference directly in the terminal: llama cli -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF # Run inference directly in the terminal: ./llama-cli -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF # Run inference directly in the terminal: ./build/bin/llama-cli -hf EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Use Docker
docker model run hf.co/EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
- LM Studio
- Jan
- vLLM
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "EntityDeletr/EAGLE3-gpt-oss-20b-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "EntityDeletr/EAGLE3-gpt-oss-20b-GGUF", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
- Ollama
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with Ollama:
ollama run hf.co/EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
- Unsloth Studio
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for EntityDeletr/EAGLE3-gpt-oss-20b-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for EntityDeletr/EAGLE3-gpt-oss-20b-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for EntityDeletr/EAGLE3-gpt-oss-20b-GGUF to start chatting
- Docker Model Runner
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with Docker Model Runner:
docker model run hf.co/EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
- Lemonade
How to use EntityDeletr/EAGLE3-gpt-oss-20b-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Run and chat with the model
lemonade run user.EAGLE3-gpt-oss-20b-GGUF-{{QUANT_TAG}}List all available models
lemonade list
- Atomic Chat
Quantized version of nebius/EAGLE3-gpt-oss-20b.
Their model card is pasted as is below.
Files:
- model.safetensors - original unquantized safetensors
- model.gguf - unquantized bf16 GGUF
- EAGLE3-gpt-oss-20b.gguf - GGUF quantized to Q5_K_M
Model Description
This is an EAGLE-3 draft-model for gpt-oss-20b, trained from scratch using LK losses — training objectives that directly target acceptance rate rather than using KL divergence as a proxy.
Training Details
- Base model: openai/gpt-oss-20b
- Draft architecture: EAGLE-3
- Training data: Infinity-Instruct-0625 with gpt-oss-20b generated responses
- Training objective: Hybrid LK loss with adaptive λ scheduling (η=3)
- Training: 10 epochs from random initialization
- Draft length: K = 6 speculative tokens
Performance
Average acceptance length (τ) measured across MT-bench, HumanEval, and GSM8K with K = 7:
| Configuration | Temperature = 0 | Temperature = 1 |
|---|---|---|
| EAGLE-3 + KL | 3.46 | 3.17 |
| EAGLE-3 + LK (ours) | 3.49 | 3.29 |
Comparison with Public Checkpoints
| Model | MT-bench (τ) | HumanEval (τ) | GSM8K (τ) |
|---|---|---|---|
| RedHatAI/gpt-oss-20b-speculator.eagle3 | 2.63 | 2.43 | 3.00 |
| Ours | 3.20 | 3.01 | 3.65 |
Measured at temperature = 1 with K = 7
Note: Earlier vLLM versions sampled draft tokens greedily regardless of temperature, which underestimated acceptance rates at temperature > 0. Stochastic draft sampling was introduced in v0.18.0, and from v0.21.0 it can be enabled via
speculative_configusingrejection_sample_methodanddraft_sample_method. The acceptance metrics reported above were measured under standard rejection sampling and are reproducible with the configuration below.
Usage with vLLM
from vllm import LLM, SamplingParams
llm = LLM(
model="openai/gpt-oss-20b",
speculative_config={
"method": "eagle3",
"model": "nebius/EAGLE3-gpt-oss-20b",
"num_speculative_tokens": 6,
"rejection_sample_method": "standard",
"draft_sample_method": "gumbel",
},
)
sampling_params = SamplingParams(temperature=0.7)
outputs = llm.generate(["Explain speculative decoding in simple terms."], sampling_params)
License
Citation
@misc{samarin2026lklosses,
title = {LK Losses: Direct Acceptance Rate Optimization for Speculative Decoding},
author = {Alexander Samarin and Sergei Krutikov and Anton Shevtsov and Sergei Skvortsov and Filipp Fisin and Alexander Golubev},
year = {2026},
eprint = {2602.23881},
archivePrefix = {arXiv},
primaryClass = {cs.LG},
url = {https://arxiv.org/abs/2602.23881}
}
- Downloads last month
- 137
Model tree for EntityDeletr/EAGLE3-gpt-oss-20b-GGUF
Base model
nebius/EAGLE3-gpt-oss-20b