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.
Compatibility is pinned to the MinerU 3.4.4 vlm-http-client transport
baseline. See the compatibility contract and
Chinese usage guide and English usage guide.
This is not a full MinerU compatibility claim.
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.