MinerU Rust
Rust client library, command-line tools, and local API server for parsing PDF, image, and Office documents with an external OpenAI-compatible MinerU VLM service. PDF rendering uses pure Rust; no model is downloaded or run locally.
Within the MinerU 3.4.4 VLM scope, MinerU Rust is a drop-in replacement for the
MinerU Python SDK's vlm-http-client path and can replace that VLM workflow
completely. It does not implement or claim compatibility with non-VLM backends.
See the compatibility contract, the
Chinese usage guide, and the English usage guide.
Document-limit controls and their CLI/API applicability are summarized in the usage guides.
Requires Rust 1.89 or newer.
Rust library
use ;
async
CLI and API server
The package installs the mineru, mineru-api, mineru-vlm, and
mineru-vlm-api binaries. To also install the mineru-office-convert Office
conversion helper, build with --features office:
See the Chinese usage guide or English usage guide for service configuration and complete options.
Python
Wheels support CPython 3.9 and newer:
The wheel installs two equivalent console commands, mineru and mineru-rs,
both entering mineru_rs._cli:main. The mineru-rs name makes
uvx mineru-rs --help work without a local checkout. Prefer mineru-rs when
the upstream Python mineru package is also installed, since both provide a
mineru entry point and the one earlier on PATH wins.
Python currently exposes only canonical stem handling and PDF-option validation. It does not expose asynchronous document parsing. Releases are wheels only; there is no sdist or source fallback for unsupported platforms or PyPy.
Node.js
The root package installs two equivalent binaries, mineru and mineru-rs,
both pointing at bin/mineru.js, so node_modules/.bin/mineru-rs is available
after install. The six platform packages intentionally ship no binary. Prefer
mineru-rs if another mineru command is already on PATH.
const mineru = require
console.log
mineru.
Node.js currently exposes only canonical stem handling and PDF-option validation. It does not expose asynchronous document parsing. Node.js 18 or newer is required.
License
Licensed under either Apache-2.0 or MIT, at your option.