Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,128 @@
+---
+library_name: mesh-llm
+base_model:
+- "unsloth/Trinity-Large-Preview-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>Trinity-Large-Preview-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 **Trinity-Large-Preview-UD-Q4_K_XL** across a local Mesh LLM cluster.
+
+This package is derived from [unsloth/Trinity-Large-Preview-GGUF](https://huggingface.co/unsloth/Trinity-Large-Preview-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/Trinity-Large-Preview-GGUF](https://huggingface.co/unsloth/Trinity-Large-Preview-GGUF) |
+| **Model id** | `unsloth/Trinity-Large-Preview-GGUF:UD-Q4_K_XL` |
+| **Family** | Trinity |
+| **Parameter scale** | not recorded |
+| **Quantization** | `UD-Q4_K_XL` |
+| **Layer count** | 60 |
+| **Activation width** | 3072 |
+| **Package size** | 230.8 GB |
+| **Source file** | `UD-Q4_K_XL/Trinity-Large-Preview-UD-Q4_K_XL-00001-of-00005.gguf` |
+| **Package repo** | [meshllm/Trinity-Large-Preview-UD-Q4_K_XL-layers](https://huggingface.co/meshllm/Trinity-Large-Preview-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/Trinity-Large-Preview-GGUF](https://huggingface.co/unsloth/Trinity-Large-Preview-GGUF).
+
+## Quickstart
+
+```bash
+# Run this on each machine that should contribute memory/compute.
+mesh-llm serve --model "meshllm/Trinity-Large-Preview-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/Trinity-Large-Preview-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/Trinity-Large-Preview-GGUF@main/UD-Q4_K_XL/Trinity-Large-Preview-UD-Q4_K_XL-00001-of-00005.gguf` |
+| **Source revision** | `main` |
+| **Source SHA-256** | `13632564d2e8a57be6a4bcde297cbecb97f5e9a40ffc06b8057877f3301b694d` |
+| **Skippy ABI** | `0.1.22` |
+| **Package manifest SHA-256** | `47046ac1365fee8e7797e23fb9d72449edea78b39429fdd15645673e24cbdc5c` |
+
+## What Is Included
+
+| Artifact | Path | Contents | SHA-256 |
+|---|---|---|---|
+| Manifest | `model-package.json` | Package schema, source identity, checksums | `47046ac1365fee8e7797e23fb9d72449edea78b39429fdd15645673e24cbdc5c` |
+| Metadata | `shared/metadata.gguf` | 0 tensors, 7.0 MB | `9ee98b39241a826751b809f398a339e1ce248c882be1aa69dd25987349a018da` |
+| Embeddings | `shared/embeddings.gguf` | 1 tensors, 336.9 MB | `0a090b2ce10bf3f42027d6cfe98fa725d2c275e518cc1de0464fe12c10709b68` |
+| Output head | `shared/output.gguf` | 2 tensors, 488.1 MB | `d9789c03eab663ee059faf1dfd1a6f2b36476f8407be5e7beece8572d8d5efe3` |
+| Transformer layers | `layers/layer-*.gguf` | 60 layer artifacts, 1110 tensors, 230.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/Trinity-Large-Preview-UD-Q4_K_XL-00001-of-00005.gguf" --out-dir "/tmp/meshllm-layer-job-meshllm_Trinity-Large-Preview-UD-Q4_K_XL-layers-198/package"
+```
+
+## Links
+
+- Source model: [unsloth/Trinity-Large-Preview-GGUF](https://huggingface.co/unsloth/Trinity-Large-Preview-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)