ocrmypdf
OCRmyPDF adds an OCR text layer to scanned PDF files, allowing them to be searched
Decision gist · record as of 2026-08-14
Yes. OCRmyPDF is actively maintained, widely used (top 5000 PyPI packages, 1.17M monthly downloads), has no known vulnerabilities, and solves a specific, well-defined problem. Low install friction and copyleft licensing pose no barrier for most users. The main prerequisite—external system binaries (Tesseract, Ghostscript)—is clearly documented and available across major platforms. Install it if you need to make scanned PDFs searchable.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Tesseract OCR and Ghostscript to be installed and available on PATH; Python >=3.11 required.
- Low friction: pure Python wheel with 13 runtime dependencies.
- Active maintenance—last release 9 days ago, repository at 34446 stars with recent commits.
License · maintenance · safety
MPL-2.0 (copyleft) — MPL-2.0 (copyleft): you may use and modify the package freely, but any modifications you distribute must be released under the same license. Suitable for most commercial and open-source projects, though distribution of modified versions carries obligations.
last release 2026-08-05 (9 days) · last repo commit 2026-08-06 · 34,446 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,169,727 downloads/mo, #4,272 on PyPI
Alternatives
Verify before relying
pip install ocrmypdf
ocrmypdf -l eng input_scanned.pdf output_searchable.pdf- Performance characteristics on large multi-page documents (fact sheet mentions thousands of pages but provides no benchmarks).
- Actual file size reduction from image optimization (description claims files often smaller than input but no metrics given).
- Accuracy of OCR output across the 100+ supported languages (language support confirmed but quality variance unknown).
What it is and what it does
OCRmyPDF is a command-line tool that takes scanned PDFs or images and adds an invisible searchable text layer using Tesseract OCR, making the content copy-pasteable and indexable. It preserves the original image resolution, optionally deskews crooked pages, cleans images before OCR, and can convert output to PDF/A format for long-term archival. The tool validates both input and output, distributes work across available CPU cores, and supports over 100 languages through Tesseract's language packs.
The package wraps Tesseract OCR and Ghostscript into a Python interface with 13 runtime dependencies including pikepdf for PDF manipulation, pillow for image handling, pydantic for configuration, and rich for CLI output. It runs on Linux, macOS, Windows, and FreeBSD. The tool is designed for batch processing and scales to handle files with thousands of pages; it keeps processed data private and does not require network access.
Use it for
- Digitize paper documents or scanned PDFs to make them searchable and copy-pasteable for archival or document management systems.
- Batch convert image files (JPG, PNG) to single-page searchable PDFs for integration into document workflows.
- Prepare scanned documents for long-term storage by converting to PDF/A format with embedded OCR text.
- Straighten and clean crooked or low-quality scans before OCR to improve recognition accuracy.
- Process multilingual documents by specifying multiple language codes (e.g., eng+fra) to recognize mixed-language content.
- Optimize PDF file sizes while adding OCR, reducing storage overhead for large document collections.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
OCRmyPDF is actively maintained, widely used (top 5000 PyPI packages, 1.17M monthly downloads), has no known vulnerabilities, and solves a specific, well-defined problem. Low install friction and copyleft licensing pose no barrier for most users. The main prerequisite—external system binaries (Tesseract, Ghostscript)—is clearly documented and available across major platforms. Install it if you need to make scanned PDFs searchable.
Install
ocrmypdf on PyPI
Before you install
Low friction: pure Python wheel with 13 runtime dependencies. Active maintenance—last release 9 days ago, repository at 34446 stars with recent commits. Requires external system binaries (Tesseract OCR and Ghostscript) to function.
Requires Tesseract OCR and Ghostscript to be installed and available on PATH; Python >=3.11 required.
License in practice
MPL-2.0 (copyleft): you may use and modify the package freely, but any modifications you distribute must be released under the same license. Suitable for most commercial and open-source projects, though distribution of modified versions carries obligations.
Quickstart
pip install ocrmypdf
ocrmypdf -l eng input_scanned.pdf output_searchable.pdfVerify before relying
- Performance characteristics on large multi-page documents (fact sheet mentions thousands of pages but provides no benchmarks).
- Actual file size reduction from image optimization (description claims files often smaller than input but no metrics given).
- Accuracy of OCR output across the 100+ supported languages (language support confirmed but quality variance unknown).
Package facts
| License | MPL-2.0 copyleft |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 13 packagesfpdf2img2pdfpackagingpdfminer-sixpi-heifpikepdfpillowpluggypydanticpypdfium2richtyping-extensionsuharfbuzz |
| Maintenance | Actively maintained 9 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,169,727 / month, #4,272 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: End Users/DesktopIntended Audience :: Science/ResearchIntended Audience :: System AdministratorsOperating System :: MacOSOperating System :: Microsoft :: WindowsOperating System :: POSIXOperating System :: POSIX :: BSDOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3Topic :: Scientific/Engineering :: Image RecognitionTopic :: Text Processing :: IndexingTopic :: Text Processing :: Linguistic |
Evidence: ocrmypdf-17.10.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “add OCR text layer to PDF”
- ocrmypdfOCRmyPDF adds searchable text layers to scanned PDF files using…
- unstructured-inferenceRuns inference on layout-parsing and document-analysis models to…
- camelot-pyExtracts tables from PDFs into pandas DataFrames using multiple…
Give your agent the search over MCP, or paste the wish link into any chat.
More Linguistic packages
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
tiktoken is a fast BPE tokenizer that converts text into token sequences compatible with OpenAI models, supporting multiple encoding schemes including o200k_base and model-specific encodings.
Install it if you work with OpenAI APIs or need to understand token boundaries in GPT-family models.
Detects character encoding and language in byte sequences with high accuracy, supporting 99 encodings and returning confidence scores, language tags, and MIME types.
Install it if you need to detect character encoding or language in byte data; the rewrite makes it substantially faster and more accurate than its predecessors.
Converts Unicode text to ASCII by transliterating non-ASCII characters into their closest ASCII equivalents, with no runtime dependencies.
However, if transliteration quality or ongoing maintenance matters, consider unidecode instead despite its GPL-only license.
Lark is a parsing library that builds abstract syntax trees from context-free grammars, supporting multiple parsing algorithms (Earley, LALR(1), CYK) with automatic line and column tracking.
Python bindings to the tree-sitter parsing library, enabling incremental parsing and syntax tree analysis for source code.
See also unstructured.pytesseract · tesserocr · pikepdf · marker-pdf · pdfservices-sdk · pytesseract · mineru · paddleocr · pyocr · img2table