Instructions to use RalphLabsAI/ralph-crowns with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use RalphLabsAI/ralph-crowns 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 RalphLabsAI/ralph-crowns # Run inference directly in the terminal: llama cli -hf RalphLabsAI/ralph-crowns
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf RalphLabsAI/ralph-crowns # Run inference directly in the terminal: llama cli -hf RalphLabsAI/ralph-crowns
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf RalphLabsAI/ralph-crowns # Run inference directly in the terminal: ./build/bin/llama cli -hf RalphLabsAI/ralph-crowns
Use Docker
docker model run hf.co/RalphLabsAI/ralph-crowns
- Llama new
- LM Studio
- Jan
- vLLM
How to use RalphLabsAI/ralph-crowns with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "RalphLabsAI/ralph-crowns" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "RalphLabsAI/ralph-crowns", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/RalphLabsAI/ralph-crowns
- Ollama
How to use RalphLabsAI/ralph-crowns with Ollama:
ollama run hf.co/RalphLabsAI/ralph-crowns
- Unsloth Desktop
- Docker Model Runner
How to use RalphLabsAI/ralph-crowns with Docker Model Runner:
docker model run hf.co/RalphLabsAI/ralph-crowns
- Lemonade
How to use RalphLabsAI/ralph-crowns with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull RalphLabsAI/ralph-crowns
Run and chat with the model
lemonade run user.ralph-crowns-{{QUANT_TAG}}List all available models
lemonade list
- Atomic Chat
File size: 9,933 Bytes
6d9ad7e 7a52d74 6d9ad7e 7a52d74 6d9ad7e f0bc04f 6d9ad7e 98eb618 6d9ad7e 98eb618 6d9ad7e 98eb618 6d9ad7e f0bc04f 6d9ad7e f0bc04f 4c8eb57 2051bba 4c8eb57 f0bc04f 6d9ad7e f0bc04f 2051bba f0bc04f 6d9ad7e f0bc04f 6d9ad7e f0bc04f 6d9ad7e f0bc04f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 | ---
license: apache-2.0
library_name: gguf
pipeline_tag: text-generation
base_model: Qwen/Qwen3-8B
tags: [gguf, conversational, qwen3, quantized, compression, bittensor]
---
<p align="center">
<img src="https://raw.githubusercontent.com/RalphLabsAI/ralph/main/docs/assets/ralph-banner.png"
alt="Ralph — open model compression on Bittensor SN40" width="100%">
</p>
# The same model. Small enough for your phone.
### Ralph crowns — Qwen3-8B compressed in public
**Four downloadable GGUFs, from 1.16 GB to 4.61 GB. One admitted Qwen3-8B architecture. Fewer
bits. Each file holds a current bit-tier crown in Ralph, the open model-compression tournament on
Bittensor SN40.**
“Same model” means the same admitted architecture and parameter structure—not identical weights,
guaranteed identical behavior, or universal phone compatibility. The files are published together
so users have one stable place to download the current crowns, while the source builders and exact
scored revisions remain visible.
## Start here: the 2.94 GB sub2 crown
`ralph-qwen3-8b-sub2.gguf` is the first file we recommend for a phone test.
| | |
|---|---|
| Exact size | 2,937,263,168 bytes (2.94 GB decimal) |
| Code bits / weight | 2.2626 |
| Crowned | Round 7 |
| Embedded chat-template key | Yes |
| SHA-256 | `9c45bf0ac486e793bd761a99ce4b9d965ec12e70f2d420e02af16797c71f6b50` |
```bash
hf download RalphLabsAI/ralph-crowns ralph-qwen3-8b-sub2.gguf --local-dir ./ralph-crowns
llama-cli -m ./ralph-crowns/ralph-qwen3-8b-sub2.gguf -cnv --jinja -p "Explain one practical use of low-bit quantization."
```
### Find it in PocketPal
1. Open **Models → Add from Hugging Face**.
2. Search for **RalphLabsAI**, then open **ralph-crowns**.
3. Choose **ralph-qwen3-8b-sub2.gguf**.
<!-- ralph:managed:physical-iphone-receipts:begin -->
## Physical-iPhone device lab
**[Join Device Lab #1 — share a success or failure](https://huggingface.co/RalphLabsAI/ralph-crowns/discussions/3).**
These are Ralph team-authored tests. Add your own device, app version, settings,
and result to the pinned discussion; a failed load is useful evidence too.
One configured 2.94 GB Round 7 sub2 crown completed the same normal PocketPal
chat on four physical cloud iPhones through the local llama.cpp Metal runtime.
| Physical device | OS | Normal PocketPal chat | TTFT |
|---|---|---:|---:|
| iPhone 15 | iOS 26.6 | 10.58 tok/s | 838 ms |
| iPhone 16 | iOS 18.6 | 12.36 tok/s | 439 ms |
| iPhone 17 | iOS 26.6 | 16.77 tok/s | 427 ms |
| iPhone 17 Pro Max | iOS 26.6 | 18.54 tok/s | 400 ms |
[Watch the 30-second matrix](https://huggingface.co/datasets/RalphLabsAI/ralph-device-lab/resolve/7f5f1cfbf7882726a6c55a1d9b2f7c0ff06b3da8/social/ralph-sub2-four-physical-iphones-horizontal.mp4) ·
[Inspect all four raw receipts](https://huggingface.co/datasets/RalphLabsAI/ralph-device-lab/tree/7f5f1cfbf7882726a6c55a1d9b2f7c0ff06b3da8) ·
[Verify the public payload](https://huggingface.co/datasets/RalphLabsAI/ralph-device-lab/blob/7f5f1cfbf7882726a6c55a1d9b2f7c0ff06b3da8/SHA256SUMS)
Test configuration: PocketPal 1.17.3 (147), context 2,048, fixed prompt,
one connected session per device. The expected model digest was verified
against Ralph's local mirror, not computed on-device. Every device displayed
PocketPal's **Memory tight** warning and nevertheless loaded and completed the
prompt.
> Physical BrowserStack devices; connected test. BrowserStack re-signing strips
> PocketPal's increased-memory and extended-virtual-addressing entitlements, so
> these are local-Metal backend/throughput observations—not App Store
> memory-fit, offline, universal-compatibility, or broad-quality certification.
> The dataset includes full settings, exact responses, screenshots, checksums,
> and untouched recordings.
<!-- ralph:managed:physical-iphone-receipts:end -->
## Current crowns — through Round 7
| File | Tier | Code bits / weight | Exact size | Crown status | Retention at crown | Builder | Chat-template key |
|---|---|---:|---:|---|---:|---|---|
| `ralph-qwen3-8b-binary.gguf` | binary | 1.0 | 1,158,964,160 B | New in Round 7 | 0.263616 | [ArizonaZZZ](https://huggingface.co/ArizonaZZZ) | No |
| `ralph-qwen3-8b-ternary.gguf` | ternary | 1.714 | 2,477,212,736 B | Crowned in Round 5; held in Round 7 | 0.253732 | [tensor-tailor](https://huggingface.co/tensor-tailor) | Yes |
| `ralph-qwen3-8b-sub2.gguf` | sub2 | 2.2626 | 2,937,263,168 B | New in Round 7 | 0.282457 | [boweizh1204](https://huggingface.co/boweizh1204) | Yes |
| `ralph-qwen3-8b-sub4.gguf` | sub4 | 4.0 | 4,614,304,896 B | New in Round 7 | 0.320923 | [boweizh1204](https://huggingface.co/boweizh1204) | Yes |
### Exact checksums
```text
05c568169fc180067172cbdd38c1a9f5c249a556ffdef1dacd7172bad40fab58 ralph-qwen3-8b-binary.gguf
c643cb42575a7a85b7518fd935973202c5686db270ef8b593afa8616a986154a ralph-qwen3-8b-ternary.gguf
9c45bf0ac486e793bd761a99ce4b9d965ec12e70f2d420e02af16797c71f6b50 ralph-qwen3-8b-sub2.gguf
b2ec80dce90258bbe9555a67983dea595d91f35cae48ca0d54c714eae8100edf ralph-qwen3-8b-sub4.gguf
```
The same filenames, byte counts, hashes, pinned sources, and chat-template flags are available in
[`crowns.json`](./crowns.json).
## What the crown means
Ralph retention is a within-protocol compression-fidelity measurement: it measures how closely an
artifact reproduces the pinned comparison parent's effect on configured judge models, including
the protocol's live language/depth floors. It is **not** a general capability benchmark, an
intelligence percentage, or evidence of device speed.
Round 7 uses three recorded judges and a fresh public exam. A challenger takes a crown only through
the protocol's recorded point-estimate margin or persistence path and must satisfy the per-judge
floor rule. A positive paired-bootstrap lower bound can affect the candidate weight vector without
changing the crown.
- [Round 7 signed record](https://huggingface.co/datasets/RalphLabsAI/ralph-v2-rounds/resolve/main/rounds/round-00000007-f42ae20c6ed2a796.json)
- [Round 5 record that crowned the current ternary](https://huggingface.co/datasets/RalphLabsAI/ralph-v2-rounds/resolve/main/rounds/round-00000005-25e6fd0528a93e74.json)
- [Ralph protocol and verifier](https://github.com/RalphLabsAI/ralph)
## Provenance
The crown publisher fetches the miner's full behavior-affecting package at the **pinned revision**
in the round record and recomputes its content hash. It mirrors the GGUF only when that hash matches
the record's `model_id`; the GGUF is uploaded without conversion or repacking.
For this release, the source owners subsequently added artifact-level Apache-2.0 declarations and
notices. Hugging Face LFS metadata was checked again on 2026-09-14: every current source GGUF, scored
revision, and mirrored file has the same SHA-256 shown above. The documentation commits did not
change the models.
Credit for the weights belongs to the builders named above and the miner hotkeys recorded in
`crowns.json`. Ralph provides a content-verified mirror and tournament record; it is not the origin
of the weights.
Admission checks architecture and tensor shapes against `Qwen/Qwen3-8B`. They do not
cryptographically prove lineage from the parent's weights; `base_model` identifies the pinned
comparison and admission target.
## License
Each exact GGUF listed by checksum above is released under the **Apache License 2.0** by its source
owner. This repository includes the license text in [`LICENSE`](./LICENSE) and preserves the four
source notices in [`NOTICE`](./NOTICE).
All four are compressed derivatives of [Qwen/Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B),
Copyright 2024 Alibaba Cloud, Apache-2.0. The binary crown also incorporates bit-exact signs from
[prism-ml/Bonsai-8B-unpacked](https://huggingface.co/prism-ml/Bonsai-8B-unpacked), Apache-2.0.
The source notices describe each modification, data provenance, and MIT-licensed `llama.cpp`
tooling. Preserve `LICENSE`, `NOTICE`, source attribution, and modification statements when
redistributing these files.
The grant is tied here to the exact listed files and hashes. A future crown change requires a new
artifact-level license check; this card does not grant terms on behalf of a future builder.
## Running the other crowns
For the ternary and sub4 files, replace the filename in the sub2 commands above. Runtime support
depends on the exact quantization type, runtime build, backend, available memory, and context
settings. Test the exact file on the target hardware before making compatibility or performance
claims.
The binary file has no embedded chat-template key, so this card does not prescribe a canonical
chat command for it. Establish and report a tested external template/runtime combination without
repacking or replacing the canonical bytes.
## Help build the device evidence
If you test a crown, share both successes and failures in [the pinned Device Lab discussion](https://huggingface.co/RalphLabsAI/ralph-crowns/discussions/3). A
useful receipt includes device model, OS and app version, exact GGUF filename, checksum status,
context size, runtime settings, load result, prompt-processing speed, generation speed, and the
exact failure if it did not run. Remove notifications, account identifiers, serial numbers, and
other private device information from screenshots.
## Audit levels
- **L0** verifies signatures and recomputes arithmetic, crown decisions, and candidate vectors from
published measurements.
- **L1** re-derives item selection and checks the pinned pool.
- **L2** re-runs a recorded judge over frozen text; complete multi-judge coverage requires every
recorded judge.
- **L3** loads artifacts and regenerates their steps, binding frozen text to model execution.
L2/L3 require the recorded inputs and compatible runtimes. The records and verifier distinguish
what can be checked from data alone from what requires inference hardware.
|