Add model card

README.md

@@ -0,0 +1,56 @@
+---
+library_name: onnx
+license: apache-2.0
+pipeline_tag: image-text-to-text
+tags:
+  - onnx
+  - ocr
+  - translation
+  - pdf
+base_model:
+  - deepseek-ai/DeepSeek-OCR-2
+  - Helsinki-NLP/opus-mt-es-en
+---
+
+# pdftool models
+
+ONNX exports of the models used by [pdftool](https://github.com/benbaker76/pdftool), a C++ command-line
+tool that converts PDFs to Markdown and translates PDFs in place. They run on ONNX Runtime with no
+Python involved.
+
+Nothing here was trained or fine-tuned by us. Each folder is a format conversion of the original
+weights and stays under the original author's licence.
+
+| Folder | Size | Use | Original weights | Licence |
+| --- | --- | --- | --- | --- |
+| `deepseek-ocr2-fp16/` | 6.6 GB | PDF to Markdown, GPU | [deepseek-ai/DeepSeek-OCR-2](https://huggingface.co/deepseek-ai/DeepSeek-OCR-2) | Apache-2.0 |
+| `deepseek-ocr2-fp32/` | 13 GB | PDF to Markdown, CPU | [deepseek-ai/DeepSeek-OCR-2](https://huggingface.co/deepseek-ai/DeepSeek-OCR-2) | Apache-2.0 |
+| `opus-mt-es-en/` | 0.6 GB | Spanish to English translation | [Helsinki-NLP/opus-mt-es-en](https://huggingface.co/Helsinki-NLP/opus-mt-es-en) | Apache-2.0 |
+
+Each folder is self-contained. Download the whole folder and keep the file names: an `.onnx` file
+loads its weights from the `.onnx.data` file beside it.
+
+```sh
+hf download baker76/pdftool-models --include "deepseek-ocr2-fp16/*" --local-dir models
+pdftool convert in.pdf -o out.md --model models/deepseek-ocr2-fp16
+pdftool translate in.pdf -o out.pdf --model models/opus-mt-es-en
+```
+
+## DeepSeek-OCR-2
+
+- `vision_sam_1024.onnx`, `vision_sam_768.onnx`: the SAM stage for the full-page view and the tiles.
+- `vision_encoder.onnx`: the Qwen2-based encoder and projector.
+- `decoder.onnx`: token embedding, image-feature merge, the 12-layer decoder with a key/value cache,
+  and the output head. The mixture-of-experts routing is evaluated densely (all experts, masked to
+  the top 6), which gives the same result as the original sparse routing.
+- `tokenizer.json`, `config.json`: tokenizer and the prompt token ids.
+
+On one test page the fp32 export reproduced the PyTorch model's output token for token; the fp16
+export produced the same text with two bounding-box coordinates differing by 1.
+
+## OPUS-MT
+
+`encoder.onnx` and `decoder.onnx` (no cache; the decoder is re-run each step), with the original
+`source.spm`, `target.spm` and `vocab.json`. Logits match PyTorch to within 1e-5.
+
+The scripts that produced these files are in the pdftool repository under `tools/export/`.