Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,49 @@
+---
+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)).