Instructions to use nebius/EAGLE3-gpt-oss-120b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use nebius/EAGLE3-gpt-oss-120b with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="nebius/EAGLE3-gpt-oss-120b")# Load model directly from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("nebius/EAGLE3-gpt-oss-120b") model = AutoModelForCausalLM.from_pretrained("nebius/EAGLE3-gpt-oss-120b") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use nebius/EAGLE3-gpt-oss-120b with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "nebius/EAGLE3-gpt-oss-120b" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nebius/EAGLE3-gpt-oss-120b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/nebius/EAGLE3-gpt-oss-120b
- SGLang
How to use nebius/EAGLE3-gpt-oss-120b with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "nebius/EAGLE3-gpt-oss-120b" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nebius/EAGLE3-gpt-oss-120b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "nebius/EAGLE3-gpt-oss-120b" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "nebius/EAGLE3-gpt-oss-120b", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use nebius/EAGLE3-gpt-oss-120b with Docker Model Runner:
docker model run hf.co/nebius/EAGLE3-gpt-oss-120b
Model Description
This is an EAGLE-3 draft-model for gpt-oss-120b, 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-120b
- Draft architecture: EAGLE-3
- Training data: Infinity-Instruct-0625 with gpt-oss-120b 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 | 2.76 | 2.46 |
| EAGLE-3 + LK (ours) | 2.81 | 2.65 |
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-120b",
speculative_config={
"method": "eagle3",
"model": "nebius/EAGLE3-gpt-oss-120b",
"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
- 252
Dataset used to train nebius/EAGLE3-gpt-oss-120b
Collection including nebius/EAGLE3-gpt-oss-120b
Paper for nebius/EAGLE3-gpt-oss-120b
Evaluation results
- Acceptance Length on MT-Benchself-reported2.690
- Acceptance Length on GSM8Kself-reported2.810
- Acceptance Length on HumanEvalself-reported2.440