---
license: mit
language:
- en
tags:
- text-recognition
- ocr
- trocr
- handwriting
- gguf
- crispembed
base_model: microsoft/trocr-small-handwritten
pipeline_tag: image-to-text
---

# TrOCR-small Handwritten Text — GGUF

Handwritten text recognition model for [CrispEmbed](https://github.com/CrispStrobe/CrispEmbed).
Recognizes handwritten text from cropped text-line images. Outputs **mixed-case** text
(unlike trocr-small-printed which uppercases).

**Architecture**: DeiT-small encoder (12L, 384d, 6 heads) + TrOCR decoder
(6L, 256d, 8 heads). XLM-R vocabulary (64,044 tokens). 61M parameters.

**Source**: [microsoft/trocr-small-handwritten](https://huggingface.co/microsoft/trocr-small-handwritten) (MIT).

## Model Variants

| Variant | Size | Recognition quality |
|---------|------|-------------------|
| F32 | 235 MB | exact token match vs HuggingFace (greedy) |
| F16 | 118 MB | identical to F32 |
| **Q8_0** | **63 MB** | **identical to F32** |

Q4_K not provided — 256d decoder bottleneck is too narrow for 4-bit quantization.

## Usage

```bash
# Single crop recognition
crispembed -m trocr-small-handwritten-q8_0.gguf --ocr crop.png

# Full pipeline with DBNet detection
crispembed --det dbnet-ic15-q4_k.gguf -m trocr-small-handwritten-q8_0.gguf --ocr scan.png
```

## License

MIT (same as [microsoft/trocr-small-handwritten](https://huggingface.co/microsoft/trocr-small-handwritten)).