docling-project/docling
Documented errors, page 3 of 4. Back to docling-project/docling
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Nemotron OCR is only supported on Linux. | exception | error | nemotron, ocr, platform, linux |
| rapidocr_models requires with_rapidocr=True | exception | error | model-download, rapidocr, input-validation, ocr |
| Incompatible file format | exception | error | image, api-contract, format-mismatch |
| Model not loaded. Ensure EngineModelConfig was provided… | exception | error | vlm, vllm, configuration, model-not-loaded, runtime-error |
| XBRL loaded with errors | exception | error | xbrl, network, taxonomy, docling |
| Expected ONNX model to return at least 1 output containing… | exception | error | onnx, onnxruntime, empty-output, session-state |
| Phi 4 only works with transformers<4.52.0 but you have | exception | error | transformers, version-conflict, phi-4, vlm |
| The parameters vlm_pipeline_model, vlm_pipeline_model_local… | validation | error | service, vlm, validation, mutual-exclusion, deprecation |
| Archive exceeds maximum member count limit of | exception | error | mets, archive, security, limits, validation |
| No default extraction backend configured for | exception | error | extraction, backend, configuration |
| Failed to load image processor from | exception | error | huggingface, transformers, model-loading, compatibility |
| Tesseract is not available, aborting | exception | error | ocr, tesseract, environment, dependency |
| Expected ApiKserveV2ObjectDetectionEngineOptions, got | validation | error | configuration, factory, type-mismatch, kserve, object-detection |
| No pipeline could be initialized for | exception | error | pipeline, configuration, input-format |
| XPU is not supported by this model. Supported devices | exception | error | xpu, accelerator, configuration, intel-gpu |
| MLX models do not support HuggingFace StoppingCriteria… | exception | error | mlx, stopping-criteria, configuration |
| No class found with the name | exception | error | factory, plugins, runtime-error, registration |
| Could not initialize JATS backend for file with hash | exception | error | jats, xml, document-load, parsing, lxml |
| Could not initialize USPTO backend for file with hash | exception | error | uspto, patents, encoding, document-load, utf-8 |
| Invalid filename: contains null byte. | validation | error | ocr, tesseract, validation, security, injection |
| does not exist or is not a directory containing the… | exception | error | artifacts, filesystem, configuration, vlm |
| The parameters picture_description_local and… | validation | error | service, picture-description, validation, mutual-exclusion, deprecation |
| Playwright is required for HTML rendering. Install it with… | exception | error | html, playwright, rendering, optional-dependency |
| The 'python-docx' package is required to process Word… | exception | error | dependency, install, docx, extras |
| Could not initialize email backend for file with hash | exception | error | email, parsing, corrupt-input |
| Image file exceeds individual file size limit of bytes | exception | error | mets, archive, security, limits, image |
| Cannot specify both picture_description_preset and… | validation | error | service, picture-description, validation, mutual-exclusion |
| Downloaded data exceeds size limit | exception | warning | network, images, size-limit, streaming |
| Too many redirects while downloading artifact. | exception | error | network, redirects, artifact-download, security |
| Invalid value | exception | error | http, kserve, binary-data, truncation, gateway |
| The 'taxonomy' backend option must be a directory | validation | error | xbrl, taxonomy, path-validation, configuration |
| easyocr_languages requires with_easyocr=True | exception | error | model-download, easyocr, input-validation, ocr |
| Expected object-detection model metadata to expose at least… | exception | error | kserve, model-mismatch, metadata, object-detection |
| The 'marko' package is required to process Markdown files… | exception | error | markdown, optional-dependency, installation, importerror |
| Artifact download failed | exception | error | network, timeout, tls, artifact-download |
| Expected OnnxRuntimeObjectDetectionEngineOptions, got | validation | error | configuration, factory, type-mismatch, object-detection |
| Extraction failed for | exception | error | extraction, error-handling, pipeline |
| OCR file exceeds individual file size limit of bytes | exception | error | mets, archive, security, limits, ocr |
| tesserocr is not correctly installed. Please install it via… | exception | error | ocr, tesseract, tesserocr, dependency, environment |
| EasyOCR is not installed. Please install it via `pip… | exception | error | easyocr, ocr, import, dependencies |
| Picture description scale must be > 0 | validation | error | picture-description, configuration, validation, image-scale |
| Unsupported KServe request parameter type for gRPC: key= | exception | error | kserve, grpc, validation, parameters, serialization |
| Unsupported KServe v2 gRPC output datatype | exception | error | grpc, kserve, dtype, binary-data, model-config |
| URL must contain a valid hostname | exception | error | ssrf, url-validation, images, network |
| MPS is not available in the system. Please ensure you are… | exception | error | mps, accelerator, environment, apple-silicon, pytorch |
| Unsupported engine type | validation | error | vlm, factory, configuration, unsupported-operation, version-skew |
| Archive exceeds maximum total extraction size of | exception | error | mets, archive, security, limits, decompression-bomb |
| Cannot specify both picture_classification_preset and… | validation | error | pydantic, validation, configuration, picture-classification, mutually-exclusive |
| mlx-whisper is not installed. Please install it via `pip… | exception | error | asr, mlx, whisper, optional-dependency, apple-silicon |
| Picture description batch_size must be >= 1 | validation | error | picture-description, configuration, validation, batch-size |
| tesserocr is not correctly configured. No language models… | exception | error | ocr, tesseract, tessdata, environment |
| ASR pipeline requires a file path or BytesIO stream, but got | exception | error | asr, whisper, input-type, pathlib |
| Extraction failed because the provided file has no… | exception | error | extraction, input-format, file-naming |
| Nemotron OCR requires CUDA 13.x, but the current PyTorch… | exception | error | nemotron, ocr, cuda, pytorch, version-mismatch |
| Cannot specify both vlm_pipeline_preset and… | validation | error | service, vlm, validation, mutual-exclusion |
| is supported by the Transformers engine only with… | exception | error | vlm, transformers, version-conflict, dots-ocr, vllm, dependency |
| Decoded image exceeds size limit of | exception | warning | images, size-limit, base64, html, markdown |
| Cannot specify both layout_preset and layout_custom_config. | validation | error | pydantic, validation, configuration, layout, mutually-exclusive |
| Expected ONNX model to return at least 3 outputs: [labels… | exception | error | onnx, model-mismatch, validation, object-detection |
| Local file access requires base_path for directory… | exception | warning | security, images, local-files, path-confinement, configuration |
| Nemotron OCR requires Python 3.12. | exception | error | nemotron, ocr, python-version, environment |
| vllm is not installed. It is not yet available on Python… | exception | error | vllm, python-version, environment, import-error |
| Invalid Tesseract command: contains null byte. | validation | error | ocr, tesseract, validation, security, injection |
| mlx-vlm is not installed. Please install it via `pip… | exception | error | vlm, mlx, import-error, dependency, apple-silicon |
| One of 'token_path' or 'refresh_token' is required. | validation | error | google-drive, oauth, authentication, pydantic, validation |
| Expected ONNX logits output shape [batch_size… | exception | error | onnx, tensor-shape, logits, model-export |
| This method cannot run inside an active asyncio loop. Call… | exception | error | asyncio, api-misuse, runtime-error |
| Unsupported numpy dtype for gRPC inline (non-binary)… | exception | error | kserve, grpc, numpy, dtype, decoding, server-compat |
| Nemotron OCR is only supported on x86_64 machines. | exception | error | nemotron, ocr, platform, arm, x86 |
| Expected an OpenDocument | exception | error | odf, format-mismatch, file-detection |
| Expected scalar-like ndarray with size 1, got shape= | exception | error | numpy, post-processing, scores, type-error |
| OcrMac is only supported on Mac. | exception | error | ocrmac, ocr, platform, macos |
| whisper is not installed. Unfortunately its dependencies… | exception | error | asr, whisper, python-version, compatibility |
| Incompatible file format | exception | error | pdf, format-dispatch, internal-error |
| ONNX model exposes no inputs | exception | error | onnx, model-graph, corrupt-model, onnxruntime |
| Page index out of range | exception | error | image, pagination, bounds-check |
| Unsupported numpy dtype for KServe v2 input | exception | error | numpy, dtype, http, kserve, validation |
| Absolute paths are not allowed with local base_path | exception | error | path-safety, images, local-files, html |
| pypdfium could not load document with hash | exception | error | pdf, pypdfium2, encrypted, load-failure |
| Connections to remote services is only allowed when set… | exception | error | remote-services, privacy, configuration, vlm |
| Cannot convert EPUB with hash | exception | error | epub, state-machine, lifecycle |
| MLX models do not support HuggingFace StoppingCriteria… | exception | error | mlx, stopping-criteria, configuration, vlm |
| ocrmac is not correctly installed. Please install it via… | exception | error | ocrmac, ocr, import, dependencies, macos |
| XML file exceeds size limit of bytes | exception | error | mets, archive, security, limits, xml |
| Plotting requires matplotlib. Install it in the environment… | console | error | perf-tooling, matplotlib, dependency, cli |
| The following RapidOCR paths do not exist | exception | error | ocr, rapidocr, file-path, configuration |
| No extraction pipeline could be initialized for | exception | error | extraction, pipeline, configuration |
| path_or_stream must be Path or BytesIO | exception | error | xbrl, type-error, api-misuse, pathlib, bytesio |
| Unsupported VLM inference framework | exception | error | vlm, inference-framework, configuration |
| vLLM is not installed. Please install it via `pip install… | exception | error | vlm, vllm, import-error, dependency |
| The 'beautifulsoup4' package is required to process HTML… | exception | error | html, optional-dependency, installation, importerror |
| Expected TransformersObjectDetectionEngineOptions, got | validation | error | configuration, factory, type-mismatch, object-detection |
| ONNX model exposes no outputs | exception | error | onnx, model-graph, corrupt-model, onnxruntime |
| OpenDocument backend could not load document with hash | exception | error | opendocument, odf, corrupt-file, load-failure |
| METS GBS backend could not load document | exception | error | mets, document-load, archive, format-detection |
| every record needs a selector when record_type_field is set | validation | error | ebcdic, validation, pydantic |
| Image processor config not found | exception | error | huggingface, model-loading, artifacts, file-not-found |
| Could not initialize the WebVTT backend for file with hash | exception | error | webvtt, subtitles, encoding, utf-8, document-load |
| CUDA device 'cuda: ' is not available. Available CUDA… | exception | error | cuda, accelerator, configuration, hardware |
| KServe v2 output batch size mismatch for labels: expected | exception | error | kserve, batching, inference, validation |