You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy .env.example to .env and fill in the API keys / endpoints for the providers you want to use:
cp .env.example .env
Cloud API Pipelines
These pipelines use hosted APIs. You only need an API key in your .env file.
Bold pipelines are baselines evaluated in the ParseBench paper. The name used in the paper is shown in parentheses.
Upstage
Pipeline
Description
Env Var
upstage_dpe_v2
Document Parse 2 (Enhanced), snapshot 260930
UPSTAGE_API_KEY
Install with uv sync --extra upstage. PDFs are uploaded unchanged.
Native images smaller than a 2000px short edge
are proportionally upscaled; larger images retain their dimensions. The pipeline
requests HTML, Markdown, text and coordinates. PDF rendering uses API defaults.
The provider uses API Markdown for body text, retaining HTML for tables,
charts, figures and lists. It preserves OCR text and authored table captions,
removes generated image narration and transport attributes from evaluable
markup, and converts closed HTML code blocks to fences. Literal code, table
spans and layout coordinates are preserved.
uv run parse-bench run upstage_dpe_v2 --test --max_concurrent 2
LlamaParse
Pipeline
Description
Env Var
llamaparse_agentic
Agentic tier (In paper: LlamaParse Agentic)
LLAMA_CLOUD_API_KEY
llamaparse_cost_effective
Cost-effective tier (In paper: LlamaParse Cost Effective)
r-1 model, settings.model="r-1" (In paper: Reducto (r-1))
REDUCTO_API_KEY
reducto_nonagentic_change_tracking
Non-agentic with formatting_include=["change_tracking"]
REDUCTO_API_KEY
reducto_agentic_table
Agentic on text + table scopes
REDUCTO_API_KEY
reducto_agentic_chart
Agentic on text + table + figure scopes with advanced chart agent
REDUCTO_API_KEY
Mistral OCR
Pipeline
Description
Env Var
mistral_ocr_4
Mistral OCR 4.0
MISTRAL_API_KEY
mistral_ocr_4_annotation
Mistral OCR 4.0 with bbox annotation (Document AI)
MISTRAL_API_KEY
mistral_ocr_4_1
Mistral OCR 4.1
MISTRAL_API_KEY
mistral_ocr_4_1_annotation
Mistral OCR 4.1 with bbox annotation (Document AI)
MISTRAL_API_KEY
Pulse
Pipeline
Description
Env Var
pulse_ultra_2
pulse-ultra-2 hosted tier with native markdown output, refinement enabled, and inline formatting preserved
PULSE_API_KEY
Chunkr
Pipeline
Description
Env Var
chunkr
Default quality
CHUNKR_API_KEY
chunkr_high_res
High resolution
CHUNKR_API_KEY
Datalab (Marker)
Pipeline
Description
Env Var
datalab_fast
Fast mode
DATALAB_API_KEY
datalab_balanced
Balanced mode
DATALAB_API_KEY
datalab_accurate
Accurate mode
DATALAB_API_KEY
Extend AI
Pipeline
Description
Env Var
extend_parse
Default (In paper: Extend)
EXTEND_API_KEY
extend_parse_2
2.0 engine (v2.0.0, GA)
EXTEND_API_KEY
extend_parse_light
Light engine (v1.0.0)
EXTEND_API_KEY
extend_parse_document
Document scope
EXTEND_API_KEY
extend_parse_section
Section scope
EXTEND_API_KEY
Landing AI
Pipeline
Description
Env Var
landingai_parse
Default (In paper: LandingAI)
LANDING_AI_API_KEY
Unstructured
Pipeline
Description
Env Var
unstructured_auto
Auto strategy
UNSTRUCTURED_API_KEY
unstructured_fast
Fast strategy
UNSTRUCTURED_API_KEY
unstructured_hi_res
Hi-res strategy
UNSTRUCTURED_API_KEY
OpenInnovation Parser (oi-parser)
Hosted document-parsing API. Sign up at oi-parser.ai to get an API key.
Pipeline
Description
Env Vars
oi_parser
oi-parser hosted /v1/extract API
OI_PARSER_API_KEY, OI_PARSER_BASE_URL (optional)
DocAI (ProvidusAI)
Hosted parse API. Documents are uploaded into a knowledge base named ParseBench (created on first
use) with auto-parse on; the job is polled and result.md plus grounding.json are fetched. Tables
come back as HTML with row and column spans; grounding boxes feed the layout vertical through the
docai layout adapter. Cost is one credit per parsed page at the pay-as-you-go rate of USD 0.01
(1¢ per page); override with credit_rate_usd or DOCAI_CREDIT_RATE_USD. Sign up at
https://platform.providus.ai. Recommended --max_concurrent 30.
Pipeline
Description
Env Vars
docai_default
DocAI parsing pipeline by ProvidusAI (In paper: DocAI)
DOCAI_API_KEY, DOCAI_BASE_URL (optional)
anyformat
Hosted parse API. Each pipeline creates a one-node parse workflow for its tier (cache off) on first
use, runs every document through POST /v3/workflows/{id}/upload/run/ and polls GET /v3/runs/{id}/.
Cost is the public list price of the tier (credits per page × credit rate); the API reports no usage.
Layout bboxes come from the response's blocks[] and feed the layout vertical through the
anyformat layout adapter.
Nemotron 3.5 Parse SDK server (triple pass: full page + detection + Table/Chart crops; layout)
NEMOTRON_PARSE_3_5_SERVER_URL
MiniCPM-OCR 1.0
Pipeline
Description
Env Var
minicpm_ocr_sdk
MiniCPM-OCR 1.0 minicpmvocr SDK server (PP-DocLayoutV3 regions recognized per label; layout)
MINICPM_OCR_SERVER_URL
Unlimited-OCR 2
Pipeline
Description
Env Var
unlimitedocr2
Unlimited-OCR 2 on its official SGLang server (whole document per request; layout)
UNLIMITEDOCR2_SERVER_URL
OvisOCR3
Pipeline
Description
Env Var
ovisocr3_vllm
OvisOCR3 on vLLM with the model card settings (official structured parse plus a chart-parsing pass per chart region; layout)
OVISOCR3_SERVER_URL
Surya OCR 2
Pipeline
Description
Env Var
surya2_sdk
Surya OCR 2 SDK server (full-page OCR + layout)
SURYA2_SERVER_URL
florin-parser-nano
Fine-tune of KDL-Frontier-Parser-nano (florin-inc/florin-parser-nano); served identically to the base model and driven by the same two-stage pipeline, with markdown-emission fixes (see the provider module docstring for the exact vllm serve command).
Fine-tune of florin-parser-nano (cloudraker/rakedoc-nano); served identically to the parent models and driven by the same two-stage pipeline and markdown emission (see the provider module docstring for the exact vllm serve command).
Fine-tune of MinerU2.5-Pro-2605-1.2B (aeddix-labs/aeddix-alpine-ocr, tag v0.1); served identically to KDL-Frontier-Parser-nano and driven by the unchanged kdl_frontier_nano two-stage pipeline and markdown emission (see the provider module docstring for the exact vllm serve command).
PyMuPDF4LLM Markdown with native HTML tables and RapidOCR at 150 DPI
Python 3.12, pymupdf==2.1, and rapidocr==3.10.0
warp_ingest
Warp-Ingest local parser
warp-ingest[ocr]>=2.0.1 installed
tesseract_eng
Tesseract OCR (English)
tesseract installed
tesseract_fast
Tesseract OCR (fast)
tesseract installed
tesseract_high_quality
Tesseract OCR (high quality)
tesseract installed
infinity_parser2_flash
Infinity-Parser2-Flash (vLLM server, JSON layout)
infinity_parser2, vLLM server at INFINITY_PARSER2_API_URL
infinity_parser2_pro
Infinity-Parser2-Pro (vLLM server, JSON layout)
infinity_parser2, vLLM server at INFINITY_PARSER2_API_URL
Create the isolated Python environment for pymupdf4llm_markdown with
uv sync --python 3.12 --extra pymupdf4llm, then run it with
uv run --python 3.12 --extra pymupdf4llm parse-bench run pymupdf4llm_markdown --max_concurrent 1.