Instructions to use webmp3/Sakura-OvisOCR3-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use webmp3/Sakura-OvisOCR3-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 webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf webmp3/Sakura-OvisOCR3-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 webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

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 webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M
# Run inference directly in the terminal:
./build/bin/llama cli -hf webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Use Docker

docker model run hf.co/webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Llama new
LM Studio
Jan
Ollama
How to use webmp3/Sakura-OvisOCR3-GGUF with Ollama:
```
ollama run hf.co/webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M
```
Unsloth Desktop

How to use webmp3/Sakura-OvisOCR3-GGUF with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Docker Model Runner
How to use webmp3/Sakura-OvisOCR3-GGUF with Docker Model Runner:
```
docker model run hf.co/webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M
```

Lemonade

How to use webmp3/Sakura-OvisOCR3-GGUF with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Run and chat with the model

lemonade run user.Sakura-OvisOCR3-GGUF-Q4_K_M

List all available models

lemonade list

Hermes Agent

How to use webmp3/Sakura-OvisOCR3-GGUF with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use webmp3/Sakura-OvisOCR3-GGUF with OpenClaw:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M

Configure OpenClaw

# Install OpenClaw:
npm install -g openclaw@latest
# Register the local server and set it as the default model:
openclaw onboard --non-interactive --mode local \
  --auth-choice custom-api-key \
  --custom-base-url http://127.0.0.1:8080/v1 \
  --custom-model-id "webmp3/Sakura-OvisOCR3-GGUF:Q4_K_M" \
  --custom-provider-id llama-cpp \
  --custom-compatibility openai \
  --custom-text-input \
  --accept-risk \
  --skip-health

Run OpenClaw

openclaw agent --local --agent main --message "Hello from Hugging Face"

Sakura · GGUF quantization of ATH-MaaS/OvisOCR3

Independent community quantization. Not an official release of the upstream author.

1. Model Overview

Architecture: qwen3_5 · 0.9 B parameters · source formats: safetensors.

Original: 1.5 GB (F16 GGUF, the source of these quantizations).

Quant	Size	Compared with the original
Q2_K	0.4 GB	72 % smaller
Q3_K_M	0.5 GB	69 % smaller
Q4_K_M	0.5 GB	65 % smaller
Q5_K_M	0.6 GB	62 % smaller
Q6_K	0.6 GB	58 % smaller
Q8_0	0.8 GB	46 % smaller

2. Original Model / Attribution

Original model: ATH-MaaS/OvisOCR3
Declared base models: Qwen/Qwen3.5-0.8B (relation: finetune)
Quantized from: mradermacher/OvisOCR3-GGUF (file OvisOCR3.Q8_0.gguf).
Quantized by webmp3. Upstream authors retain their license and attribution.

3. Files

File	Size	Quant
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	0.4 GB	Q2_K
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	0.5 GB	Q3_K_M
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	0.5 GB	Q4_K_M
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	0.6 GB	Q5_K_M
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	0.6 GB	Q6_K
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	0.8 GB	Q8_0
`OvisOCR3.mmproj-f16.gguf`	0.2 GB	vision projector

OvisOCR3.mmproj-f16.gguf is the vision projector of the original GGUF repository mradermacher/OvisOCR3-GGUF, copied unchanged. Use it together with any of the files above to give the model images. Image input has not been tested for this release.

4. Download and Usage

llama-cli -m <file>.gguf -p "Hello" -n 32

# with images
llama-mtmd-cli -m <file>.gguf --mmproj OvisOCR3.mmproj-f16.gguf --image <picture>.jpg -p "Describe this image."

Needs a llama.cpp build that supports this architecture. If a quantization is split into numbered parts, keep them together and load the first one.

5. Verification

GGUF structure valid: True
Real inference test (every file loaded by llama.cpp and used to generate text once): yes
No coding benchmark, perplexity or quality score is claimed unless a measured value is listed here.

Technical details: exact versions, hashes, how these were made

Exact versions

Original model commit: 17f255e2c8ae6d18d5d5edb0a474bd4ed39aef90 (model card at that commit)
Vision projector: commit 041e883c46e3fe2bbe0a8d7d9bdc73571f6f769a of mradermacher/OvisOCR3-GGUF, SHA-256 698d199cf44ff10f99825bbd71ad9715e03a6cf7ad041c8ec1db979bfce905cd
Quantized from: commit 041e883c46e3fe2bbe0a8d7d9bdc73571f6f769a, SHA-256 858b61f2ea49526fd513a3e0e58d54d909a24c50fed19f1e59f7b40281410c32 (provenance verified: True)

File hashes

File	Bytes	SHA-256	Quant
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	422327840	`254c2376b8806a3fc98aad78ba9ae0b164768e0fd6893d66689add26aa5c69e2`	Q2_K
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	466223136	`656f9d765ec86b06ea4e59bc6331b3f86cff30d87b3b500a0284e2044f9d7d32`	Q3_K_M
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	529297952	`3e5b922ed384f4bef33f98f8a73c593217d293dd4c2e1d1315603db9afad812b`	Q4_K_M
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	577999392	`2b4dee88aef66d75cd2cd2605411ec231e7a152b3e3a7c7a221cf90ed07cd997`	Q5_K_M
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	629744672	`bc4a4f346f0c4b84a9823523d93649c712c01211ea084187f9eae00f30baa4df`	Q6_K
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	811844128	`94a0820040be80e7782658e3e25df0740644797e7d556a836b3a625247b61e18`	Q8_0

How these were made

This route performs existing-GGUF requantization from the pinned F16 source GGUF named above. This job did not convert the upstream BF16/safetensors checkpoint.

No importance-matrix calibration was run by this job. Importance-matrix calibration was requested but unavailable for the qualified route; normal quantization was used.

The quant label names the llama.cpp preset. Stock llama.cpp keeps some tensors (for example normalization weights) in higher precision, so not every tensor is stored in the named type; the table shows what each file really contains.

File	Tensors by type
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	F32: 133, Q2_K: 132, Q3_K: 30, Q4_K: 24, Q6_K: 1
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	F32: 133, Q3_K: 132, Q4_K: 51, Q5_K: 3, Q6_K: 1
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	F32: 133, Q4_K: 162, Q6_K: 25
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	F32: 133, Q5_K: 162, Q6_K: 25
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	F32: 133, Q6_K: 187
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	F32: 133, Q8_0: 187

Test builds

File	llama.cpp build	Executable SHA-256
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`

All 6 requested quants passed structure and one real CPU inference each. No quality benchmark was run.

6. License Information

Source license: apache-2.0. apache-2.0 allows redistribution with attribution

中文说明 · 樱花 Sakura（点击展开）

1. 概述

独立的社区量化版本，并非上游作者的官方发布。

架构：qwen3_5 · 0.9 B 参数 · 源格式：safetensors。

原始模型：1.5 GB（F16 GGUF，这些量化版本的来源）。

量化	大小	相比原始模型
Q2_K	0.4 GB	小 72 %
Q3_K_M	0.5 GB	小 69 %
Q4_K_M	0.5 GB	小 65 %
Q5_K_M	0.6 GB	小 62 %
Q6_K	0.6 GB	小 58 %
Q8_0	0.8 GB	小 46 %

2. 原始模型与署名

原始模型：ATH-MaaS/OvisOCR3
声明的基础模型：Qwen/Qwen3.5-0.8B（关系：finetune）
量化来源：mradermacher/OvisOCR3-GGUF（文件 OvisOCR3.Q8_0.gguf）。
量化者：webmp3。上游作者保留其许可证与署名。

3. 文件

文件	大小	量化
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	0.4 GB	Q2_K
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	0.5 GB	Q3_K_M
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	0.5 GB	Q4_K_M
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	0.6 GB	Q5_K_M
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	0.6 GB	Q6_K
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	0.8 GB	Q8_0
`OvisOCR3.mmproj-f16.gguf`	0.2 GB	vision projector

OvisOCR3.mmproj-f16.gguf 是原始 GGUF 仓库 mradermacher/OvisOCR3-GGUF 的视觉投影文件，原样复制。与上方任一文件配合使用即可输入图像。本版本未测试图像输入。

4. 下载与使用

llama-cli -m <file>.gguf -p "Hello" -n 32

# with images
llama-mtmd-cli -m <file>.gguf --mmproj OvisOCR3.mmproj-f16.gguf --image <picture>.jpg -p "Describe this image."

需要支持该架构的 llama.cpp 版本。如果某个量化被拆分为带编号的多个部分，请将它们放在一起并加载第一个。

5. 验证

GGUF 结构有效：True
真实推理测试（每个文件都由 llama.cpp 加载并生成一次文本）：yes
除非此处列出了实测数值，否则不声称任何编程基准、困惑度或质量分数。

技术细节：确切版本、哈希、制作方式

确切版本

原始模型提交：17f255e2c8ae6d18d5d5edb0a474bd4ed39aef90（该提交的模型卡）
视觉投影文件：mradermacher/OvisOCR3-GGUF 的提交 041e883c46e3fe2bbe0a8d7d9bdc73571f6f769a，SHA-256 698d199cf44ff10f99825bbd71ad9715e03a6cf7ad041c8ec1db979bfce905cd
量化来源：提交 041e883c46e3fe2bbe0a8d7d9bdc73571f6f769a，SHA-256 858b61f2ea49526fd513a3e0e58d54d909a24c50fed19f1e59f7b40281410c32（出处已验证：True）

文件哈希

文件	字节数	SHA-256	量化
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	422327840	`254c2376b8806a3fc98aad78ba9ae0b164768e0fd6893d66689add26aa5c69e2`	Q2_K
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	466223136	`656f9d765ec86b06ea4e59bc6331b3f86cff30d87b3b500a0284e2044f9d7d32`	Q3_K_M
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	529297952	`3e5b922ed384f4bef33f98f8a73c593217d293dd4c2e1d1315603db9afad812b`	Q4_K_M
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	577999392	`2b4dee88aef66d75cd2cd2605411ec231e7a152b3e3a7c7a221cf90ed07cd997`	Q5_K_M
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	629744672	`bc4a4f346f0c4b84a9823523d93649c712c01211ea084187f9eae00f30baa4df`	Q6_K
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	811844128	`94a0820040be80e7782658e3e25df0740644797e7d556a836b3a625247b61e18`	Q8_0

制作方式

该路线从上方标明的固定版本 F16 源 GGUF 进行现有 GGUF 的再量化。本任务没有转换上游的 BF16/safetensors 检查点。

本任务没有运行重要性矩阵（imatrix）校准。虽然请求了重要性矩阵校准，但所用的已验证路线不支持，因此使用了普通量化。

量化标签指 llama.cpp 的预设名称。标准 llama.cpp 会把部分张量（例如归一化权重）保留为更高精度，因此并非每个张量都以所标注的类型存储；下表列出每个文件实际包含的内容。

文件	按类型的张量数
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	F32: 133, Q2_K: 132, Q3_K: 30, Q4_K: 24, Q6_K: 1
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	F32: 133, Q3_K: 132, Q4_K: 51, Q5_K: 3, Q6_K: 1
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	F32: 133, Q4_K: 162, Q6_K: 25
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	F32: 133, Q5_K: 162, Q6_K: 25
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	F32: 133, Q6_K: 187
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	F32: 133, Q8_0: 187

测试版本

文件	llama.cpp 版本	可执行文件 SHA-256
`OvisOCR3.Q8_0-Q2_K-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q3_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q4_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q5_K_M-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q6_K-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`
`OvisOCR3.Q8_0-Q8_0-requant.gguf`	`b11669-620d2225c`	`486568ae9dd8682e160861a129b70f4a5efa73191542ab0cf80674b8b6d4f814`

All 6 requested quants passed structure and one real CPU inference each. No quality benchmark was run.（以上为英文原文）

6. 许可证信息

源许可证：apache-2.0。apache-2.0 allows redistribution with attribution

完整独立的中文版：README_zh.md

Downloads last month: -

GGUF

Model size

0.8B params

Architecture

qwen35

Hardware compatibility

2-bit

3-bit

4-bit

5-bit

6-bit

8-bit

Inference Providers NEW

This model isn't deployed by any Inference Provider. 🙋 Ask for provider support

Model tree for webmp3/Sakura-OvisOCR3-GGUF

Base model

Qwen/Qwen3.5-0.8B-Base

Finetuned

Qwen/Qwen3.5-0.8B

Finetuned

ATH-MaaS/OvisOCR3

Quantized

(5)

this model