ocr-and-documents

Extract text, tables, and images from PDFs and scanned documents using pymupdf or marker-pdf.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill ocr-and-documents-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ocr-and-documents
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/productivity/ocr-and-documents
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill ocr-and-documents-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf, pymupdf4llm, marker-pdf, and includes scripts (resource) components.

What problem does it solve? Getting usable text out of PDFs and scanned documents is inconsistent: some files have embedded text, others are image-only scans requiring OCR, and choosing the wrong tool wastes time or fails entirely. This Skill provides a decision workflow that routes each document to the right extractor. ## Core Features & Use Cases - Tiered extraction strategy: Try web_extract for remote URLs first, then pymupdf for lightweight local text extraction, then marker-pdf for OCR, equations, forms, and complex layouts. - Helper scripts: Run extract_pymupdf.py for text, markdown, tables, images, and metadata, or extract_marker.py for high-quality OCR with JSON output and LLM-boosted accuracy. - Use Case: You download a scanned arxiv paper as a local PDF. The Skill checks disk space, installs marker-pdf, and converts the document to clean markdown with extracted images. ## Quick Start Extract the text from my local file report.pdf, using OCR if it turns out to be a scanned document.

Frequently Asked Questions about ocr-and-documents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract text from a PDF in Python?▼

Use pymupdf to open the PDF and call get_text() on each page, or run the extract_pymupdf.py script for text, markdown, tables, or metadata output. It installs in about 25MB and works instantly on text-based PDFs.

pymupdf vs marker-pdf for PDF extraction?▼

pymupdf is lightweight (~25MB) and handles text-based PDFs, basic tables, and embedded images. marker-pdf (~3-5GB with PyTorch) adds OCR for scanned documents in 90+ languages, equations, forms, and reading-order detection.

Can I extract text from a scanned PDF?▼

Scanned PDFs require OCR, which pymupdf does not support. Use marker-pdf via the extract_marker.py script, which performs OCR in over 90 languages and outputs markdown, but requires about 5GB of disk space for PyTorch and models.

How do I extract text from a PDF at a remote URL?▼

Call web_extract with the PDF URL, which converts the document to markdown via Firecrawl with no local dependencies. Only fall back to local extraction with pymupdf or marker-pdf if web_extract fails or the file is local.

Why does marker-pdf installation fail on my system?▼

marker-pdf needs roughly 5GB of free disk for PyTorch plus about 2.5GB of models downloaded to the HuggingFace cache on first use. Run extract_marker.py --check to verify disk space, or use pymupdf instead for text-based PDFs.