GGUF files and model card
Browse files- .gitattributes +2 -0
- README.md +65 -0
- teleocr-q8_0.gguf +3 -0
- teleocr-q8v.gguf +3 -0
.gitattributes
CHANGED
|
@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
teleocr-q8_0.gguf filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
teleocr-q8v.gguf filter=lfs diff=lfs merge=lfs -text
|
README.md
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
base_model: XingChen-AGI/TeleOCR
|
| 4 |
+
base_model_relation: quantized
|
| 5 |
+
pipeline_tag: image-text-to-text
|
| 6 |
+
library_name: teleocr-rs
|
| 7 |
+
tags:
|
| 8 |
+
- gguf
|
| 9 |
+
- ocr
|
| 10 |
+
- document-parsing
|
| 11 |
+
- candle
|
| 12 |
+
- rust
|
| 13 |
+
---
|
| 14 |
+
|
| 15 |
+
# TeleOCR — GGUF for teleocr-rs
|
| 16 |
+
|
| 17 |
+
GGUF conversions of [XingChen-AGI/TeleOCR](https://huggingface.co/XingChen-AGI/TeleOCR)
|
| 18 |
+
(China Telecom, ~1.2B, document parsing: layout, text, LaTeX formulas, tables, code)
|
| 19 |
+
for **[teleocr-rs](https://github.com/rzafiamy/teleocr-rs)**, a Rust/Candle port.
|
| 20 |
+
|
| 21 |
+
> **Not for llama.cpp.** TeleOCR's decoder is Qwen3-style (head_dim 128 ≠ hidden/heads,
|
| 22 |
+
> per-head QK-norm) behind a Qwen2.5-VL config, which llama.cpp does not load. These files
|
| 23 |
+
> are single-file GGUFs (weights + config + tokenizer) in the teleocr-rs layout.
|
| 24 |
+
|
| 25 |
+
| file | size | weights | use |
|
| 26 |
+
|---|---|---|---|
|
| 27 |
+
| `teleocr-q8v.gguf` | 1.5 GB | text and vision linears Q8_0 | **GPU** (recommended) |
|
| 28 |
+
| `teleocr-q8_0.gguf` | 2.0 GB | text Q8_0, vision F16 | **CPU** (Q8_0 vision is slow on CPU) |
|
| 29 |
+
|
| 30 |
+
## Accuracy
|
| 31 |
+
|
| 32 |
+
Greedy output is **token-identical** to the transformers reference on the five model-card
|
| 33 |
+
samples (text, formula, table, code, 767-token layout), for both files, on CPU and CUDA.
|
| 34 |
+
Both files also give identical Markdown on six pages of the TeleOCR paper.
|
| 35 |
+
|
| 36 |
+
## Speed (RTX 4090)
|
| 37 |
+
|
| 38 |
+
~225 tokens/s per sequence; vision tower 0.38 s for a 1036×1036 page; full page parsing
|
| 39 |
+
(layout + all blocks, batch 8) ~3.2 s per page. Peak VRAM ~6.4 GB at batch 8.
|
| 40 |
+
|
| 41 |
+
## Usage
|
| 42 |
+
|
| 43 |
+
```bash
|
| 44 |
+
git clone https://github.com/rzafiamy/teleocr-rs && cd teleocr-rs
|
| 45 |
+
cargo build --release -p teleocr-cli --features cuda # or without --features cuda for CPU
|
| 46 |
+
scripts/fetch-pdfium.sh target/release # PDF input
|
| 47 |
+
|
| 48 |
+
target/release/teleocr parse -m teleocr-q8v.gguf paper.pdf --pages 1-3 # Markdown
|
| 49 |
+
target/release/teleocr run -m teleocr-q8v.gguf table.png -t table # one task
|
| 50 |
+
target/release/teleocr serve -m teleocr-q8v.gguf --port 8090 # POST /v1/ocr
|
| 51 |
+
```
|
| 52 |
+
|
| 53 |
+
Also served by [zallama](https://github.com/rzafiamy/zallama) (`modality: ocr`, `POST /v1/ocr`).
|
| 54 |
+
|
| 55 |
+
## Reproduce
|
| 56 |
+
|
| 57 |
+
```bash
|
| 58 |
+
teleocr convert ./TeleOCR -o teleocr-q8v.gguf --vision-dtype q8_0
|
| 59 |
+
teleocr convert ./TeleOCR -o teleocr-q8_0.gguf # vision F16
|
| 60 |
+
```
|
| 61 |
+
|
| 62 |
+
## License
|
| 63 |
+
|
| 64 |
+
Apache-2.0, as the original model. Credits: Cai et al., *TeleOCR: Navigating Document
|
| 65 |
+
Parsing Across Digital and Camera-Captured Documents*, arXiv:2608.12898.
|
teleocr-q8_0.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:8385538473616bd1b7cf23be6e8a5376a9f5d94c7187d9904245023cad3c1445
|
| 3 |
+
size 1972879168
|
teleocr-q8v.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:81c72c0cf4418432735d734e2c1180e9a762d2393df35d66a921382ad7a3cf4b
|
| 3 |
+
size 1484123968
|