Model record

gpt-oss-20b

OpenAI · Apache 2.0 · verified

Architecture Mixture of experts
Parameters 21B total / 3.6B active
Context 131,072 tokens
Deployment tier Consumer
Starting memory 14 GB
Recommended 16 GB

What this model is

OpenAI reports 21B total parameters and 3.6B active parameters per token.

The architecture is mixture of experts. Memory must hold the full weight set, while active parameters affect the speed heuristic. Experts can be offloaded to system memory, but that trades speed for capacity.

Memory and quantization

Decimal GB. The MXFP4 GGUF file is 12.11 GB; the checked GGUF repository does not publish a separate Q8 build.

Quantization Published files 8K estimate Smallest comfortable GPU Smallest comfortable Mac Context at smallest GPU / Mac Speed estimate Run commands
MXFP4 12.11 GB 13.81 GB NVIDIA GeForce RTX 4090 24GB · 24 GB VRAM Apple Mac mini M4 24GB · 24 GB unified memory 131,072 / 131,072 tokens Estimate · Fast relative class ollama run gpt-oss:20b lms get "gpt-oss-20b"@mxfp4

Estimate formula: published weight files + 0.2045 GB per 8K tokens × context / 8K + 1.5 GB runtime overhead. Sizes are decimal GB, not GiB. At 8K context, the smallest listed build is about 13.8 GB before OS and application reserve.

Conservative FP16 estimate from the public config. Alternating full-attention layers use 8 KV heads; local layers are capped by a 128-token sliding window.

Ollama tags were checked against the linked Ollama library pages on 2026-11-02. LM Studio's lms get suffix selects a file when the search results expose that exact quantization; confirm the local key with lms ls.

KV method source: https://huggingface.co/openai/gpt-oss-20b/raw/main/config.json

Speed heuristic

Not benchmarked here. The calculator labels relative speed from active parameter count only.

Active path: 3.6B parameters. This is a relative speed signal only; it is not a tokens/sec benchmark.

If the full weights do not fit in accelerator memory but do fit in system memory, the calculator marks the result as a tight CPU-offload fit. Expect substantially slower generation and verify the runtime's MoE offload support.

Runtimes

  • Ollama
  • llama.cpp
  • vLLM
ollama run gpt-oss:20b
lms get "gpt-oss-20b"@mxfp4
lms load <model-key-from-lms-ls> --gpu max --context-length 8192

License restrictions

Apache 2.0 permits commercial use and modification; retain notices and comply with the patent and termination terms.

This is a plain-language summary, not legal advice. Read the linked license before commercial deployment or redistribution.

Known issues

  • The Harmony response format is required; using an unrelated chat format can produce incorrect output.
  • OpenAI's 16 GB guidance is for the MXFP4 build and does not guarantee room for a long context.

If it does not fit, try these smaller records

These alternatives have a lower recommended memory target in the current catalog. Open each page to compare the quantization-specific fit before downloading.

4.5B effective / 8B stored

Gemma 4 E4B

Dense · starting at 8 GB

FAQ

Model-specific questions

What is the smallest local file for gpt-oss-20b?

The smallest published weight package in this record is MXFP4 at 12.11 GB. The 8K runtime estimate adds 0.20 GB of KV cache and 1.5 GB overhead, for about 13.8 GB before operating-system reserve.

How much memory do the published quantizations need at 8K?

MXFP4 about 13.8 GB at 8K. These are calculated estimates using the published weight sizes and the model's KV-cache assumption, not live memory measurements.

Which GPU and Mac configurations are comfortable for gpt-oss-20b?

Against the current catalog, the smallest configurations that clear the 20% headroom target are: MXFP4: NVIDIA GeForce RTX 4090 24GB. A larger configuration may still be preferable for longer context or faster memory bandwidth.

What is the right Ollama or LM Studio command for gpt-oss-20b?

Use the command attached to the specific quantization in the table. Ollama tags are taken from the checked Ollama library pages. For LM Studio, use lms get with the displayed quantization suffix, then load the resulting local key from lms ls with --gpu max and the desired context length.

What should I run instead if gpt-oss-20b does not fit?

Smaller catalog alternatives include Gemma 4 12B Unified, Gemma 4 E4B, Gemma 3 4B, Phi-4 Mini. Compare their quantization tables and minimum memory before choosing; a smaller parameter count does not always mean a proportionally smaller download.

Sources

This page is an independent compatibility guide, not official documentation. Verify the primary source before downloading or deploying a model.

Check a specific machine