Freedom251 › PDF Converter Software
MinerU

What MinerU is
MinerU 4.0 combines document parsing, a local document library, and tools for conversion, application integration, and agent reading. It accepts PDFs, images, office documents, ebooks, web formats, and other listed inputs. Outputs include Markdown, HTML, LaTeX, DOCX, EPUB, PDF, structured content, and content lists. Four parsing tiers—Flash, Basic, Standard, and Advanced—address different quality and compute needs. The library can find files, cache parse results, search content, resume by page or block, and retain citation locators. Developers can use a Python SDK, V1 HTTP API, command-line tools, or a Gradio-based WebUI. MinerU supports the MCP protocol and agent frameworks, and offers exports to Dify and Notion. Documents are not automatically uploaded to the official service; remote parsing requires explicit configuration. Local WebUI and API deployments are documented for Linux, macOS, and Windows. MinerU is open source and free under its project license. Commercial use requires a separate license if monthly active users exceed 100 million or monthly revenue exceeds USD 20 million; third-party online services based on MinerU must provide attribution.
Who it suits
MinerU may suit people parsing and converting varied document formats, or developers integrating document workflows through an API, SDK, command line, or agent framework. Its local deployment options are relevant to users who want to run a WebUI or API server themselves.
What it does well
- Accepts a broad range of document formats
- Exports to multiple document and structured formats
- Offers SDK, HTTP API, CLI, and WebUI
- Remote parsing requires explicit configuration
What to know first
- Higher-throughput local deployments recommend at least 16 GB system memory
- Apple Silicon deployments recommend at least 16 GB unified memory
- Commercial-use thresholds apply under the project license
Limits
The software is free under its project license. Commercial use requires a separate license above 100 million monthly active users or USD 20 million monthly revenue; third-party online services based on MinerU must provide attribution.
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| MinerU open-source software | Free to use under the project license · Commercial license required above 100 million monthly active users or USD 20 million monthly revenue · online services must attribute MinerU | Free |
| Free | $0/ month · 5 free pages every day · files up to 10 MB · images up to 5 MB · PDFs up to 5 pages · web access only, no API | Free |
| Pro · Annual | USD · one-time payment · 1,000 pages every month · files up to 200 MB · images up to 50 MB · PDFs up to 500 pages · API included | $59.90 a year |
| Pro · Monthly | USD · one-time payment · 1,000 pages every month · files up to 200 MB · images up to 50 MB · PDFs up to 500 pages · API included | $9.90 a month |
| On-premise | Talk to us about deployment · models and data run inside your network · dedicated support | On request |
As opendatalab.github.io lists them, read 5 Oct 2026. The maker's own page has the final word.
Getting started
- Visit the MinerU website.
- Choose Linux, macOS, or Windows for installation.
- Select an integration route: Python SDK, V1 HTTP API, command-line tools, or WebUI.
- Choose a parsing tier suited to the quality and compute needs.
- Use local processing, or explicitly configure remote parsing if needed.
Overview
MinerU 4.0 combines document parsing and conversion with a local document library and tools for software and agent integrations. It is best suited to people building document-heavy workflows who need structured outputs and want local processing or a self-hosted service.
Its range of formats and integration routes make it more than a simple converter, but local deployments need careful memory planning, and commercial users should check the license thresholds and attribution conditions.
Key features
MinerU accepts PDFs, images, office and spreadsheet files, EPUB, OFD, HTML and MHTML, and CSV and TSV. Four parsing tiers—Flash, Basic, Standard, and Advanced—offer different quality and compute needs, giving users a way to match processing to their workload rather than committing every file to the same approach.
PDFs can be converted to Markdown, HTML, LaTeX, DOCX, EPUB, PDF, Structured Content, and Content List V1/V2. OCR and batch conversion are supported. This breadth is useful when the goal is structured, reusable content rather than a straightforward format swap; images and other supported documents also have documented export options.
The local document library can discover files, cache parse results, search content, continue from a page or block, and preserve citation locators. Those capabilities favor ongoing research or document-processing work over occasional single-file conversion.
Integration options include a Python SDK, V1 HTTP API, command-line tools, and a Gradio-based WebUI. MinerU also supports MCP and agent frameworks, with export to Dify and Notion. That makes it a plausible fit for workflows that need document parsing inside other tools, though users who only need a quick conversion may not need this much machinery.
Pricing
MinerU open-source software: free. The software is free to use under the project license, and the free plan has no stated conversion quota or seat cap in the plan terms. Commercial use does not require a separate license unless monthly active users exceed 100 million or monthly revenue exceeds USD 20 million. Online services based on MinerU must attribute the project.
The official site also links to online use and describes a cloud service, but no price is provided for that service. Users considering hosted processing should confirm its terms before choosing it over a local deployment.
Platforms
MinerU supports web, Windows, macOS, Linux, API, and self-hosted use. The quick start provides installation instructions for Linux, macOS, and Windows. Documents are not automatically uploaded to the official service; remote parsing requires explicit configuration. The documentation also describes running a local WebUI and V1 API server, or connecting the SDK to a self-hosted API.
For higher-throughput local deployments, the documentation recommends at least 16 GB of system memory; Apple Silicon users are advised to have at least 16 GB of unified memory. That makes local control attractive for privacy-conscious workflows, but less suitable for machines that cannot meet the memory guidance.
Who it's for
MinerU is a strong candidate for developers, researchers, and teams that need to parse varied documents into structured formats, maintain a searchable local library, or connect parsing to applications and agents. It is less compelling for someone seeking only a lightweight online converter, particularly if local hardware is limited or the integration features would go unused.
Pros and cons
- Pros: Broad input and output support serves workflows that need to turn mixed document collections into reusable content.
- Pros: Local processing, self-hosted services, and multiple integration routes offer control over where parsing happens and how it fits into a workflow.
- Pros: The local library combines search and cached results with page- or block-level continuation and citation locators.
- Cons: Higher-throughput local use has substantial memory guidance, which can rule out modest machines.
- Cons: Cloud-service pricing is not provided; users who prefer hosted processing need to establish its cost and terms.
- Cons: Commercial use has thresholds, and online services based on MinerU must provide attribution.
Alternatives
For a broad comparison of conversion tools, start with PDF Converter Software.
- HiPDF may suit readers who prefer a freemium service with web access, OCR, and batch processing; its Basic plan is $39.95 a year.
- PDF Agile is another freemium option, with a free plan capped at 2 pages and 5 conversion tasks.
- Docling is worth considering for a free, MIT-licensed local library that can work offline after model download.
- FoxyUtils Online PDF Tools may be a better fit for web-only PDF work; its Monthly plan costs $5.99 a month and includes OCR.
- Adobe PDF Services API offers a free tier with 500 document transactions per month and paid plans with custom pricing.
- Online2PDF is a free web option for conversions within its file and batch limits: up to 250 MB per file and total conversion, and up to 30 files.
- Convertio may suit users looking for a freemium converter with a Lite plan that allows 1 GB files and 1,000 conversion credits per month for $11.99 a month.
- JPG To PDF is another alternative.
Verdict
Choose MinerU if you need a free, flexible foundation for parsing diverse documents into structured outputs, especially when local processing, self-hosting, or application and agent integration matters. Look elsewhere if you want a simple hosted converter or cannot accommodate the memory needs of a higher-throughput local setup.
Verdict
MinerU supports document parsing and conversion across a wide range of formats, with both local and integration-oriented tools. Review the memory guidance and license conditions when planning a deployment.
Questions
How much does MinerU cost?
The open-source software is listed as free. The official site also links to a cloud service, but no price is stated for that service.
Is MinerU open source?
Yes. The project is open source and governed by its project license.
What platforms does MinerU support?
The listed platforms are API, Linux, macOS, self-hosted, web, and Windows. Installation instructions cover Linux, macOS, and Windows.
Does MinerU have an API?
Yes. It provides a V1 HTTP API, a Python SDK, command-line tools, and a Gradio-based WebUI.
Does MinerU send documents to its service automatically?
No. Documents are not automatically uploaded to the official service; remote parsing requires explicit configuration.
What are the commercial license terms?
A separate commercial license is required above 100 million monthly active users or USD 20 million monthly revenue. Third-party online services based on MinerU must attribute it.
Facts from MinerU's own pages
- Agent integrations
- The official site says MinerU supports the MCP protocol and agent frameworks, and offers export to Dify and Notion. · mineru.net, 5 Oct 2026
- API network limitation
- The hosted create-task API documentation warns that URLs hosted on GitHub, AWS and other overseas services may time out. · mineru.net, 15 Oct 2026
- API rate limits
- The hosted service documents 300 submit requests per minute, 1,000 result queries per minute and up to 10,000 files per day, subject to dynamic adjustment. · mineru.net, 15 Oct 2026
- Changelog license change
- Release 3.1.0 dated April 18, 2026 changed the project from AGPLv3 to the custom Apache-2.0-based MinerU Open Source License. · opendatalab.github.io, 15 Oct 2026
- Cloud lightweight API
- The Agent Lightweight API requires no login but is IP-rate-limited, handles one file up to 10 MB and 20 pages, and returns Markdown only. · mineru.net, 15 Oct 2026
- Cloud precision API
- The Precision Extract API requires a token, accepts files up to 200 MB and 600 pages, batches up to 200 files, and returns ZIP results with Markdown and JSON plus optional DOCX, HTML or LaTeX. · mineru.net, 15 Oct 2026
- Company headquarters and size
- Crunchbase lists OpenDataLab as a private for-profit organization headquartered in Shanghai with 51–100 employees. · crunchbase.com, 15 Oct 2026
- Company identity
- OpenDataLab's official site identifies it as the Data Platform Center of Shanghai Artificial Intelligence Laboratory and the maker of MinerU. · opendatalab.github.io, 15 Oct 2026
- Developer tooling
- Official tooling includes a Python SDK, V1 HTTP API, stateless batch conversion, multi-service Router and Gradio WebUI. · opendatalab.github.io, 15 Oct 2026
- Docker support
- The documented Docker workflow targets Linux NVIDIA GPUs and Windows WSL2; macOS Docker has no MPS acceleration and non-NVIDIA deployment is pending. · opendatalab.github.io, 15 Oct 2026
- Document library
- Its library discovers and caches files, supports content search and continuation by page or block, and preserves stable citation locators. · opendatalab.github.io, 15 Oct 2026
- Export formats
- The document model supports Markdown, HTML, LaTeX, DOCX, EPUB, PDF, Structured Content and Content List V1/V2 outputs. · opendatalab.github.io, 15 Oct 2026
- Hardware requirements
- The docs recommend at least 16 GB system memory for higher-throughput local deployments and at least 16 GB unified memory for Apple Silicon. · opendatalab.github.io, 5 Oct 2026
- Hosted service
- The official site links to online use and describes an official cloud service, but the opened pages did not state its pricing. · mineru.net, 5 Oct 2026
- Input formats
- Supported inputs include PDF, images, DOC/DOCX, PPT/PPTX, XLS/XLSX, RTF, OpenDocument, EPUB, OFD, HTML/MHTML and CSV/TSV. · opendatalab.github.io, 15 Oct 2026
- Installation
- The base package is installed with mineru>=4.0,<5 and includes the WebUI, ONNX runtime and llama.cpp VLM. · opendatalab.github.io, 15 Oct 2026
- Institution founding
- LinkedIn lists Shanghai Artificial Intelligence Laboratory as founded in 2020, headquartered in Shanghai, with 201–500 employees. · linkedin.com, 15 Oct 2026
- Integration
- MinerU provides a Python SDK, V1 HTTP API, command-line tools, and a Gradio-based WebUI. · opendatalab.github.io, 5 Oct 2026
- License
- MinerU uses a custom MinerU Open Source License based on Apache 2.0, with attribution requirements and a separate commercial-license trigger above 100 million monthly active users or 20 million USD monthly revenue. · github.com, 15 Oct 2026
- License terms
- The project license permits commercial use without a separate license unless monthly active users exceed 100 million or monthly revenue exceeds USD 20 million, and requires attribution for third-party online services based on MinerU. · github.com, 5 Oct 2026
- Limit: active defect areas
- The repository bug list includes reports involving Apple MPS OCR falling back to CPU, formula and punctuation errors, figure provenance, table extraction and Arabic recognition/order. · github.com, 15 Oct 2026
- Limit: backend quality gap
- DocuOCR reports the CPU pipeline backend at 86.47 on the same benchmark, about 8.92 points below the VLM result. · docuocr.com, 15 Oct 2026
- Limit: CPU timeout
- A closed GitHub issue reports that pure CPU mode could not finish PDFs over 200 pages before timing out. · github.com, 15 Oct 2026
- Limit: hosted throughput
- DocuOCR says hosted accounts receive 1,000 pages per day at highest priority and lower priority thereafter, with 200 MB and 200-page per-file limits. · docuocr.com, 15 Oct 2026
Where MinerU stands on Freedom251
- PDF Converter Software#1 of 47
- PDF converters#1 of 22
