A user-friendly PDF-to-Markdown conversion tool based on Mineru.
A user-friendly PDF-to-Markdown conversion tool based on Mineru.
Language: English | 中文
MinerU Web is a web application for document parsing and result review. It provides file upload, asynchronous parsing, original file preview, Markdown preview, PDF source tracing, Popo-enhanced result comparison, and Markdown export. The current version targets MinerU 3.4.4. The business backend now calls the official MinerU HTTP service instead of depending on MinerU internal Python APIs.
Current release: v3.4.4.
mineru-router for unified multi-GPU schedulingDATABASE_URL (SQLite remains the default)Create the environment file:
cp .env.example .envEdit .env and set a MinIO endpoint that can be reached by both the browser and containers, for example:
MINIO_ENDPOINT=SERVER_IP:9000
WORKER_REPLICAS=1
WORKER_CONCURRENCY=1Linux / server deployment:
docker compose --env-file .env -f docker-compose.yml up -dmacOS Apple Silicon deployment:
docker compose --env-file .env -f docker-compose.mac.yml up -d --buildAfter startup, open:
http://SERVER_IP:8088http://SERVER_IP:8000http://SERVER_IP:8002http://SERVER_IP:9001Register an email account on the first visit to start using the app.
For Linux server deployment, macOS Apple Silicon setup, model downloads, MinerU Router, multi-GPU scheduling, MinIO endpoint configuration, and verification commands, see Deployment Guide.
mineru-web/
├── backend/ # FastAPI backend, worker, database models, and tests
├── frontend/ # Vue 3 frontend
├── docs/
│ └── deployment.md # Deployment guide
├── docker-compose.yml # Linux / server deployment
├── docker-compose.mac.yml # macOS host MinerU API deployment
└── README.mdCommon environment variables are listed in .env.example. Full details are in the Deployment Guide.
Frequently used options:
MINIO_ENDPOINT: MinIO address reachable by both browser and containers.WORKER_REPLICAS / WORKER_CONCURRENCY: worker replica count and per-worker concurrency.MINERU_API_USE_ASYNC_TASKS: enable the MinerU /tasks asynchronous API.POPO_ENABLED: enable MinerU-Popo postprocessing.Verification commands are listed in the Deployment Guide.
Common checks:
cd backend
uv run pytest tests -vcd frontend
npm run buildThis project version follows the compatible MinerU version. Current version v3.4.4 corresponds to MinerU 3.4.4:
lpdswing/mineru-web-frontend:v3.4.4lpdswing/mineru-web-backend:v3.4.4lpdswing/mineru-web-mineru-api:v3.4.4Use tag v3.4.4 when publishing the GitHub Release. After the release is published, .github/workflows/docker-build.yml builds and pushes Docker images with the same release tag. If only MinerU Web changes while the compatible MinerU version stays the same, use a suffix such as v3.4.4-web.1.
mineru[core]==3.4.4v3.4.4mineru[core]==3.4.0v3.4.0mineru[core]==3.3.1vlm-engine and hybrid-enginevlm-auto-engine and hybrid-auto-engine settings compatibleeffort=high for MinerU 3.3.1 requests, configurable with MINERU_API_HYBRID_EFFORTThis project is licensed under AGPL-3.0. See LICENSE for details.
No open issues yet, or sync has not completed.