---
library_name: mesh-llm
base_model:
- "unsloth/MiniMax-M2.5-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://github.com/Mesh-LLM/mesh-llm/raw/main/docs/mesh-llm-logo.svg" alt="Mesh LLM" width="220">
  </a>

  <h1>MiniMax-M2.5-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 **MiniMax-M2.5-UD-Q4_K_XL** across a local Mesh LLM cluster.

This package is derived from [unsloth/MiniMax-M2.5-GGUF](https://huggingface.co/unsloth/MiniMax-M2.5-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/MiniMax-M2.5-GGUF](https://huggingface.co/unsloth/MiniMax-M2.5-GGUF) |
| **Model id** | `unsloth/MiniMax-M2.5-GGUF:UD-Q4_K_XL` |
| **Family** | MiniMax |
| **Parameter scale** | not recorded |
| **Quantization** | `UD-Q4_K_XL` |
| **Layer count** | 62 |
| **Activation width** | 3072 |
| **Package size** | 122.8 GB |
| **Source file** | `UD-Q4_K_XL/MiniMax-M2.5-UD-Q4_K_XL-00001-of-00004.gguf` |
| **Package repo** | [meshllm/MiniMax-M2.5-UD-Q4_K_XL-layers](https://huggingface.co/meshllm/MiniMax-M2.5-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/MiniMax-M2.5-GGUF](https://huggingface.co/unsloth/MiniMax-M2.5-GGUF).

## Quickstart

```bash
# Run this on each machine that should contribute memory/compute.
mesh-llm serve --model "meshllm/MiniMax-M2.5-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/MiniMax-M2.5-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/MiniMax-M2.5-GGUF@main/UD-Q4_K_XL/MiniMax-M2.5-UD-Q4_K_XL-00001-of-00004.gguf` |
| **Source revision** | `main` |
| **Source SHA-256** | `df02b24aa0534e6063a7d84f53981cda8f47918989d2e9ff617cd7d111351f42` |
| **Skippy ABI** | `0.1.24` |
| **Package manifest SHA-256** | `b5b156803a3967aaf32122e6ff673a5d8de000986f87d2f9cb47e535ec5ea692` |

## What Is Included

| Artifact | Path | Contents | SHA-256 |
|---|---|---|---|
| Manifest | `model-package.json` | Package schema, source identity, checksums | `b5b156803a3967aaf32122e6ff673a5d8de000986f87d2f9cb47e535ec5ea692` |
| Metadata | `shared/metadata.gguf` | 0 tensors, 7.9 MB | `fae0851bf2b1538ce01b80ebbd084b7c0b79d305fd2c8eb54771e0d808a7327b` |
| Embeddings | `shared/embeddings.gguf` | 1 tensors, 337.6 MB | `bf1b4ae1f4919a64032172c4c3dd32ede9a984d066ad4b84369897f6401911e3` |
| Output head | `shared/output.gguf` | 2 tensors, 488.7 MB | `7beee149aee81098e9475d4bac09832d5e769670f053722856a0f24dfc16aaa7` |
| Transformer layers | `layers/layer-*.gguf` | 62 layer artifacts, 806 tensors, 122.0 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/UD-Q4_K_XL/MiniMax-M2.5-UD-Q4_K_XL-00001-of-00004.gguf" --out-dir "/tmp/meshllm-layer-job-meshllm_MiniMax-M2.5-UD-Q4_K_XL-layers-200/package"
```

## Links

- Source model: [unsloth/MiniMax-M2.5-GGUF](https://huggingface.co/unsloth/MiniMax-M2.5-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)