local-ocr-cli
面向纯文本 LLM 的完全本地 OCR CLI：以 PaddleOCR-VL 作为首选引擎，并提供 tesseract 回退，包含 dsh 插件
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add local-ocr-cli@0.1.10Local Ocr Cli 以 local-ocr-cli 发布，当前版本为 0.1.10。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Fully-local OCR for text-only LLMs. PaddleOCR-VL first-tier engine, tesseract fallback. Images never leave your machine.
简体中文 · Install guide · CLI manual · Troubleshooting · Output contract · Security
LocalOCR gives a text-only model (DeepSeek, GLM, any of them) real OCR sight, entirely on your machine. It reads local images with the first-tier PaddleOCR-VL-1.6 pipeline (layout analysis + VLM: text, tables, formulas, charts — SOTA on OmniDocBench) and falls back to tesseract when you want something lighter.
ocr tool a text-only
DeepSeek Harness model can call directly.skills/local-ocr-hermes/ skill in the
agentskills.io format, so NousResearch's hermes-agent can drive the same
local engine.dsh plugin --profile web add local-ocr-cli
Then restart dsh. The ocr tool appears on every request.
See INSTALL.md — the Node CLI plus the Python engine (PaddleOCR-VL venv + llama.cpp GGUF server, tesseract optional).
Publishing to npm is fully automated via Trusted Publishing (OIDC) — no
tokens, no 2FA prompts, automatic provenance. Pushing a vX.Y.Z tag triggers
.github/workflows/release.yml, which runs
typecheck + test + build and then npm publish --provenance.
npm version patch # bumps version and tags vX.Y.Z
git push --tags # GitHub Actions publishes to npm
local-ocr analyze shot.png --engine paddleocr --json
local-ocr analyze invoice.jpg --engine tesseract
local-ocr doctor
Output: JSON with text (markdown transcription), saved_to (md file),
json_to (structured JSON: blocks with bbox/order, layout boxes with
confidence). See the output contract.
| engine | what | needs |
|---|---|---|
paddleocr (default) | PaddleOCR-VL-1.6: layout + VLM, SOTA | Python venv + llama.cpp GGUF server |
tesseract | classic OCR, light | tesseract binary |
Both run locally. local-ocr doctor checks what is available.
| demo | what it shows |
|---|---|
| Japanese Instrument of Surrender | dense 1945 historical document: printed clauses + handwritten signatures + multi-nation signature block; 33 structured blocks, 39 layout boxes |
| Diamond Sutra Calligraphy | vertical traditional-Chinese Song-dynasty calligraphy, read in correct column order |
| doc | read when |
|---|---|
| CLI manual | every flag, subcommand |
| Configuration | setting up engines |
| Troubleshooting | a run failed |
| Capability boundaries | what the engine can and cannot read |
| Output contract | consuming the JSON |
| Security | what LocalOCR never does |
This project publishes to npm automatically via OIDC Trusted Publishing — see
the engineering-playbook npm OIDC guide
for the general recipe and failure modes. Short form: npm version patch && git push --tags.
MIT