Instructions to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-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 steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
# Run inference directly in the terminal:
llama cli -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
# Run inference directly in the terminal:
llama cli -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

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 steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
# Run inference directly in the terminal:
./llama-cli -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

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 steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
# Run inference directly in the terminal:
./build/bin/llama-cli -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Use Docker

docker model run hf.co/steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

LM Studio
Jan

vLLM

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Ollama
How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with Ollama:
```
ollama run hf.co/steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
```

Unsloth Studio

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-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 steampunque/Llama-4-Scout-17B-16E-Instruct-MP-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 steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF to start chatting

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Configure the model in Pi

# Install Pi:
npm install -g @mariozechner/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Hermes Agent new

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Run Hermes

hermes

Atomic Chat new

OpenClaw new

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with OpenClaw:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Configure OpenClaw

# Install OpenClaw:
npm install -g openclaw@latest
# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

Run OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

Docker Model Runner
How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with Docker Model Runner:
```
docker model run hf.co/steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H
```

Lemonade

How to use steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF:Q2_K_H

Run and chat with the model

lemonade run user.Llama-4-Scout-17B-16E-Instruct-MP-GGUF-Q2_K_H

List all available models

lemonade list

Mixed Precision GGUF layer quantization of Llama-4-Scout-17B-16E-Instruct by meta-llama

Original model: https://huggingface.co/meta-llama/Llama-4-Scout-17B-16E-Instruct

The hybrid quant employs different quantization levels on a per layer basis to enable both high performance and small file size at the same time. This particular quant achieves a ~50G gguf with the same perplexity as a ~60G IQ4_XS gguf. The quants employed are all K to avoid slow CPU processing of IQ quants, and they range from Q3_K_S at early layers to a final layer which may be specified by the quant name. In this case the final layer is Q4_K_M so the quant is called Q4_K_H. Note there is no unique Q4_K_H quant since the selections of quantizations to use as a function of layer are arbitrary. For this file the layer quants are as follows:

embed  : Q3_K
0..7   : Q3_K_S
8..23  : alt Q3_K_M Q3_K_S
24..44 : Q3_K_M
45     : Q3_K_L
46     : Q4_K_S
47     : Q4_K_M
output : Q5_K

These quants were select based on combined subjective and objective performance evaluations to give both high performance and moderate file size.

A slightly smaller version of this model is now available which intentionally drops to Q2_K on alternate deep layers to add a small controlled amount of extra nonlinearity and possibly help boostrap better generation creativity for vision mode. It is named Q4_V_H (V=Vision, but it does not have to be used for vision it will work for text only input also) to distinguish it from Q4_K_H. This quant has the side benefit of just fitting under 50G split threshold size so only one file need be downloaded to run it. For this file the layer quants are as follows:

embed  : Q3_K
0..7   : alt Q3_K_S Q2_K
8..23  : alt Q3_K_M Q3_K_S
24..44 : Q3_K_M
45     : Q3_K_L
46     : Q4_K_S
47     : Q4_K_M
output : Q5_K

A second smaller quant is also available with predominant Q3_K_S across layers as follows:

(layer distribution updates : v2 5/5/25, v3 5/6/25)

embed  : Q3_K
0..15  : alt Q3_K_S Q2_K
16..38 : Q3_K_S
39..45 : Q3_K_M
46     : Q3_K_L
47     : Q4_K_S
output : Q5_K

This quant reduces file size to 46.6G while maintaining perplexity (10.2) at the same level as a homogenous Q3_K_M quant with ~5G smaller file.

A third quant is also available making heavier use of Q2_K as follows:

embed  : Q3_K
0..15  : alt Q2_K Q2_K_S
16..23 : Q2_K
24..31 : alt Q3_K_S Q2_K
32..43 : Q3_K_S
44..47 : Q3_K_M
output : Q5_K

This quant reduces file size to 42.8 while maintaining good perplexity (10.47) close to homogenous Q3_K_M while being 9G smaller and exhibits no generation artifacts (nonsense words or completing words with chinese characters randomly) across a wide range of test promps.

Comparison:

Quant	size	PPL	Comment
Q2_K	39.6	11.4	many generation artifacts, nonsense words, completes words with chinese tokens randomly
Q2_K_H	42.8e9	10.4	no generation artifacts, no nonsense words, very close to Q3_K_M perplexity
Q3_K_M_3_5	51.6e9	10.2	Q3_K_M with Q5_K output layer
Q3_K_H	46.6e9	10.2	Hybrid quant with Q5_K output layer, Q3_K_M perplexity
Q4_V_H	49.8e9	9.54	Q4_K_H with alt Q2_K on deepest layers for extra early stage nonlinearity
Q4_K_H	50.4e9	9.54	Hybrid quant with Q5_K output layer, IQ4_XS perplexity
IQ4_XS	59.9e9	9.57	IQ4_XS with default embed/output layer

Usage Notes:

This model can be run on a computer with 64G RAM using combined CPU and a single GPU. The Q2_K_H model might be able to run on a 48G RAM machine but the Q3_K_H and Q4_K_H quants almost certainly won't without either partial offload to a high VRAM GPU or making use of disk swap offload.

A good setup is to offload all model layers to GPU and all non-shared expert FFN tensors to CPU by specifying the override tensor flag: -ot exps=CPU as discussed here : https://github.com/ggml-org/llama.cpp/discussions/13154 This will open up around 45k of KV cache memory on a 12G VRAM GPU at q8_0 KV precision and run around 10t/s on a decent CPU. Note flash attention is needed to run q8_0 KV. To speed up prompt processing under this configuration x2 to x10 you can also either force ubatch (-u) to 16 or use the new --no-op-offload switch added in https://github.com/ggml-org/llama.cpp/pull/13386.

Update: tests on my HW (9900k CPU + 4070 GPU) show that both --no-op-offload and -ubatch 16 are not effective as of llama.cpp b5379.

without --no-op-offload,  ubatch 128
PP=30.856730699382798 TG=9.233060062734445   *best PP and TG config*
with --no-op-offload, ubatch 128
PP=25.74042603622643 TG=8.349090673295033
without --no-op-offload, -ubatch 16
PP=21.448615670596926 TG=9.234865287491097

Therefore it will be necessary to experiment with these flags to determine best settings on different HW configs.

At version b5237 and above, a change was made to llama.cpp flash attention code which is generating an apparent loss of precision in attention layer computation of around 1 to 3bits, causing higher numerical noise and degraded performance. The generations will still function, but for highest performance it may be necessary to turn flash attention off and run with a F16 KV until / if this problem is resolved. Discussion on llama.cpp issue tracker at : https://github.com/ggml-org/llama.cpp/issues/13287

Image capability:

As of llama.cpp b5423 vision capability has been added to llama 4: https://github.com/ggml-org/llama.cpp/pull/13282 . To run vision mode follow the docs in the mtmd readme in the tools directory of the source tree https://github.com/ggml-org/llama.cpp/blob/master/tools/mtmd/README.md . Basically all that is needed is to generate a "mmproj" file for Llama scout, and then it can be tested with the cli. Preliminary testing shows performance to be excellent (ignore the warning about degraded vision mode of Llama 4 when the model loads, it works extremely well over a wide range of test cases I have run). For convenience the mmproj file is made available in this model repository also.

Download the file from below:

Link	Type	Size/e9 B	Notes
Llama-4-Scout-17B-16E-Instruct.Q2_K_H.gguf	Q2_K_H	42.8e9 B	Good quality
Llama-4-Scout-17B-16E-Instruct.Q3_K_H.gguf	Q3_K_H	46.6e9 B	Solid quality
Llama-4-Scout-17B-16E-Instruct.Q4_K_H.gguf	Q4_K_H	50.4e9 B	Excellent quality
Llama-4-Scout-17B-16E-Instruct.Q4_V_H.gguf	Q4_V_H	49.8e9 B	Extra deep layer nonlinearity for vision mode
Llama-4-Scout-17B-16E-Instruct.mmproj	mmproj	1.75e9 B	multimedia projector for vision mode

A discussion thread about the hybrid quant approach can be found here on the llama.cpp git repository:

https://github.com/ggml-org/llama.cpp/discussions/13040

Downloads last month: 124

GGUF

Model size

108B params

Architecture

llama4

Hardware compatibility

2-bit

View +1 variant

Model tree for steampunque/Llama-4-Scout-17B-16E-Instruct-MP-GGUF

Base model

meta-llama/Llama-4-Scout-17B-16E

Finetuned

meta-llama/Llama-4-Scout-17B-16E-Instruct

Quantized

(38)

this model