ErrLookup › opendatalab/MinerU
opendatalab/MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows. · Python · 219 source files
Analyzed at 4fe4bde114 on 2026-08-14. 114 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Unsupported file type | http | error | mineru, fastapi, http-400, upload, file-format |
| Publicly exposed API disables *-http-client backends and… | http | error | mineru, ssrf, security, http-400, deployment |
| ak, sk or endpoint not found in | exception | error | config, s3, credentials, mineru |
| PDF image rendering timeout after | exception | error | pdf, timeout, rendering, performance, mineru |
| Language not supported | validation | error | ocr, validation, language, mineru |
| Unsupported office suffix | validation | error | mineru, office-documents, file-format, validation |
| Failed to download model | exception | error | model-download, network, huggingface, modelscope, mineru |
| Task wait handle is unavailable | exception | warning | mineru, fastapi, task-management, race-condition, internal-error |
| model source auto is only supported for internal default… | validation | error | config, model-download, mineru |
| Invalid XLSX package: file is not a ZIP archive. | validation | error | xlsx, file-format, zip, validation, mineru |
| must be a JSON object | validation | error | mineru, json, schema, worker-communication, version-mismatch |
| Unknown process_mode | exception | error | mineru, backend-selection, validation, cli |
| Language not supported. Allowed values | validation | error | ocr, validation, language, mineru |
| Invalid latex delimiters type | validation | error | mineru, gradio, configuration, latex, validation |
| Unsupported protocol_version= | validation | error | mineru, version-mismatch, protocol, worker-communication, upgrade |
| =auto is not supported. Unset to use auto detection once… | validation | error | environment-variable, model-download, config, mineru |
| Local path for repo_mode | validation | error | config, model-download, offline, mineru |
| Failed to load file | exception | error | mineru, fastapi, file-io, race-condition, cleanup |
| Task manager is shutting down | exception | warning | mineru, fastapi, shutdown, task-management, retryable |
| max_concurrent_requests must be a positive integer | validation | error | mineru, health-check, validation, worker-communication, schema |
| max_size = must be strictly greater than the requested size… | validation | error | image-processing, configuration, formula-recognition |
| is not valid JSON | validation | error | mineru, httpx, json, proxy, worker-communication |
| Timed out waiting for local worker | exception | error | mineru, timeout, startup, model-download, worker-communication |
| Unknown backend type | validation | error | mineru, cli, backend-selection, validation, output-paths |
| Invalid image mode. Please provide 'rgb' or 'bgr'. | validation | error | image-processing, validation, opencv, mineru |
| Invalid backend. Allowed values | http | error | api, http-400, validation, backend |
| NPU is selected as device, but torch_npu is not available… | exception | critical | npu, ascend, environment, torch-npu, device |
| Found a in the saved `added_tokens_decoder`, should be a… | validation | error | tokenizer, configuration, model-loading, version-compat |
| module has no attribute | exception | error | python, imports, lazy-import, pep-562, api-surface |
| S3 reader/writer requires optional dependencies. Install… | exception | error | s3, dependencies, optional-deps, boto3, lazy-import |
| Invalid scale , must be positive. | exception | error | table-recognition, image-resize, validation, valueerror |
| Unsupported hybrid effort | validation | error | hybrid, internal, defensive, effort |
| Unsupported lmdeploy device type | validation | error | lmdeploy, vlm, device, hardware, configuration |
| Local worker exited before becoming healthy | exception | critical | mineru, subprocess, startup, environment, worker-crash |
| Unsupported repo_mode | validation | error | model-download, validation, mineru |
| S3 IO requires optional dependencies. Install them with… | exception | error | s3, dependencies, boto3, optional-deps, lazy-import |
| Task manager is not initialized | http | error | mineru, fastapi, lifespan, initialization, http-503 |
| config._name_or_path is required by UnimernetModel. | exception | critical | model-loading, configuration, formula-recognition |
| Please install vllm to use the vllm-async-engine backend. | exception | error | vllm, dependency, import, vlm, async-engine |
| ` ` requires local pipeline dependencies… | exception | error | dependencies, hybrid, torch, installation |
| Input image ( , ) smaller than the target size ( , ). | validation | error | table-recognition, image-processing, validation |
| backend= requires server_url | validation | error | configuration, http-client, backend, server-url |
| images_mfd_res and images must have the same length. | validation | error | formula-recognition, validation, batching, api-misuse |
| The hidden size ( ) is not a multiple of the number of… | validation | error | pytorch, deep-learning, config, transformer, layout-model |
| Invalid MINERU_API_MAX_CONCURRENT_REQUESTS value | validation | error | environment-variable, config, api-client, mineru |
| does not exists. | exception | error | model-loading, onnx, table-recognition, deployment |
| No healthy upstream MinerU API servers are available | exception | critical | mineru, router, startup, health-check, upstream |
| Unsupported middle json backend for client-side output… | validation | error | client-side, middle-json, backend, rendering |
| Attention mask batch size | validation | error | pytorch, deep-learning, shape-mismatch, batching, attention-mask |
| Please install lmdeploy to use the lmdeploy-engine backend. | exception | error | lmdeploy, dependency, import, vlm, engine |
| Input path does not exist | validation | error | filesystem, input-validation, path |
| Please install transformers to use the transformers backend. | exception | error | transformers, dependency, import, vlm, backend |
| pdf_bytes_list, image_writer_list, and lang_list must have… | validation | error | pipeline, precondition, batching, validation |
| The function 'replace_sub()' is deprecated, please use… | exception | warning | ocr, backbone, pphgnet, deprecated-api, migration |
| Unsupported image shape for UnimerSwinImageProcessor | validation | error | image-processing, validation, formula-recognition |
| Legacy binary PPT files are not supported; convert the file… | validation | error | pptx, file-format, document-parsing |
| Unsupported image type for PP-DocLayoutV2 | validation | error | pytorch, image-processing, type-error, layout-model |
| Input path must be a file or directory | validation | error | filesystem, input-validation, path |
| Scale must be a number or tuple of int, but got | exception | error | table-recognition, image-resize, typeerror, type-validation |
| PP-DocLayoutV2 reading-order mask must be 2D or 4D, got… | validation | error | pytorch, deep-learning, shape-mismatch, layout-model, attention-mask |
| Unsupported PP-DocLayoutV2 label | validation | error | layout-model, labels, validation, postprocessing |
| Unsupported header/footer label | validation | error | layout-model, labels, validation, header-footer |
| Unsupported activation | exception | error | ocr, backbone, lcnet, activation, config, valueerror |
| Unsupported input file type | validation | error | input-validation, file-type, format |
| bucket name: not found in s3_configs | validation | error | s3, config, validation, reader |
| effort must be "medium" or "high" | validation | error | hybrid, validation, configuration, effort |
| is not a file. | exception | error | model-loading, onnx, file-path, table-recognition |
| Unsupported lmdeploy backend | validation | error | vlm, lmdeploy, backend, environment-variable, validation |
| OCR_INFERENCE_PRECISION must be one of: auto, fp32, fp16 | exception | error | ocr, pytorch, precision, environment-variable, validation |
| Shape of table bounding boxes is not between in 4 or 8. | exception | error | table-recognition, visualization, shape-validation, valueerror |
| Missing middle json file | exception | error | client-side, middle-json, file-not-found, artifacts |
| default_prefix must be provided | validation | error | s3, config, validation, constructor |
| is not supported in MultiHead yet | exception | error | ocr, recognition, multi-head, config, not-implemented |
| PP-DocLayoutV2 reading-order inference requires a mask… | validation | error | pytorch, deep-learning, required-argument, layout-model |
| not support limit type, image | exception | error | ocr, detection, preprocessing, config, validation |
| Unsupported formula label | validation | error | layout-model, labels, validation, formula |
| PPDocLayoutV2ForObjectDetection only supports inference. | validation | error | pytorch, deep-learning, inference-only, object-detection, layout-model |
| cannot identify image file | exception | error | image-processing, file-corruption, pillow, table-recognition |
| Invalid parse_method. Allowed values | http | error | api, http-400, validation, parse-method |
| CUDA is not available. | validation | error | cuda, lmdeploy, vlm, environment, device |
| the bucket_name in s3_configs | validation | error | s3, config, validation, duplicate-keys |
| local_max and server_max must both be positive integers | validation | error | concurrency, validation, api-client |
| mlx-engine backend is only supported on macOS 13.5+ with… | exception | error | mlx, macos, apple-silicon, platform, backend |
| {exc.detail} | http | error | mineru, router, upstream, http, pass-through |
| Unknown file suffix | exception | error | file-format, input-validation, parsing, unsupported-type |
| Unsupported operating system. | validation | error | lmdeploy, os-support, vlm, platform |
| has no Architecture | validation | error | ocr, config, yaml, schema, valueerror |
| The mixer must be one of [Global, Local, Conv] | exception | error | ocr, backbone, svtr, config, typeerror |
| The provided path starts with '/'. This does not conform to… | validation | error | s3, path, validation |
| default_bucket: config must be provided in s3_configs | validation | error | s3, config, validation, constructor |
| architecture is not in arch_config.yaml | validation | error | ocr, model-loading, config-mapping, valueerror |
| Invalid S3 path format. Expected 's3://bucket-name/key' or… | validation | error | s3, path, validation |
| middle_json must be a dict. | validation | error | client-side, middle-json, schema, validation |
| middle_json must contain a list field named pdf_info. | validation | error | client-side, middle-json, schema, validation |
| The channel( ) of the img is not in [1, 2, 3, 4] | exception | error | image-processing, numpy, validation, table-recognition |
| Invalid submit payload | exception | error | mineru, router, upstream, failover, validation |
| Invalid PPTX package: file is not a ZIP archive. | validation | error | pptx, file-format, zip, document-parsing |
| No supported files found in directory | validation | error | filesystem, input-validation, directory |
| Local API server is already running | exception | error | lifecycle, api-server, subprocess, state |
| PPLCNetV4 model_size must be one of , got . | exception | error | ocr, backbone, lcnet, model-size, config, valueerror |