leecoursey/mineru-gui

MinerU Archival GUI is a locally hosted web interface built on top of MinerU, a document processing tool. Instead of handling large batches of files, this GUI is built for a different job: taking one document at a time, checking its page count, running MinerU on it, watching the command output live, and reviewing the results afterward. It grew out of a personal need to make occasional archival scans of older industry references searchable and easier to reuse, so it favors a clear, visible workflow over automation at scale. The interface supports drag and drop uploads, automatic page range detection, controls for MinerU's backend and processing options, a live output log, and a history of recent jobs. Generated files appear in a compact file tree with direct downloads, and completed jobs can automatically clean up temporary working copies while keeping the final markdown, images, and content files. It also includes both a light mode and a dark mode. This project only provides the GUI layer. It does not include MinerU itself or its models, so you need Docker with Compose support and a working MinerU container image already set up separately, following MinerU's own installation instructions. It is designed to run on Windows with Docker Desktop or WSL2, or on Linux with Docker Engine, and optionally supports NVIDIA GPU acceleration through the NVIDIA Container Toolkit. macOS is not currently tested or supported. Once MinerU is installed, starting the app is a matter of running a provided script for your platform, which launches the service on localhost only, since the app has no built in authentication. All processed documents and job data stay in a local data folder that is excluded from version control. The project describes itself as an early, experimental release extracted from a working personal setup, and the GUI source code is released under the Apache License 2.0, separate from MinerU's own licensing terms.