It cannot run normally

[y1342474280]

I installed it via UV, but when using PDF as the input, it immediately gave a failure prompt. Switching to a different PDF results in the same error. The error message doesn't provide more details, so I have no idea where the error is coming from.

$ mineru -p WO2020115501A1-316-330.pdf -o test
2026-03-30 10:09:20.972 | INFO | mineru.cli.client:run_orchestrated_cli:867 - Started local mineru-api at http://127.0.0.1:60187
2026-03-30 10:09:23.413 | INFO | main:create_app:212 - Request concurrency limited to 3
Start MinerU FastAPI Service: http://127.0.0.1:60187
API documentation: http://127.0.0.1:60187/docs
INFO: Started server process [1676172]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:60187 (Press CTRL+C to quit)
2026-03-30 10:09:23.988 | INFO | mineru.cli.client:run_planned_task:769 - Submitting batch 1/1 | 1 document, 15 pages in this batch | 15 pages total | task#1 [WO2020115501A1-316-330]
2026-03-30 10:09:26.107 | INFO | mineru.utils.engine_utils:get_vlm_engine:34 - Using vllm-async-engine as the inference engine for VLM.
Error: 1 task(s) failed while processing documents:

• task#1 (WO2020115501A1-316-330):

[dosubot[bot]]

Hi @y1342474280! I'm Dosu and I’m helping the MinerU team.

The error message is unfortunately not very detailed, but you can get more information by enabling debug logging:

MINERU_LOG_LEVEL=DEBUG mineru -p WO2020115501A1-316-330.pdf -o test

Or use the --log-level debug flag .

Since your log shows you're using vllm-async-engine, here are the most common causes of failures:

1. Missing VLLM_USE_V1 environment variable - MinerU requires this to be explicitly set [1]:

   VLLM_USE_V1=1 mineru -p WO2020115501A1-316-330.pdf -o test

   Note: If you're using a GPU with compute capability < 8.0 (e.g., Tesla T4), this won't work and you'll need to use vllm 0.10.2 instead [2].

2. GPU memory or server errors - The async batch processing has no per-page error tolerance, so any error causes the entire document to fail [3]. Try switching to the pipeline backend:

   mineru -p WO2020115501A1-316-330.pdf -o test -b pipeline

3. CPU inference timeout - If running on CPU, the default 300-second timeout may be too short [4]:

   MINERU_PDF_RENDER_TIMEOUT=600 mineru -p WO2020115501A1-316-330.pdf -o test

Run with debug logging first to see what the actual underlying error is - that will help narrow down which of these solutions applies to your case.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}