Instructions to use BrandeisPatrick/Ouro-2.6B-GGUF 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 BrandeisPatrick/Ouro-2.6B-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 BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
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 BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
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 BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use BrandeisPatrick/Ouro-2.6B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "BrandeisPatrick/Ouro-2.6B-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": "BrandeisPatrick/Ouro-2.6B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
- Ollama
How to use BrandeisPatrick/Ouro-2.6B-GGUF with Ollama:
ollama run hf.co/BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
- Unsloth Desktop
- Docker Model Runner
How to use BrandeisPatrick/Ouro-2.6B-GGUF with Docker Model Runner:
docker model run hf.co/BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
- Lemonade
How to use BrandeisPatrick/Ouro-2.6B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull BrandeisPatrick/Ouro-2.6B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Ouro-2.6B-GGUF-Q4_K_M
List all available models
lemonade list
- Atomic Chat
Ouro-2.6B โ GGUF
GGUF conversions of ByteDance/Ouro-2.6B, the larger base model of the Ouro family of looped language models. The 48-layer decoder stack is applied 4 times per token with shared weights, so a 2.7B-parameter model computes at an effective depth of 192 layers.
These are the first GGUFs of this architecture. llama.cpp had no ouro architecture, so no GGUF
runtime could load Ouro at all. The architecture was written for this release; the patch, the
evaluation harness and the validation data are at
BrandeisPatrick/loop-transformer.
Needs a patched llama.cpp today. The
ouroarchitecture is not yet upstream, so stock llama.cpp, Ollama and LM Studio cannot load these files yet. Build with the patch:git clone https://github.com/BrandeisPatrick/loop-transformer && loop-transformer/llamacpp/build.shOnce the upstream PR merges and Ollama bumps its pin, these run unmodified.
Files
| file | size | note |
|---|---|---|
Ouro-2.6B-F16.gguf |
5.3 GB | reference precision |
Ouro-2.6B-Q8_0.gguf |
2.8 GB | recommended โ Q8_0 was lossless within noise on the 1.4B |
Ouro-2.6B-Q4_K_M.gguf |
1.65 GB | smallest; on the 1.4B, Q4_K_M cost ~5 points |
What is verified here, and what is not
Being precise, because this variant was not benchmarked end-to-end:
Verified on these files. Loads as arch = ouro, n_layer = 192 (48 physical ร 4 loops) at
2.67 B parameters โ depth expanded, weights stored once โ and generates correct, coherent output
(~8.3 tok/s on an Apple M4, Q8_0).
Verified on the same code path, using the smaller Ouro-1.4B. The port reproduces the transformers reference across loop depths: 26.0 / 67.0 / 80.5 percent on GSM8K at 1 / 2 / 4 loops against 23.0 / 64.0 / 80.0, every point within one standard error, with token-identical greedy output. That is the evidence the architecture is correct.
Not benchmarked here. The paper reports this model at GSM8K 81.58 and MATH500 90.85 (3-shot and 5-shot CoT, strict match), but those runs were not repeated for this file, so no accuracy figure is claimed for it. The 1.4B is the benchmarked one; on that model the port matched the published GSM8K figure to within half a point.
The loop count is a runtime dial
The compute/accuracy trade-off is adjustable at load time from a single file:
llama-cli -m Ouro-2.6B-Q8_0.gguf --override-kv ouro.num_loops=int:2 # 96 layers, ~2x faster
llama-cli -m Ouro-2.6B-Q8_0.gguf # 192 layers, default
The model was trained at 4 loops. The paper's own ablation for this model gives MMLU 51.55 / 67.63 / 73.57 / 74.60 at depths 1-4, degrading beyond 4. On the 1.4B, a single loop collapses accuracy to 26% โ always quote the depth alongside any number from these files.
Provenance
Converted from ByteDance/Ouro-2.6B with a llama.cpp built from upstream 67672dc plus the
ouro architecture patch. The early-exit gate is deliberately not converted: it selects which
already-computed loop feeds the LM head rather than changing what is computed, and at the shipped
early_exit_threshold = 1.0 it never fires.
Citation
@article{ouro2025,
title = {Scaling Latent Reasoning via Looped Language Models},
author = {ByteDance Seed},
journal= {arXiv:2510.25741},
year = {2025}
}
- Downloads last month
- 33
4-bit
8-bit
16-bit
Model tree for BrandeisPatrick/Ouro-2.6B-GGUF
Base model
ByteDance/Ouro-2.6B