Instructions to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF", filename="Laguna-S-2.1-Q4_0_ROCMFP4_STRIX_LEAN.gguf", )
llm.create_chat_completion( messages = [ { "role": "user", "content": "What is the capital of France?" } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP # Run inference directly in the terminal: llama cli -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP # Run inference directly in the terminal: llama cli -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP # Run inference directly in the terminal: ./llama-cli -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP # Run inference directly in the terminal: ./build/bin/llama-cli -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
Use Docker
docker model run hf.co/1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
- LM Studio
- Jan
- vLLM
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-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": "1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
- Ollama
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with Ollama:
ollama run hf.co/1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
- Unsloth Studio
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF to start chatting
- Pi
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
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": "1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
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 "1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP" \ --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 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with Docker Model Runner:
docker model run hf.co/1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
- Lemonade
How to use 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP
Run and chat with the model
lemonade run user.Laguna-S-2.1-Q4_0-ROCMFP4-GGUF-Q4_0_ROCMFP
List all available models
lemonade list
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 "1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP" \
--custom-provider-id llama-cpp \
--custom-compatibility openai \
--custom-text-input \
--accept-risk \
--skip-healthRun OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"Laguna-S-2.1 β Q4_0 ROCmFP4 GGUF (experimental, Strix Halo / gfx1151)
An experimental 4-bit quantization of
poolside/Laguna-S-2.1 (118B
MoE, 1M context). Built for and validated on a single AMD Strix Halo APU -
Ryzen AI Max+ 395, gfx1151, 128 GB unified memory.
This file does not run on upstream llama.cpp, Ollama, LM Studio, or vLLM. It uses the custom
Q4_0_ROCMFP4_STRIX_LEANtensor layout and requires a ROCmFPX build as described below. Unsupported runtimes should reject the file; if a tool appears to load it anyway, do not trust the output.
Validated on
gfx1151(Strix Halo) only. On RDNA4 (gfx1201, Radeon AI PRO R9700) this artifact hung during inference in both HIP and Vulkan attempts on the test rig. Treat it as unsupported there until that's resolved. RDNA4 users should useQ4_0_ROCMFP4_FASTinstead.
Should you use this?
Use this model if all of the following are true:
- you run a Strix Halo machine (Ryzen AI Max+ 385/395,
gfx1151) with 96 GB+ of unified memory allocatable to the GPU; - you are willing to build the ROCmFPX fork from source;
- you want the fastest measured batch-1 decode for Laguna-S-2.1 on this hardware class.
Otherwise, use an ordinary K-quant GGUF such as unsloth's UD-Q4_K_XL. It runs everywhere, and on this same test machine it decodes at 29.5 t/s vs 41.5 t/s for this file.
TL;DR β measured on one Strix Halo machine
| Measure | This file | UD-Q4_K_XL (control) |
|---|---|---|
| Decode, batch 1, 564-token prompt | 41.5 t/s (41.41 / 41.45 / 41.46 across 3 runs) | 29.5 t/s |
| Prefill (cold, 564 tokens) | ~203 t/s | ~231 t/s |
| File size | 62,645,471,552 bytes (~58.3 GiB, 4.38 bpw) | 73.4 GB |
Decode is +41% over the K-quant control on identical hardware, engine
generation, sampling, and prompt. Prefill is ~12% slower at this shallow
depth. Runs used streaming chat completions with prompt caching disabled
(cold prefill every run), best-of-3. Public run:
LocalMaxxing cmryiee3u03udo401ztqz7dde.
What was NOT measured: output quality. No HumanEval, MBPP, perplexity, or KL-divergence comparison against the F16 source has been run for this artifact. The STRIX_LEAN recipe keeps attention K/V tensors and token embeddings at higher precision (Q5_K embeddings) to protect quality. But until evals are published here, treat quality parity as unverified.
What Q4_0_ROCMFP4_STRIX_LEAN actually is
A 4.38 bit-per-weight layout from the
ROCmFPX project. The bulk of the
network uses the Q4_0_ROCMFP4_FAST single-scale FP4 block layout. Attention
K/V projection tensors follow the Strix-tuned quality recipe, and token
embeddings are kept at Q5_K. The recipe was tuned on gfx1151 (ROCmFPX
PR #35, merged 2026-07-23). This is a memory-layout and kernel-path
optimization, not native FP4 matrix hardware arithmetic.
The quantization is uniform with no importance matrix.
Required runtime
git clone https://github.com/charlie12345/ROCmFPX.git
cd ROCmFPX && git checkout main # validated at commit c190e43
# Strix Halo standard build (HIP + Vulkan):
env JOBS=16 scripts/build-strix-rocmfp4-mtp.sh # -> build-strix-rocmfp4/
The test rig's HIP toolchain wasn't working, so the sealed numbers came from a Vulkan-only build:
cmake -B build-strix-vulkan -DGGML_VULKAN=ON -DCMAKE_BUILD_TYPE=Release \
-DLLAMA_BUILD_WEBUI=OFF
cmake --build build-strix-vulkan -j16 --target llama-server
Example deployment (as measured)
./build-strix-vulkan/bin/llama-server \
-m Laguna-S-2.1-Q4_0_ROCMFP4_STRIX_LEAN.gguf \
-dev Vulkan0 \
-ngl 999 \
--flash-attn on \
--jinja \
-ctk f16 -ctv f16 \
-b 512 -ub 128 -t 16 \
-np 1 \
-c 65536
-b 512 -ub 128 is a decode-oriented shape; it costs prefill throughput. For
long-prompt/agentic use, raise -ub and re-measure.
Measurement conditions
- Framework Desktop, AMD Ryzen AI Max+ 395 (Strix Halo,
gfx1151), 128 GB unified memory, Arch Linux, RADV Vulkan driver. - ROCmFPX
mainat commitc190e43; control ran the same day's upstream llama.cpp (b10103-4-gc0bc859) with the same sampling and flags apart from quant-specific paths. - Best-of-3 streaming requests,
cache_prompt: false, 564-token prompt, 256-token generation, one model resident at a time, no other GPU load.
Artifact
| Field | Value |
|---|---|
| File | Laguna-S-2.1-Q4_0_ROCMFP4_STRIX_LEAN.gguf |
| Size | 62,645,471,552 bytes |
| SHA-256 | c817ae1aae77f9b2d81910c099e0c9cff06f68e2ac7bdd9862dae14980a94efd |
| Source GGUF | laguna-s-2.1-F16.gguf from poolside/Laguna-S-2.1-GGUF, 235,202,258,240 bytes |
| Quantization | Q4_0_ROCMFP4_STRIX_LEAN, no importance matrix |
| Content | main text model only; no DFlash draft or multimodal projector |
Quantization command (ROCmFPX c190e43):
./build-r9700/bin/llama-quantize \
laguna-s-2.1-F16.gguf \
Laguna-S-2.1-Q4_0_ROCMFP4_STRIX_LEAN.gguf \
Q4_0_ROCMFP4_STRIX_LEAN \
12
Quantization was done on the R9700 build host, then the file was transferred
to Strix Halo for measurement. The build-r9700 path is just the build
directory name from that host.
Verify after download:
sha256sum -c SHA256SUMS
Limitations
- Requires the ROCmFPX fork; no upstream llama.cpp compatibility.
- Throughput-validated only. No quality evals published for this artifact yet.
- Validated on exactly one Strix Halo host, Vulkan/RADV, batch 1, shallow prompt depth. Deeper contexts, HIP on Strix, and batch >1 are unmeasured.
- Known bad on RDNA4
gfx1201(inference hang, under investigation upstream). - MoE 118B: needs ~60 GB for weights plus KV. 64 GB-class machines can't run it with meaningful context.
License and attribution
- Base model: Laguna-S-2.1, Copyright 2026 poolside, OpenMDW-1.1. This repository redistributes a converted and quantized derivative under the same license.
- Format and execution path: the
Q4_0_ROCMFP4_STRIX_LEANrepresentation and kernels are the work of the ROCmFPX project, which builds on llama.cpp. - This repository: the quantized artifact and the Strix Halo measurement.
Laguna and related marks belong to their owners. This community quantization is not affiliated with or endorsed by poolside, AMD, ROCmFPX, or llama.cpp.
- Downloads last month
- 171
4-bit
Model tree for 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF
Base model
poolside/Laguna-S-2.1
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp# Start a local OpenAI-compatible server: llama serve -hf 1337Hero/Laguna-S-2.1-Q4_0-ROCMFP4-GGUF:Q4_0_ROCMFP