Skip to content

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

2.1 KB
Raw Blame

Frequently Asked Questions

If your question is not listed, try using DeepWiki's AI assistant for common issues.

For unresolved problems, join our Discord or WeChat community for support.

??? question "Why is Windows inference slow, or engine installation failing?"

### Windows CUDA acceleration {#windows-cuda-acceleration}

The 4.1 base package can automatically use ONNX DirectML or CPU on Windows x64, with llama.cpp for the VLM. Use `mineru-kit hardware info --json` to inspect the environment and existing calibration evidence. For Torch small models and LMDeploy, install `"mineru[full]>=4.0,<5"` in the owning environment, then check Torch CUDA support, GPU drivers, and the Python range of engine wheels.

The current version uses `lmdeploy>=0.17.0,<0.19` and Transformers 5. Do not reuse old LMDeploy 0.11.x wheel recipes or bypass dependency checks. See [extension modules](../quick_start/extension_modules.md) and [tiers](../usage/tiers.md).

??? question "What changed in commands, APIs, and configuration?"

The 4.x WebUI uses `mineru-kit webui` / `mineru-webui`, parsing APIs use `/v1/*`, and configuration uses `config.yaml`. Old `/file_parse`, `/tasks`, and `model.stack` cannot be reused directly. See [3.x migration](../reference/migration_4.md). The 4.1 release also replaces standalone uploads/jobs with Tasks; see [4.1 migration](../reference/migration_4_1.md) and the standalone [file-parse API](../usage/file_parse.md).

??? question "Encountered the error ImportError: libGL.so.1: cannot open shared object file: No such file or directory in Ubuntu 22.04 on WSL2"

### Encountered the error `ImportError: libGL.so.1: cannot open shared object file: No such file or directory` in Ubuntu 22.04 on WSL2 {#wsl2-ubuntu2204-libgl}

The `libgl` library is missing in Ubuntu 22.04 on WSL2. You can install the `libgl` library with the following command to resolve the issue:

```bash
sudo apt-get install libgl1-mesa-glx
```

Reference: [#388](https://github.com/opendatalab/MinerU/issues/388)