---
library_name: mesh-llm
base_model:
- "unsloth/gpt-oss-20b-GGUF"
pipeline_tag: text-generation
tags:
- gguf
- mesh-llm
- layer-package
- skippy
- distributed-inference
- local-inference
- openai-compatible
---

<div align="center">
  <a href="https://www.meshllm.cloud">
    <img src="https://meshllm.cloud/assets/images/jelly-logo-wordmark.png" alt="Mesh LLM" width="220">
  </a>

  <h1>gpt-oss-20b-UD-Q4_K_XL</h1>

  <p>
    <strong>Distributed GGUF inference package for Mesh LLM</strong>
  </p>

  <p>
    <a href="https://www.meshllm.cloud"><img alt="Website" src="https://img.shields.io/badge/Website-meshllm.cloud-111111?style=for-the-badge"></a>
    <a href="https://github.com/Mesh-LLM/mesh-llm"><img alt="GitHub" src="https://img.shields.io/badge/GitHub-Mesh--LLM-24292f?style=for-the-badge&logo=github"></a>
    <a href="https://discord.gg/rs6fmc63eN"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white"></a>
  </p>
</div>

GGUF layer package for running **gpt-oss-20b-UD-Q4_K_XL** across a local Mesh LLM cluster.

This package is derived from [unsloth/gpt-oss-20b-GGUF](https://huggingface.co/unsloth/gpt-oss-20b-GGUF) and keeps the original GGUF distribution split into per-layer artifacts for distributed inference.

## Highlights

| Run locally | Pool multiple machines | OpenAI-compatible | Package variant |
|---|---|---|---|
| Private inference on your hardware | Split layers across peers | Serve `/v1/chat/completions` locally | `UD-Q4_K_XL` layer package |

## Model Overview

| Property | Value |
|---|---|
| **Source model** | [unsloth/gpt-oss-20b-GGUF](https://huggingface.co/unsloth/gpt-oss-20b-GGUF) |
| **Model id** | `unsloth/gpt-oss-20b-GGUF:UD-Q4_K_XL` |
| **Family** | gpt |
| **Parameter scale** | 20b |
| **Quantization** | `UD-Q4_K_XL` |
| **Layer count** | 24 |
| **Activation width** | 2880 |
| **Package size** | 11.4 GB |
| **Source file** | `gpt-oss-20b-UD-Q4_K_XL.gguf` |
| **Package repo** | [meshllm/gpt-oss-20b-UD-Q4_K_XL-layers](https://huggingface.co/meshllm/gpt-oss-20b-UD-Q4_K_XL-layers) |

## Recommended Use

- Local and private inference with Mesh LLM.
- Multi-machine serving when the full GGUF is too large for one host.
- OpenAI-compatible chat/completions workflows through Mesh LLM's local API.

For upstream architecture details, chat template guidance, sampling recommendations, license terms, and benchmark notes, see the source model card: [unsloth/gpt-oss-20b-GGUF](https://huggingface.co/unsloth/gpt-oss-20b-GGUF).

## Quickstart

```bash
# Run this on each machine that should contribute memory/compute.
mesh-llm serve --model "meshllm/gpt-oss-20b-UD-Q4_K_XL-layers" --split
```

```bash
# Check the mesh and discover the OpenAI-compatible model name.
curl -s http://localhost:3131/api/status
curl -s http://localhost:3131/v1/models
```

```bash
# Send an OpenAI-compatible chat request.
curl -s http://localhost:3131/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "unsloth/gpt-oss-20b-GGUF:UD-Q4_K_XL",
    "messages": [{"role": "user", "content": "Write a tiny hello-world function in Rust."}],
    "max_tokens": 128
  }'
```

## Package Variant

| Property | Value |
|---|---|
| **Format** | `layer-package` |
| **Canonical source ref** | `unsloth/gpt-oss-20b-GGUF@main/gpt-oss-20b-UD-Q4_K_XL.gguf` |
| **Source revision** | `main` |
| **Source SHA-256** | `10fe673de12c20b74b8d670a9fdf0fd36b43b0a86ffc04daeb175c0a2b98c4f9` |
| **Skippy ABI** | `0.1.25` |
| **Package manifest SHA-256** | `4740dc72a0cafff0be25da7a7c80624dad27392da02b9668df0214e9b61c5135` |

## What Is Included

| Artifact | Path | Contents | SHA-256 |
|---|---|---|---|
| Manifest | `model-package.json` | Package schema, source identity, checksums | `4740dc72a0cafff0be25da7a7c80624dad27392da02b9668df0214e9b61c5135` |
| Metadata | `shared/metadata.gguf` | 0 tensors, 12.4 MB | `480835ff41f925215ad8131164b87bac6a0e961ea0864980a21bddc4550d0454` |
| Embeddings | `shared/embeddings.gguf` | 1 tensors, 599.2 MB | `30d41b9c4d3827cdf4dd0779641db2689989b5052bf329f704f3ee4d884b7f86` |
| Output head | `shared/output.gguf` | 2 tensors, 599.2 MB | `ddbd3aabab3f8fb37ffdb2c1bf77d4a8d380c1ff57719c05aa52edcc20983e7b` |
| Transformer layers | `layers/layer-*.gguf` | 24 layer artifacts, 456 tensors, 10.2 GB | `see model-package.json` |

## Validation

Generated by the Mesh LLM HF Jobs splitter from `mesh-llm` ref `main`.
Each artifact is checksummed as it is written, uploaded to this repository, and removed from the job workspace before the next artifact is produced.

```bash
skippy-model-package write-package "/source/gpt-oss-20b-UD-Q4_K_XL.gguf" --out-dir "/tmp/meshllm-layer-job-meshllm_gpt-oss-20b-UD-Q4_K_XL-layers-199/package"
```

## Links

- Source model: [unsloth/gpt-oss-20b-GGUF](https://huggingface.co/unsloth/gpt-oss-20b-GGUF)
- Mesh LLM website: [meshllm.cloud](https://www.meshllm.cloud)
- Mesh LLM: [github.com/Mesh-LLM/mesh-llm](https://github.com/Mesh-LLM/mesh-llm)
- Discord: [discord.gg/rs6fmc63eN](https://discord.gg/rs6fmc63eN)
- Package catalog: [meshllm/catalog](https://huggingface.co/datasets/meshllm/catalog)
- Package format: [layer-package-repos.md](https://github.com/Mesh-LLM/mesh-llm/blob/main/docs/specs/layer-package-repos.md)