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. 128 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Input path does not exist: {path} | validation | error | filesystem, input-validation, path |
| Unsupported input file type: {path.name} | validation | error | input-validation, file-type, format |
| Input path must be a file or directory: {path} | validation | error | filesystem, input-validation, path |
| No supported files found in directory: {path} | validation | error | filesystem, input-validation, directory |
| backend={backend} requires server_url | validation | error | configuration, http-client, backend, server-url |
| effort must be "medium" or "high" | validation | error | hybrid, validation, configuration, effort |
| Unsupported hybrid effort: {effort} | validation | error | hybrid, internal, defensive, effort |
| NPU is selected as device, but torch_npu is not available. P | exception | critical | npu, ascend, environment, torch-npu, device |
| pdf_bytes_list, image_writer_list, and lang_list must have t | validation | error | pipeline, precondition, batching, validation |
| NPU is selected as device, but torch_npu is not available. P | exception | critical | npu, ascend, environment, torch-npu, batch, device |
| CUDA is not available. | validation | error | cuda, lmdeploy, vlm, environment, device |
| Unsupported operating system. | validation | error | lmdeploy, os-support, vlm, platform |
| Unsupported lmdeploy device type: {device_type} | validation | error | lmdeploy, device, validation, configuration |
| Please install vllm to use the vllm-async-engine backend. | exception | error | vllm, dependency, import, vlm, async-engine |
| Please install transformers to use the transformers backend. | exception | error | transformers, dependency, import, vlm, backend |
| mlx-engine backend is only supported on macOS 13.5+ with App | exception | error | mlx, macos, apple-silicon, platform, backend |
| Please install vllm to use the vllm-engine backend. | exception | error | vllm, dependency, import, vlm, engine |
| Please install vllm to use the vllm-async-engine backend. | exception | error | vllm, dependency, import, vlm, async-engine |
| Please install lmdeploy to use the lmdeploy-engine backend. | exception | error | lmdeploy, dependency, import, vlm, engine |
| Unsupported lmdeploy device type: {device_type} | validation | error | lmdeploy, vlm, device, hardware, configuration |
| Unsupported lmdeploy backend: {lm_backend} | validation | error | lmdeploy, vlm, backend, configuration |
| Local API server is already running | exception | error | lifecycle, api-server, subprocess, state |
| local_max and server_max must both be positive integers | validation | error | concurrency, validation, api-client |
| Invalid parse_method. Allowed values: {allowed_values} | http | error | api, http-400, validation, parse-method |
| Invalid backend. Allowed values: {allowed_values} | http | error | api, http-400, validation, backend |
| Invalid effort. Allowed values: {allowed_values} | http | error | api, http-400, validation, hybrid, effort |
| Language {lang} not supported. Allowed values: {allowed_valu | http | error | api, http-400, validation, ocr, language |
| Invalid backend. Allowed values: {allowed_values} | validation | error | cli, validation, backend, configuration |
| Invalid effort. Allowed values: {allowed_values} | validation | error | cli, validation, hybrid, effort |
| max_concurrent_requests must be a positive integer | validation | error | cli, concurrency, validation |
| Unsupported middle json backend for client-side output gener | validation | error | client-side, middle-json, backend, rendering |
| Missing middle json file: {middle_json_path} | exception | error | client-side, middle-json, file-not-found, artifacts |
| 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 |
| `{backend}` requires local pipeline dependencies (`mineru[pi | exception | error | dependencies, hybrid, torch, installation |
| Unknown file suffix: {file_suffix} | exception | error | file-format, input-validation, parsing, unsupported-type |
| Unknown process_mode: {process_mode} | exception | error | mineru, backend-selection, validation, cli |
| Unsupported office suffix: {file_suffix} | validation | error | mineru, office-documents, file-format, validation |
| Unsupported file type: {file_suffix} | http | error | mineru, fastapi, http-400, upload, file-format |
| Failed to load file {upload.original_name}: {exc} | exception | error | mineru, fastapi, file-io, race-condition, cleanup |
| Task wait handle is unavailable | exception | warning | mineru, fastapi, task-management, race-condition, internal-error |
| Task manager is shutting down | exception | warning | mineru, fastapi, shutdown, task-management, retryable |
| Task manager is not initialized | http | error | mineru, fastapi, lifespan, initialization, http-503 |
| Invalid latex delimiters type: {latex_delimiters_type}. | validation | error | mineru, gradio, configuration, latex, validation |
| Unknown backend type: {backend} | validation | error | mineru, cli, backend-selection, validation, output-paths |
| Publicly exposed API disables *-http-client backends and ser | http | error | mineru, ssrf, security, http-400, deployment |
| {payload_name} is not valid JSON | validation | error | mineru, httpx, json, proxy, worker-communication |
| {payload_name} must be a JSON object | validation | error | mineru, json, schema, worker-communication, version-mismatch |
| Local worker {server_id} exited before becoming healthy | exception | critical | mineru, subprocess, startup, environment, worker-crash |
| Timed out waiting for local worker {server_id} to become hea | exception | error | mineru, timeout, startup, model-download, worker-communication |
| Unsupported protocol_version={protocol_version}, expected {A | validation | error | mineru, version-mismatch, protocol, worker-communication, upgrade |
| max_concurrent_requests must be a positive integer | validation | error | mineru, health-check, validation, worker-communication, schema |
| No healthy upstream MinerU API servers are available | exception | critical | mineru, router, startup, health-check, upstream |
| MinerU upstream returned an invalid submit payload | validation | error | mineru, router, validation, upstream, json |
| Invalid submit payload: {exc} | exception | error | mineru, router, upstream, failover, validation |
| {exc.detail} | http | error | mineru, router, upstream, http, pass-through |
| {detail} | http | error | mineru, router, upstream, result-download, pass-through |
| module {__name__!r} has no attribute {name!r} | exception | error | mineru, python, import, attributeerror, api-mismatch |
| S3 reader/writer requires optional dependencies. Install the | exception | error | s3, dependencies, optional-deps, boto3, lazy-import |
| default_prefix must be provided | validation | error | s3, config, validation, constructor |
| default_bucket: {self.default_bucket} config must be provide | validation | error | s3, config, validation, constructor |
| the bucket_name in s3_configs: {s3_configs} must be unique | validation | error | s3, config, validation, duplicate-keys |
| bucket name: {bucket_name} not found in s3_configs: {self.s3 | validation | error | s3, config, validation, reader |
| module {__name__!r} has no attribute {name!r} | exception | error | python, imports, lazy-import, pep-562, api-surface |
| S3 IO requires optional dependencies. Install them with `pip | exception | error | s3, dependencies, boto3, optional-deps, lazy-import |
| The provided path starts with '/'. This does not conform to | validation | error | s3, path, validation |
| Invalid S3 path format. Expected 's3://bucket-name/key' or ' | validation | error | s3, path, validation |
| PP-DocLayoutV2 reading-order mask must be 2D or 4D, got shap | validation | error | pytorch, deep-learning, shape-mismatch, layout-model, attention-mask |
| Attention mask batch size {attention_mask.shape[0]} does not | validation | error | pytorch, deep-learning, shape-mismatch, batching, attention-mask |
| The hidden size ({config.hidden_size}) is not a multiple of | validation | error | pytorch, deep-learning, config, transformer, layout-model |
| PP-DocLayoutV2 reading-order inference requires a mask tenso | validation | error | pytorch, deep-learning, required-argument, layout-model |
| PPDocLayoutV2ForObjectDetection only supports inference. | validation | error | pytorch, deep-learning, inference-only, object-detection, layout-model |
| Unsupported image type for PP-DocLayoutV2: {type(image)} | validation | error | pytorch, image-processing, type-error, layout-model |
| Unsupported PP-DocLayoutV2 label: {label} | validation | error | layout-model, labels, validation, postprocessing |
| Unsupported formula label: {label} | validation | error | layout-model, labels, validation, formula |
| Unsupported header/footer label: {label} | validation | error | layout-model, labels, validation, header-footer |
| images_mfd_res and images must have the same length. | validation | error | formula-recognition, validation, batching, api-misuse |
| max_size = {max_size} must be strictly greater than the requ | validation | error | image-processing, configuration, formula-recognition |
| Found a {token.__class__} in the saved `added_tokens_decoder | validation | error | tokenizer, configuration, model-loading, version-compat |
| images_mfd_res and images must have the same length. | validation | error | api-contract, formula-recognition, validation |
| config._name_or_path is required by UnimernetModel. | exception | critical | model-loading, configuration, formula-recognition |
| Unsupported image shape for UnimerSwinImageProcessor: {image | validation | error | image-processing, validation, formula-recognition |
| Language {lang} not supported | validation | error | ocr, configuration, validation |
| Legacy binary PPT files are not supported; convert the file | validation | error | pptx, file-format, document-parsing |
| Invalid PPTX package: file is not a ZIP archive. | validation | error | pptx, file-format, zip, document-parsing |
| Input image ({w}, {h}) smaller than the target size ({cw}, { | validation | error | table-recognition, image-processing, validation |
| {model_path} does not exists. | exception | error | model-loading, onnx, table-recognition, deployment |
| {model_path} is not a file. | exception | error | model-loading, onnx, file-path, table-recognition |
| Input must be a pillow object or a numpy array. | exception | error | table-recognition, type-validation, api-contract |
| The img type {type(img)} does not in {InputType.__args__} | exception | error | image-processing, type-validation, table-recognition |
| cannot identify image file {img} | exception | error | image-processing, file-corruption, pillow, table-recognition |
| {type(img)} is not supported! | exception | error | image-processing, api-misuse, table-recognition |
| The channel({channel}) of the img is not in [1, 2, 3, 4] | exception | error | image-processing, numpy, validation, table-recognition |
| The ndim({img.ndim}) of the img is not in [2, 3] | exception | error | image-processing, numpy, batch, table-recognition |
| {file_path} does not exist. | exception | error | file-path, image-processing, table-recognition |
| backend: {backend} is not supported for resize.Supported bac | exception | error | image-processing, configuration, table-recognition, validation |
| Invalid scale {scale}, must be positive. | exception | error | table-recognition, image-resize, validation, valueerror |
| Scale must be a number or tuple of int, but got {type(scale) | exception | error | table-recognition, image-resize, typeerror, type-validation |
| Shape of table bounding boxes is not between in 4 or 8. | exception | error | table-recognition, visualization, shape-validation, valueerror |
| OCR_INFERENCE_PRECISION must be one of: auto, fp32, fp16 | exception | error | ocr, pytorch, precision, environment-variable, validation |
| {} is not existed. | exception | critical | ocr, weights, file-not-found, model-loading |
| not support limit type, image | exception | error | ocr, detection, preprocessing, config, validation |
| mode[{model_name}_model] is not implemented! | exception | error | ocr, backbone, mobilenet, config, not-implemented |
| mode[{model_name}_model] is not implemented! | exception | error | ocr, backbone, mobilenet, recognition, config, not-implemented |
| Unsupported activation: {name} | exception | error | ocr, backbone, lcnet, activation, config, valueerror |
| PPLCNetV4 only supports 3 input channels, got {in_channels}. | exception | error | ocr, backbone, lcnet, input-channels, valueerror |
| PPLCNetV4 {mode} model_size must be one of {list(config_dict | exception | error | ocr, backbone, lcnet, model-size, config, valueerror |
| The function 'replace_sub()' is deprecated, please use 'upgr | exception | warning | ocr, backbone, pphgnet, deprecated-api, migration |
| The mixer must be one of [Global, Local, Conv] | exception | error | ocr, backbone, svtr, config, typeerror |
| {name} is not supported in MultiHead yet | exception | error | ocr, recognition, multi-head, config, not-implemented |
| {} is not existed. | exception | critical | ocr, config, yaml, file-not-found |
| {} has no Architecture | validation | error | ocr, config, yaml, schema, valueerror |
| {} is not found. | exception | critical | ocr, weights, file-not-found, model-loading |
| architecture {file_name} is not in arch_config.yaml | validation | error | ocr, model-loading, config-mapping, valueerror |
| Unsupported lmdeploy device type: {device_type} | validation | error | vlm, lmdeploy, device, environment-variable, validation |
| Unsupported lmdeploy backend: {lm_backend} | validation | error | vlm, lmdeploy, backend, environment-variable, validation |
| Invalid XLSX package: file is not a ZIP archive. | validation | error | xlsx, file-format, zip, validation, mineru |
| ak, sk or endpoint not found in {CONFIG_FILE_NAME} | exception | error | config, s3, credentials, mineru |
| Invalid MINERU_API_MAX_CONCURRENT_REQUESTS value: {value}. E | validation | error | environment-variable, config, api-client, mineru |
| {MODEL_SOURCE_ENV_VAR}=auto is not supported. Unset {MODEL_S | validation | error | environment-variable, model-download, config, mineru |
| model source auto is only supported for internal default det | validation | error | config, model-download, mineru |
| Unsupported repo_mode: {repo_mode}, must be 'pipeline' or 'v | validation | error | model-download, validation, mineru |
| Local path for repo_mode '{repo_mode}' is not configured. | validation | error | config, model-download, offline, mineru |
| Failed to download model: {relative_path} from {repo} | exception | error | model-download, network, huggingface, modelscope, mineru |
| Language {lang} not supported. Allowed values: {PUBLIC_OCR_L | validation | error | ocr, validation, language, mineru |
| Language {lang} not supported | validation | error | ocr, validation, language, mineru |
| PDF image rendering timeout after {timeout}s for pages {star | exception | error | pdf, timeout, rendering, performance, mineru |
| Invalid image mode. Please provide 'rgb' or 'bgr'. | validation | error | image-processing, validation, opencv, mineru |