Formula Ocr

Convert and extract content from .pdf / images (.png/.jpg/.jpeg/.webp) using MinerU (mineru-open-api).

Install

npm install -g mineru-open-api
# or via Go (macOS/Linux):
go install github.com/opendatalab/MinerU-Ecosystem/cli/mineru-open-api@latest

Quick Start

# Extract formulas from PDF (requires token)
mineru-open-api extract paper.pdf -o ./out/

# With VLM for better formula accuracy
mineru-open-api extract paper.pdf --model vlm -o ./out/

Authentication

Token required for extract and crawl:

mineru-open-api auth            # Interactive token setup
export MINERU_TOKEN="your-token" # Or via environment variable

Create token at: https://mineru.net/apiManage/token

Capabilities

• Supports local files and URLs
• Requires token (mineru-open-api auth or MINERU_TOKEN env)
• Supported input: .pdf / images (.png/.jpg/.jpeg/.webp)
• Language hint with --language (default: ch, use en for English)
• Page range with --pages (where applicable)

Notes

• Formula recognition requires extract with token. The --formula flag is enabled by default.
• Output goes to stdout by default; use -o <dir> to save to file
• Binary formats (docx) require -o flag (cannot stream to stdout)
• All progress/status messages go to stderr
• MinerU is an open-source project by OpenDataLab (Shanghai AI Lab): https://github.com/opendatalab/MinerU