ErrLookup › docling-project/docling
docling-project/docling
Get your documents ready for gen AI · Python · 253 source files
Analyzed at 61d76f1ff3 on 2026-08-15. 399 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Could not initialize AsciiDoc backend for file with hash {se | exception | error | benchmark, packaging, pyproject-toml, version-detection, environment |
| Could not load Box Note document with hash {self.document_ha | exception | error | benchmark, xlsx, assertion, table-extraction, version-drift |
| Legacy Box Notes (the pre-August-2022 atext/pool format) are | exception | error | benchmark, xlsx, merged-cells, table-dimensions, assertion, version-drift |
| Cannot convert Box Note with hash {self.document_hash}: no ' | exception | error | box-note, validation, convert |
| CsvDocumentBackend could not load document with hash {self.d | exception | error | csv, encoding, document-load, utf-8 |
| Cannot convert csv with unknown delimiter {dialect.delimiter | exception | warning | csv, delimiter, sniffer, convert |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | csv, state-misuse, convert, validation |
| docling-parse could not load document {self.document_hash}: | exception | error | pdf, docling-parse, password, corrupt-file, document-load |
| docling-parse could not load document {self.document_hash}. | exception | error | pdf, docling-parse, document-load, diagnostics |
| ThreadedDoclingParseDocumentBackend only supports iter_pages | exception | error | pdf, threaded, api-misuse, not-implemented |
| Libreoffice not found | exception | error | libreoffice, environment, dependency, docx, drawingml |
| LibreOffice is required to convert a .{source_suffix} file t | exception | error | libreoffice, environment, dependency, docx, conversion |
| LibreOffice did not produce the expected output: {converted_ | exception | error | libreoffice, docx, conversion, silent-failure |
| Unknown EBCDIC codec {encoding!r}. | exception | error | ebcdic, encoding, codec, configuration |
| Cannot decode field {field.name!r} of type {field.type.value | exception | error | ebcdic, layout, decode, mainframe |
| No record layout matches record type {record_type!r}. | exception | error | ebcdic, layout, record-type, decode |
| Record length {length} is shorter than the {layout.prefix_si | exception | error | ebcdic, layout, record-length, decode |
| Input ends inside {name!r}: {end - offset} of {size} bytes l | exception | error | ebcdic, truncation, layout, transfer |
| Could not initialize the EBCDIC backend for file with hash { | exception | error | ebcdic, document-load, io, closed-stream |
| The EBCDIC backend needs a layout: set either EbcdicBackendO | exception | error | ebcdic, configuration, mainframe, backend-options |
| Could not read the EBCDIC layout {self.options.layout_file}. | exception | error | ebcdic, configuration, json, file-io |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | ebcdic, state-machine, empty-input |
| The 'mail-parser' package is required to process email files | exception | error | email, optional-dependency, installation, importerror |
| Could not initialize email backend for file with hash {self. | exception | error | email, parsing, corrupt-input |
| Unsupported input type: {type(self.path_or_stream)} | exception | error | email, type-error, api-contract |
| The 'python-oxmsg' package is required to process Outlook .m | exception | error | email, outlook-msg, optional-dependency, importerror |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | email, state-machine, lifecycle |
| Could not initialize EPUB backend for file with hash {self.d | exception | error | epub, zip, corrupt-input, parsing |
| Cannot convert EPUB with hash {self.document_hash} because t | exception | error | epub, state-machine, lifecycle |
| The 'beautifulsoup4' package is required to process HTML fil | exception | error | html, optional-dependency, installation, importerror |
| Could not initialize HTML backend for file with hash {self.d | exception | error | html, file-io, stream-state, parsing |
| Invalid HTML document. | exception | error | html, state-machine, lifecycle |
| Playwright is required for HTML rendering. Install it with ' | exception | error | html, playwright, rendering, optional-dependency |
| Incompatible file format {self.input_format} was passed to I | exception | error | image, api-contract, format-mismatch |
| Could not load image for document {self.file} | exception | error | image, pillow, corrupt-input, codec |
| Page index out of range: {page_no} | exception | error | image, pagination, bounds-check |
| Unexpected: {type(self.path_or_stream)=} | exception | error | json, type-error, api-contract, deferred-error |
| The 'pylatexenc' package is required to process LaTeX files. | exception | error | latex, optional-dependency, installation, importerror |
| The 'marko' package is required to process Markdown files. I | exception | error | markdown, optional-dependency, installation, importerror |
| Could not initialize MD backend for file with hash {self.doc | exception | error | markdown, encoding, io, document-load |
| An internal error has occurred during Markdown conversion. | exception | error | markdown, html, internal-error, regex |
| Cannot convert md with {self.document_hash} because the back | exception | error | markdown, state-check, guard |
| Page image dimensions {im.size} do not match page geometry ( | exception | error | mets, gbs, archive, data-integrity, image |
| Archive exceeds maximum member count limit of {self.options. | exception | error | mets, archive, security, limits, validation |
| XML file {member.name} exceeds size limit of {self.options.m | exception | error | mets, archive, security, limits, xml |
| Archive exceeds maximum total extraction size of {self.optio | exception | error | mets, archive, security, limits, decompression-bomb |
| METS GBS backend could not load document {self.document_hash | exception | error | mets, document-load, archive, format-detection |
| Archive member '{image_info.path}' is not a regular file (di | exception | error | mets, archive, security, tar, symlink |
| Image file {image_info.path} exceeds individual file size li | exception | error | mets, archive, security, limits, image |
| Total extracted data exceeds maximum limit of {self.options. | exception | error | mets, archive, security, limits, decompression-bomb |
| Archive member '{ocr_info.path}' is not a regular file (dire | exception | error | mets, archive, security, tar, symlink, ocr |
| OCR file {ocr_info.path} exceeds individual file size limit | exception | error | mets, archive, security, limits, ocr |
| The 'openpyxl' package is required to process Excel files. I | exception | error | excel, dependency, import, docling-slim |
| MsExcelDocumentBackend could not load document with hash {se | exception | error | excel, document-load, openpyxl, corrupt-file |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | excel, state-check, guard |
| The 'python-pptx' package is required to process PowerPoint | exception | error | powerpoint, dependency, import, docling-slim |
| MsPowerpointDocumentBackend could not load document with has | exception | error | powerpoint, document-load, python-pptx, corrupt-file |
| ZIP slip attempt: {info.filename} | exception | critical | security, zip-slip, ooxml, msword, path-traversal |
| Refusing to expand oversized OOXML part: {info.filename} | exception | error | security, zip-bomb, docx, ooxml |
| Refusing to expand OOXML package exceeding the uncompressed | exception | error | security, zip-bomb, docx, memory |
| The 'python-docx' package is required to process Word files. | exception | error | dependency, install, docx, extras |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | docx, invalid-input, state-check |
| MsWordDocumentBackend could not load document with hash {doc | exception | error | docx, corrupt-file, load-failure |
| OpenDocument backend could not load document with hash {docu | exception | error | opendocument, odf, corrupt-file, load-failure |
| The 'odfdo' package is required to process OpenDocument file | exception | error | dependency, install, odf, extras |
| Expected an OpenDocument {self._odf_type!r} but got {self.od | exception | error | odf, format-mismatch, file-detection |
| Cannot convert doc with {self.document_hash} because the bac | exception | error | odt, state-check, invalid-input |
| Incompatible file format {self.input_format} was passed to a | exception | error | pdf, format-dispatch, internal-error |
| pypdfium could not load document with hash {self.document_ha | exception | error | pdf, pypdfium2, encrypted, load-failure |
| URL must contain a valid hostname | exception | error | ssrf, url-validation, images, network |
| Cannot resolve hostname: {hostname} | exception | error | ssrf, dns, network, images |
| Access to restricted IP address not allowed: {ip} | exception | error | ssrf, security, network, images |
| Absolute paths are not allowed with local base_path: '{loc}' | exception | error | path-safety, images, local-files, html |
| Path traversal blocked: '{loc}' resolves outside base direct | exception | error | path-traversal, security, images, local-files |
| Invalid base_path format: '{base_path}' | exception | error | base-path, images, validation |
| Fetching remote resources is only allowed when set explicitl | exception | warning | remote-fetch, security, network, images, opt-in |
| Resource size exceeds limit: {content_length} bytes | exception | warning | network, images, size-limit, html, markdown |
| Downloaded data exceeds size limit | exception | warning | network, images, size-limit, streaming |
| Decoded image exceeds size limit of {self.max_image_data_bas | exception | warning | images, size-limit, base64, html, markdown |
| Fetching local resources is only allowed when set explicitly | exception | warning | security, images, local-files, html, markdown, configuration |
| Local file access requires base_path for directory confineme | exception | warning | security, images, local-files, path-confinement, configuration |
| File does not exist or it is not readable. | exception | warning | images, local-files, filesystem, permissions |
| Could not initialize the WebVTT backend for file with hash { | exception | error | webvtt, subtitles, encoding, utf-8, document-load |
| Invalid WebVTT document. | exception | error | webvtt, subtitles, validation, format-detection |
| Unexpected: {type(self.path_or_stream)=} | exception | error | doclang, type-error, api-misuse, backends |
| Unexpected: {type(self.path_or_stream)=} | exception | error | doclang, xml, type-error, api-misuse, backends |
| The 'beautifulsoup4' and 'lxml' packages are required to pro | exception | error | jats, xml, import-error, dependencies, docling-slim, packaging |
| Could not initialize JATS backend for file with hash {self.d | exception | error | jats, xml, document-load, parsing, lxml |
| The 'beautifulsoup4' and 'defusedxml' packages are required | exception | error | uspto, xml, import-error, dependencies, docling-slim, patents |
| Could not initialize USPTO backend for file with hash {self. | exception | error | uspto, patents, encoding, document-load, utf-8 |
| Failed to convert doc (hash={self.document_hash}, name={self | exception | error | uspto, patents, conversion, runtime-error |
| Cannot convert doc (hash={self.document_hash}, name={self.fi | exception | error | uspto, patents, doctype, format-detection, line-endings |
| The 'arelle-release' package is required to process XBRL doc | exception | error | xbrl, import-error, dependencies, docling-slim, arelle, packaging |
| Fetching local or remote resources is only allowed when set | exception | error | xbrl, security, configuration, taxonomy, network, local-files |
| The 'taxonomy' backend option must be a directory | validation | error | xbrl, taxonomy, path-validation, configuration |
| path_or_stream must be Path or BytesIO | exception | error | xbrl, type-error, api-misuse, pathlib, bytesio |
| Invalid or unreadable XBRL file | exception | error | xbrl, validation, parsing, docling |
| Document is not an XBRL instance | exception | error | xbrl, validation, docling |
| XBRL loaded with errors: {model.errors} | exception | error | xbrl, network, taxonomy, docling |
| Could not initialize XBRL backend for file with hash {self.d | exception | error | xbrl, error-handling, docling |
| Invalid document with hash {self.document_hash} | exception | error | xbrl, api-misuse, docling |
| {asr_model} is not known | exception | error | cli, asr, whisper, version-skew |
| Invalid device option. Use `auto`, `cpu`, `mps`, `xpu`, `cud | validation | error | accelerator, validation, pydantic, cuda |
| record_type_field is required for a layout with several reco | validation | error | ebcdic, validation, pydantic, mainframe |
| every record needs a selector when record_type_field is set | validation | error | ebcdic, validation, pydantic |
| record selectors must be unique | validation | error | ebcdic, validation, pydantic, uniqueness |
| set either layout or layout_file, not both | validation | error | ebcdic, validation, pydantic, mutual-exclusion |
| Model `{self.repo_id}` is English-only and does not support | validation | error | asr, whisper, validation, pydantic |
| Model `{self.repo_id}` does not support the `translate` task | validation | error | asr, whisper, validation, pydantic, translation |
| Invalid JSON for nested config field: {exc} | validation | error | service, json, http, form-data, validation |
| The parameters picture_description_local and picture_descrip | validation | error | service, picture-description, validation, mutual-exclusion, deprecation |
| The parameters vlm_pipeline_model, vlm_pipeline_model_local | validation | error | service, vlm, validation, mutual-exclusion, deprecation |
| Cannot specify both vlm_pipeline_preset and vlm_pipeline_cus | validation | error | service, vlm, validation, mutual-exclusion |
| Cannot mix legacy VLM options (vlm_pipeline_model*) with new | validation | error | service, vlm, validation, migration, deprecation |
| Cannot specify both picture_description_preset and picture_d | validation | error | service, picture-description, validation, mutual-exclusion |
| Cannot mix legacy picture description options (picture_descr | validation | error | service, picture-description, validation, migration, deprecation |
| Cannot specify both code_formula_preset and code_formula_cus | validation | error | pydantic, validation, configuration, code-formula, mutually-exclusive |
| Cannot specify both layout_preset and layout_custom_config. | validation | error | pydantic, validation, configuration, layout, mutually-exclusive |
| Cannot specify both picture_classification_preset and pictur | validation | error | pydantic, validation, configuration, picture-classification, mutually-exclusive |
| Cannot specify both ocr_preset and ocr_custom_config. | validation | error | pydantic, validation, ocr, deprecation, mutually-exclusive |
| Cannot specify both chunking_preset and chunking_options. | validation | error | pydantic, validation, chunking, configuration, mutually-exclusive |
| ZIP URLs are not accepted on the convert endpoint | http | error | http, validation, zip, convert-endpoint, service |
| One of 'token_path' or 'refresh_token' is required. | validation | error | google-drive, oauth, authentication, pydantic, validation |
| One of 'credentials_path' or 'credentials' is required. | validation | error | google-drive, oauth, authentication, credentials, validation |
| Invalid page range: start must be ≥ 1 and end must be ≥ star | validation | error | validation, page-range, pdf, settings, off-by-one |
| Preset '{preset_id}' not found for {cls.__name__}. Available | exception | error | preset, registry, lookup, stage-model, configuration |
| Preset '{preset_id}' uses API_KSERVE_V2 engine which require | validation | error | kserve, inference-server, engine-options, preset, object-detection |
| Unsupported engine type {preset.default_engine_type} for pre | validation | error | engine-type, preset, exhaustiveness, object-detection, internal-error |
| Preset '{preset_id}' uses API_KSERVE_V2 engine which require | validation | error | kserve, inference-server, engine-options, preset, image-classification |
| No default options configured for {format} | exception | error | input-format, format-options, document-converter, configuration, runtime-error |
| No pipeline could be initialized for format {format} | exception | error | pipeline, input-format, document-converter, conversion, configuration |
| Conversion failed for: {conv_res.input.file} with status: {c | exception | error | conversion, document-converter, error-handling, batch, pdf |
| Conversion failed because the provided file has no recogniza | exception | error | conversion, format-detection, document-converter, allowed-formats, validation |
| format {format} is not supported in `convert_string` | validation | error | api-misuse, input-format, convert-string |
| No pipeline could be initialized for {in_doc.file}. | exception | error | pipeline, configuration, input-format |
| No default extraction backend configured for {fmt} | exception | error | extraction, backend, configuration |
| Extraction failed for: {ext_res.input.file} with status: {ex | exception | error | extraction, error-handling, pipeline |
| Extraction failed because the provided file has no recogniza | exception | error | extraction, input-format, file-naming |
| No extraction pipeline could be initialized for {in_doc.file | exception | error | extraction, pipeline, configuration |
| ThreadedLayoutVlmPipeline only supports DOCTAGS response for | validation | error | vlm, validation, pipeline-options, doctags |
| {pipeline_name} does not support ThreadedDoclingParseDocumen | exception | error | vlm, backend, threading, experimental |
| Unsupported VLM inference framework: {vlm_options.inference_ | exception | error | vlm, inference-framework, configuration |
| Unsupported VLM options type: {type(base_vlm_options)} | exception | error | vlm, type-mismatch, pipeline-options |
| {p} does not exist or is not a directory containing the requ | exception | error | artifacts, filesystem, configuration, vlm |
| Unsupported VLM response format {self.pipeline_options.vlm_o | exception | error | vlm, doctags, immutability, safety-net |
| Unknown prompt style `{self.vlm_options.transformers_prompt_ | exception | error | vlm, transformers, prompt-style, enum |
| qwen-vl-utils is required for NuExtractTransformersModel. Pl | exception | error | dependency, import-error, nuextract, extraction |
| Examples batch length must match messages batch length | exception | error | nuextract, batching, validation, extraction |
| Unsupported numpy array shape: {img.shape} | exception | error | nuextract, numpy, image-processing, extraction |
| Number of templates ({len(prompt)}) must match number of ima | exception | error | nuextract, batching, validation, extraction |
| qwen-vl-utils is required for NuExtract extraction. Please i | exception | error | dependency, import-error, nuextract, extraction |
| Examples batch length must match messages batch length | exception | error | extraction, batching, validation, examples |
| Unsupported numpy array shape: {img.shape} | exception | error | extraction, numpy, image-processing, transformers |
| Number of prompts ({len(prompt)}) must match number of image | exception | error | validation, extraction, vision-model, batching |
| No class found with the name {kind!r}, known classes are: {m | exception | error | factory, plugins, runtime-error, registration |
| {opt_type.kind!r} already registered to class {self._classes | exception | error | factory, plugins, registration, duplicate |
| {type(self).__name__} requires model_config with repo_id | exception | error | configuration, huggingface, inference-engine, model-loading |
| Image processor config not found: {preprocessor_config} | exception | error | huggingface, model-loading, artifacts, file-not-found |
| Failed to load image processor from {model_folder}: {exc} | exception | error | huggingface, transformers, model-loading, compatibility |
| Failed to load label mapping from model config at {model_fol | exception | error | huggingface, model-loading, labels, configuration |
| Expected scalar-like ndarray with size 1, got shape={value.s | exception | error | numpy, post-processing, scores, type-error |
| Expected scalar-like tensor with one element, got shape={tup | exception | error | torch, post-processing, scores, type-error |
| Unsupported score value type: {type(value)!r} | exception | error | type-error, scores, post-processing, duck-typing |
| Unsupported label value type: {type(value)!r} | exception | error | type-error, labels, post-processing |
| Unsupported KServe request parameter integer range for gRPC: | exception | error | kserve, grpc, validation, parameters, overflow |
| Unsupported KServe request parameter type for gRPC: key={key | exception | error | kserve, grpc, validation, parameters, serialization |
| Unsupported numpy dtype for gRPC inline (non-binary) encodin | exception | error | kserve, grpc, numpy, dtype, serialization |
| Unsupported numpy dtype for gRPC inline (non-binary) decodin | exception | error | kserve, grpc, numpy, dtype, decoding, server-compat |
| gRPC transport requires the 'remote-serving' extras. Install | exception | error | kserve, grpc, import-error, extras, installation |
| gRPC metadata call failed for model {self.model_name}: {exc} | exception | error | kserve, grpc, network, model-serving, runtime-error |
| Unsupported numpy dtype for KServe v2 gRPC input: {np_tensor | exception | error | numpy, dtype, grpc, kserve, validation |
| gRPC infer call failed for model {self.model_name}: {exc} | exception | error | grpc, network, inference, timeout, runtime |
| KServe v2 gRPC response did not include binary output payloa | exception | error | grpc, kserve, binary-data, protocol-mismatch |
| Unsupported KServe v2 gRPC output datatype: {output_tensor.d | exception | error | grpc, kserve, dtype, binary-data, model-config |
| Unsupported numpy dtype for KServe v2 input: {tensor.dtype!s | exception | error | numpy, dtype, http, kserve, validation |
| Unsupported KServe v2 output datatype: {raw_output.datatype} | exception | error | http, kserve, dtype, model-config |
| KServe v2 output tensor {raw_output.name} did not include in | exception | error | http, kserve, binary-data, protocol-mismatch |
| Invalid binary_data_size value: {size!r} | exception | error | http, kserve, binary-data, server-bug, validation |
| Invalid binary_data_size value: {parsed_size} | exception | error | http, kserve, binary-data, server-bug, validation |
| Binary KServe response from {response.url} did not include { | exception | error | http, kserve, binary-data, gateway, response-format |
| Invalid {_INFERENCE_HEADER_CONTENT_LENGTH} value: {header_le | exception | error | http, kserve, binary-data, header, gateway |
| Invalid {_INFERENCE_HEADER_CONTENT_LENGTH} value: {header_le | exception | error | http, kserve, binary-data, truncation, gateway |
| Invalid binary inference response header from {response.url} | exception | error | http, kserve, binary-data, response-format, server-bug |
| Invalid metadata response from {self.model_metadata_url}: {e | exception | error | http, kserve, metadata, configuration, response-format |
| Invalid inference response from {self.infer_url}: {exc} | exception | error | http, kserve, response-format, gateway, inference |
| KServe v2 HTTP response did not include enough binary output | exception | error | http, kserve, binary-data, truncation, server-bug |
| KServe v2 HTTP response included trailing binary output data | exception | error | http, kserve, binary-data, server-bug, protocol-mismatch |
| Invalid BYTES data: insufficient bytes for length prefix at | exception | error | kserve, bytes, binary-data, codec, server-bug |
| Invalid BYTES data: insufficient bytes for string of length | exception | error | kserve, serialization, bytes, tensor-decoding, remote-inference |
| Connections to remote services are only allowed when set exp | exception | error | remote-services, opt-in, privacy, kserve, configuration |
| KServe v2 client is not initialized. | exception | error | lifecycle, initialization, kserve, null-client |
| Expected image-classification model metadata to expose at le | exception | error | kserve, model-metadata, remote-inference, configuration |
| Expected image-classification model metadata to expose at le | exception | error | kserve, model-metadata, remote-inference, configuration |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, kserve, call-order |
| Missing expected KServe v2 output: {self._output_name} | exception | error | kserve, output-name-mismatch, remote-inference, versioning |
| Expected logits output shape [batch_size, num_classes], got | exception | error | kserve, tensor-shape, logits, remote-inference |
| Expected OnnxRuntimeImageClassificationEngineOptions, got {t | exception | error | factory, options-mismatch, configuration, onnx |
| Expected TransformersImageClassificationEngineOptions, got { | exception | error | factory, options-mismatch, configuration, transformers |
| Expected ApiKserveV2ImageClassificationEngineOptions, got {t | exception | error | factory, options-mismatch, configuration, kserve |
| Unknown engine type: {options.engine_type} | exception | error | factory, invalid-enum, configuration, engine-type |
| ONNX model file '{model_filename}' not found: {model_path} | exception | error | onnx, model-artifacts, file-not-found, huggingface |
| ONNX model exposes no inputs | exception | error | onnx, model-graph, corrupt-model, onnxruntime |
| ONNX model exposes no outputs | exception | error | onnx, model-graph, corrupt-model, onnxruntime |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, onnx, call-order |
| Expected ONNX model to return at least 1 output containing l | exception | error | onnx, onnxruntime, empty-output, session-state |
| Expected ONNX logits output shape [batch_size, num_classes], | exception | error | onnx, tensor-shape, logits, model-export |
| Failed to load model from {model_folder}: {exc} | exception | error | transformers, model-loading, huggingface, environment |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, transformers, call-order |
| Connections to remote services are only allowed when set exp | exception | error | remote-services, configuration, kserve, object-detection, security |
| KServe v2 client is not initialized. | exception | error | lifecycle, kserve, initialization, object-detection |
| Expected object-detection model metadata to expose at least | exception | error | kserve, model-mismatch, metadata, object-detection, remote-services |
| Expected object-detection model metadata to expose at least | exception | error | kserve, model-mismatch, metadata, object-detection |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, kserve, object-detection |
| Missing one or more expected KServe v2 outputs: {self._outpu | exception | error | kserve, model-mismatch, inference, remote-services |
| KServe v2 output batch size mismatch for labels: expected {l | exception | error | kserve, batching, inference, validation |
| Expected OnnxRuntimeObjectDetectionEngineOptions, got {type( | validation | error | configuration, factory, type-mismatch, object-detection |
| Expected TransformersObjectDetectionEngineOptions, got {type | validation | error | configuration, factory, type-mismatch, object-detection |
| Expected ApiKserveV2ObjectDetectionEngineOptions, got {type( | validation | error | configuration, factory, type-mismatch, kserve, object-detection |
| Unknown engine type: {options.engine_type} | validation | error | factory, enum, version-skew, configuration |
| ONNX model file '{model_filename}' not found: {model_path} | exception | error | onnx, file-not-found, artifacts, offline, object-detection |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, onnx, object-detection |
| Expected ONNX model to return at least 3 outputs: [labels, b | exception | error | onnx, model-mismatch, validation, object-detection |
| Failed to load model from {model_folder}: {e} | exception | error | transformers, model-loading, wrapper-exception, dependencies |
| Engine not initialized. Call initialize() first. | exception | error | lifecycle, initialization, transformers, object-detection |
| Unsupported numpy array shape: {image.shape} | validation | error | numpy, image-preprocessing, vlm, validation, shape |
| Model '{repo_id}' not found in artifacts_path. Expected loca | exception | error | vlm, file-not-found, artifacts, offline, configuration |
| Unknown prompt style: {prompt_style}. Valid values are {', ' | validation | error | vlm, enum, configuration, validation |
| Connections to remote services is only allowed when set expl | exception | error | remote-services, configuration, vlm, security, openai-api |
| API runtime requires a URL | validation | error | vlm, api, configuration, url, validation |
| Expected AutoInlineVlmEngineOptions, got {type(options)} | validation | error | vlm, factory, configuration, type-mismatch |
| Expected TransformersVlmEngineOptions, got {type(options)} | validation | error | vlm, factory, configuration, type-mismatch, transformers |
| Expected MlxVlmEngineOptions, got {type(options)} | validation | error | vlm, factory, configuration, type-mismatch, mlx, apple-silicon |
| Expected VllmVlmEngineOptions, got {type(options)} | validation | error | vlm, factory, configuration, type-mismatch, vllm |
| Expected ApiVlmEngineOptions, got {type(options)} | validation | error | vlm, factory, configuration, type-mismatch, api |
| Unsupported engine type: {engine_type} | validation | error | vlm, factory, configuration, unsupported-operation, version-skew |
| mlx-vlm is not installed. Please install it via `pip install | exception | error | vlm, mlx, import-error, dependency, apple-silicon |
| Model '{repo_id}' not found in artifacts_path. Expected loca | exception | error | vlm, mlx, model-download, artifacts, offline, file-not-found |
| Model not loaded. Ensure EngineModelConfig was provided duri | exception | error | vlm, mlx, configuration, model-not-loaded, runtime-error |
| rednote-hilab/dots.mocr requires flash-attn with the Transfo | exception | error | vlm, transformers, flash-attn, dependency, import-error, dots-ocr |
| Phi 4 only works with transformers<4.52.0 but you have {tran | exception | error | vlm, transformers, version-conflict, phi-4, dependency |
| {repo_id} is supported by the Transformers engine only with | exception | error | vlm, transformers, version-conflict, dots-ocr, vllm, dependency |
| Model not loaded. Ensure EngineModelConfig was provided duri | exception | error | vlm, transformers, configuration, model-not-loaded, runtime-error |
| Neither processor.batch_decode nor tokenizer.batch_decode is | exception | error | vlm, transformers, decoding, incompatible-model, runtime-error |
| vLLM is not installed. Please install it via `pip install vl | exception | error | vlm, vllm, import-error, dependency |
| vLLM is not installed. It is not yet available on Python 3.1 | exception | error | vlm, vllm, python-version, environment, import-error |
| Model not loaded. Ensure EngineModelConfig was provided duri | exception | error | vlm, vllm, configuration, model-not-loaded, runtime-error |
| Picture description batch_size must be >= 1 | validation | error | picture-description, configuration, validation, batch-size |
| Picture description scale must be > 0 | validation | error | picture-description, configuration, validation, image-scale |
| Could not find assistant response in decoded text | validation | error | chart-extraction, granite-vision, llm-output, parsing |
| Label must be either code or formula | exception | error | code-formula, validation, label, not-implemented |
| Label must be either code or formula | exception | error | code-formula, vlm, label, not-implemented |
| Engine not initialized | exception | error | code-formula, vlm, lifecycle, runtime |
| Unsupported EasyOCR language code: {language} | validation | error | easyocr, ocr, language, validation |
| EasyOCR is not installed. Please install it via `pip install | exception | error | easyocr, ocr, import, dependencies |
| ZIP slip attempt: {member.filename} | validation | critical | zip-slip, security, easyocr, model-download, path-traversal |
| Nemotron OCR is not installed. Install the optional dependen | exception | error | nemotron, ocr, import, dependencies, cuda |
| Nemotron OCR is only supported on Linux. | exception | error | nemotron, ocr, platform, linux |
| Nemotron OCR is only supported on x86_64 machines. | exception | error | nemotron, ocr, platform, arm, x86 |
| Nemotron OCR requires Python 3.12. | exception | error | nemotron, ocr, python-version, environment |
| Nemotron OCR requires a CUDA accelerator. Set `pipeline_opti | exception | error | nemotron, ocr, cuda, accelerator, gpu |
| Nemotron OCR requires CUDA at initialization time, but `torc | exception | error | nemotron, ocr, cuda, pytorch, gpu |
| Nemotron OCR requires CUDA 13.x, but the current PyTorch run | exception | error | nemotron, ocr, cuda, pytorch, version-mismatch |
| Nemotron OCR artifacts not found or incomplete in artifacts_ | exception | error | nemotron, ocr, artifacts, model-download, file-not-found |
| OcrMac is only supported on Mac. | exception | error | ocrmac, ocr, platform, macos |
| ocrmac is not correctly installed. Please install it via `pi | exception | error | ocrmac, ocr, import, dependencies, macos |
| Invalid RapidOCR model spec {value!r}. Expected '<backend>:< | validation | error | rapidocr, ocr, configuration, validation |
| Unknown RapidOCR backend {backend!r} in {value!r}. Supported | validation | error | rapidocr, ocr, backend, validation |
| Invalid RapidOCR model spec {value!r}: {err} | validation | error | rapidocr, ocr, language, validation |
| Unknown RapidOCR backend {backend!r}. Supported: {list(_RAPI | validation | error | ocr, rapidocr, configuration, validation |
| RapidOCR torch backend does not support language {lang!r}. S | validation | error | ocr, rapidocr, language, configuration |
| RapidOCR {backend} backend does not support language {lang!r | validation | error | ocr, rapidocr, language, validation |
| RapidOCR is not installed. Please install it via `pip instal | exception | error | ocr, rapidocr, dependency, environment |
| The following RapidOCR paths do not exist: {listed} | exception | error | ocr, rapidocr, file-path, configuration |
| RapidOCR artifacts not found or incomplete in artifacts_path | exception | error | ocr, rapidocr, offline, artifacts, file-path |
| Tesseract is not available, aborting: {exc} Install tesserac | exception | error | ocr, tesseract, environment, dependency |
| Invalid Tesseract language identifier: {lang!r}. Language id | validation | error | ocr, tesseract, validation, security, injection |
| Invalid Tesseract data path: contains null byte. | validation | error | ocr, tesseract, validation, security, injection |
| Invalid Tesseract command: contains null byte. | validation | error | ocr, tesseract, validation, security, injection |
| Invalid filename: contains null byte. | validation | error | ocr, tesseract, validation, security, injection |
| tesserocr is not correctly installed. Please install it via | exception | error | ocr, tesseract, tesserocr, dependency, environment |
| tesserocr is not correctly configured. No language models ha | exception | error | ocr, tesseract, tessdata, environment |
| Picture classifier engine is not initialized. | exception | error | classification, pipeline, initialization, pictures |
| Supported input formats are PIL.Image.Image or numpy.ndarray | validation | error | classification, pictures, type-error, validation |
| Connections to remote services is only allowed when set expl | exception | error | privacy, remote-services, pictures, configuration, security |
| Engine not initialized | exception | error | vlm, pictures, initialization, pipeline |
| transformers >=4.46 is not installed. Please install Docling | exception | error | vlm, pictures, dependency, transformers, environment |
| _do_prediction_on_image_to_table: duplicate cell indices det | validation | error | table-structure, ocr, validation, data-integrity |
| Prompt list length ({len(prompt)}) must match image count ({ | validation | error | vlm, prompt, batching, validation |
| Connections to remote services is only allowed when set expl | exception | error | remote-services, privacy, configuration, vlm |
| Prompt list length ({len(prompt)}) must match image count ({ | validation | error | vlm, api, prompt, batching, validation |
| Unsupported numpy array shape: {image.shape} | validation | error | numpy, image, shape, vlm, api |
| rednote-hilab/dots.mocr requires flash-attn with the Transfo | exception | error | dependencies, flash-attn, dots-mocr, transformers, import-error |
| Phi 4 only works with transformers<4.52.0 but you have {tran | exception | error | transformers, version-conflict, phi-4, vlm |
| {self.vlm_options.repo_id} is supported by the Transformers | exception | error | transformers, version-conflict, dots-ocr, vlm |
| Model '{self.vlm_options.repo_id}' not found in artifacts_pa | exception | error | model-download, artifacts-path, file-not-found, cli |
| Unsupported numpy array shape: {img.shape} | validation | error | numpy, image, shape, transformers, vlm |
| Number of prompts ({len(prompt)}) must match number of image | validation | error | prompt, batching, validation, transformers |
| Neither processor.batch_decode nor tokenizer.batch_decode is | exception | error | transformers, processor, decode, runtime-error |
| mlx-vlm is not installed. Please install it via `pip install | exception | error | mlx, import-error, optional-dependency, apple-silicon |
| Model '{self.vlm_options.repo_id}' not found in artifacts_pa | exception | error | model-download, artifacts-path, mlx, file-not-found |
| MLX models do not support HuggingFace StoppingCriteria insta | exception | error | mlx, stopping-criteria, configuration, vlm |
| MLX models do not support HuggingFace StoppingCriteria class | exception | error | mlx, stopping-criteria, configuration |
| Number of prompts ({len(prompt)}) must match number of image | exception | error | mlx, prompt, batching, validation |
| prompt must be str or list[str], got {type(prompt)} | exception | error | mlx, prompt, type-error, validation |
| Unsupported numpy array shape: {image.shape} | exception | error | mlx, numpy, image, shape |
| vllm is not installed. Please install it via `pip install vl | exception | error | vllm, import-error, optional-dependency, gpu |
| vllm is not installed. It is not yet available on Python 3.1 | exception | error | vllm, python-version, environment, import-error |
| Model '{self.vlm_options.repo_id}' not found in artifacts_pa | exception | error | vlm, vllm, offline, model-download, artifacts-path |
| Unsupported numpy array shape: {img.shape} | exception | error | vlm, vllm, numpy, image-processing |
| Number of prompts ({len(prompt)}) must match number of image | exception | error | vlm, vllm, prompt, batching |
| prompt must be str or list[str], got {type(prompt)} | exception | error | vlm, vllm, prompt, type-error |
| whisper is not installed. Please install it via `pip install | exception | error | asr, whisper, optional-dependency, installation |
| whisper is not installed. Unfortunately its dependencies are | exception | error | asr, whisper, python-version, compatibility |
| artifacts_path ({artifacts_path}) does not contain the check | exception | error | asr, whisper, offline, huggingface, artifacts-path |
| ASR pipeline requires a file path or BytesIO stream, but got | exception | error | asr, whisper, input-type, pathlib |
| mlx-whisper is not installed. Please install it via `pip ins | exception | error | asr, mlx, whisper, optional-dependency, apple-silicon |
| whisper_s2t is not installed. Please install it via `pip ins | exception | error | asr, whisper-s2t, optional-dependency, installation |
| No ASR model support for {asr_options} | exception | error | asr, factory, options, configuration |
| The value of {self.artifacts_path=} is not valid. When defin | exception | error | artifacts-path, configuration, extraction-pipeline, filesystem |
| The value of {self.artifacts_path=} is not valid. When defin | exception | error | artifacts-path, configuration, pipeline-setup, filesystem |
| Pipeline {self.__class__.__name__} failed | exception | error | pipeline, error-wrapping, raises-on-error, batch |
| The specified picture description kind is not supported: {pi | exception | error | picture-description, pipeline-options, configuration, enrichment |
| The selected backend {type(conv_res.input._backend).__name__ | exception | error | pipeline, backend, format-routing, paginated |
| {pipeline_name} does not support ThreadedDoclingParseDocumen | exception | error | extraction, vlm, pdf-backend, threaded, unsupported |
| Unsupported template type: {type(template)} | exception | error | extraction, vlm, template, pydantic, type-error |
| The selected backend {type(conv_res.input._backend).__name__ | exception | error | pipeline, backend, configuration, format |
| Model {self.name} returned wrong number of pages | exception | error | pipeline, threading, custom-model, internal-invariant |
| PagePreprocessingModel returned unexpected number of pages | exception | error | pipeline, preprocessing, custom-model, internal-invariant |
| {pipeline_name} does not support ThreadedDoclingParseDocumen | exception | error | pipeline, vlm, backend, threading, configuration |
| Could not instantiate the right type of VLM pipeline: {vlm_o | exception | error | vlm, configuration, inference-framework, options |
| Unsupported VLM response format {response_format_legacy} | exception | error | vlm, response-format, parsing, configuration |
| No pages to process. | exception | error | vlm, empty-input, pages, validation |
| DOTS JSON parsing requires VlmConvertOptions or BaseVlmOptio | exception | error | vlm, dots, options, type-error |
| submit_batch() requires either 'target' or 'targets'. | exception | error | service-client, async, validation, batch |
| submit_batch() received both 'target' and 'targets'; supply | exception | error | service-client, async, validation, batch, api-misuse |
| Service transport request failed. | exception | error | service-client, network, transport, retry |
| Service request failed after retry loop. | exception | error | service-client, retry, unavailable, network |
| Task {task_id} was not found. | exception | error | service-client, task, polling, not-found |
| Timed out waiting for task {task_id} after {timeout:.2f}s. | exception | error | service-client, timeout, polling, task |
| Response schema mismatch — client and server versions may di | exception | error | service-client, schema, version-mismatch, validation |
| Unsupported URL scheme: '{scheme}'. Only http:// and https:/ | validation | error | service-client, url, scheme, validation |
| {name} must be between 1 and {MAX_CONCURRENCY_LIMIT}, got {v | validation | error | service-client, concurrency, validation, limits |
| {error_message} | exception | error | service-client, retry, http-5xx, unavailable |
| Service returned HTTP {response.status_code} after retries. | exception | error | service-client, retry, rate-limit, retry-after, unavailable |
| Service transport request failed after retries. | exception | error | network, retry, service-client, httpx |
| {last_status.error_message or f"Task {task_id} failed."} | exception | error | task, failure, service-client, conversion |
| Result for task {task_id} has expired. | exception | error | task, expiry, service-client, lifecycle |
| Result for task {task_id} is not ready. | exception | warning | task, not-ready, polling, service-client |
| {task_failure.failure.message} | exception | error | task, failure, service-client, json |
| Resource bundle contains an unsafe path: {member!r} | exception | error | security, zip-slip, artifact-download, service-client |
| Resource bundle does not contain a top-level JSON document. | exception | error | artifact-download, bundle-format, version-mismatch |
| Resource bundle references an image outside the bundle: {uri | exception | error | security, path-traversal, artifact-download, service-client |
| Artifact download failed with HTTP {response.status_code}. | http | error | network, http-status, presigned-url, artifact-download |
| Too many redirects while downloading artifact. | exception | error | network, redirects, artifact-download, security |
| Artifact download failed: {exc} | exception | error | network, timeout, tls, artifact-download |
| Refusing to download artifact from a non-public URL: {url}. | exception | error | security, ssrf, network, self-hosted, artifact-download |
| Artifact download redirect is missing a Location header. | exception | error | network, redirects, http-headers, artifact-download |
| Artifact exceeds max_artifact_download_bytes ({self._max_art | exception | error | resource-limits, artifact-download, configuration |
| This method cannot run inside an active asyncio loop. Call i | exception | error | asyncio, api-misuse, runtime-error |
| Service transport request failed. | exception | error | network, service-unavailable, retry, service-client |
| Service request failed after retry loop. | exception | error | service-unavailable, retry, http-5xx, service-client |
| Task {task_id} was not found. | exception | error | websocket, task-lifecycle, not-found, watchers |
| Timed out waiting for task {task_id} after {wait_timeout:.2f | exception | warning | timeout, polling, watchers, task-lifecycle |
| Timed out waiting for task {task_id} to emit status updates. | exception | warning | timeout, polling, watchers |
| WebSocket status stream is unavailable. | exception | error | websocket, network, reconnect, service-unavailable, watchers |
| Timed out waiting for task {task_id} after {timeout:.2f}s. | exception | error | timeout, websocket, task-watcher, service-client |
| CUDA is not supported by this model. Supported devices: {[d. | exception | error | cuda, accelerator, configuration, hardware |
| CUDA device 'cuda:{cuda_index}' is not available. Available | exception | error | cuda, accelerator, configuration, hardware |
| Invalid CUDA device format '{accelerator_device}'. Use 'cuda | exception | error | cuda, accelerator, input-validation, configuration |
| CUDA is not available in the system. Please ensure PyTorch w | exception | error | cuda, accelerator, environment, hardware, pytorch |
| MPS is not supported by this model. Supported devices: {[d.v | exception | error | mps, accelerator, configuration, apple-silicon |
| MPS is not available in the system. Please ensure you are ru | exception | error | mps, accelerator, environment, apple-silicon, pytorch |
| XPU is not supported by this model. Supported devices: {[d.v | exception | error | xpu, accelerator, configuration, intel-gpu |
| XPU is not available in the system. Please ensure PyTorch wi | exception | error | xpu, accelerator, environment, intel-gpu, pytorch |
| Unknown device option '{accelerator_device}'. Valid options | exception | error | accelerator, input-validation, configuration |
| easyocr_languages requires with_easyocr=True | exception | error | model-download, easyocr, input-validation, ocr |
| rapidocr_models requires with_rapidocr=True | exception | error | model-download, rapidocr, input-validation, ocr |
| invalid tesseract document orientation {orientation}, expect | exception | error | ocr, tesseract, orientation, validation |
| expected coordinate origin to be {CoordOrigin.TOPLEFT.value} | exception | error | ocr, coordinates, bounding-box, validation |
| invalid orientation {angle}, expected values in: {sorted(CLI | exception | error | orientation, geometry, validation |
| FFmpeg is required for video processing but was not found on | exception | error | video, ffmpeg, environment, dependency |
| interval_seconds must be > 0 | validation | error | video, validation, constructor |
| max_frames must be > 0 when set | validation | error | video, validation, constructor |
| probe_fps must be > 0 | validation | error | video, validation, constructor, scene-detection |
| prominence must be >= 0 | validation | error | video, validation, scene-detection, constructor |
| min_scene_duration_seconds must be >= 0 | validation | error | video, validation, scene-detection, constructor |
| Hugging Face dataset support requires 'huggingface_hub' to b | console | error | perf-tooling, huggingface, dependency, cli |
| Dataset '{args.repo_id}' does not contain a 'pdf/' subfolder | console | error | perf-tooling, huggingface, dataset, cli |
| Input directory does not exist: {input_dir} | console | error | perf-tooling, filesystem, cli, path |
| {input_file} is not valid JSONL or a JSON summary report. | console | error | perf-tooling, json, cli, file-format |
| {input_file} does not look like an iterate_pdf_pages.py summ | console | error | perf-tooling, json, schema, cli |
| No metrics files found in summary report: {input_file} | console | error | perf-tooling, json, schema, cli |
| Input file does not exist: {args.input_file} | console | error | perf-tooling, filesystem, cli, path |
| Plotting requires matplotlib. Install it in the environment | console | error | perf-tooling, matplotlib, dependency, cli |
| Metrics file does not exist: {metrics_file} | console | error | perf-tooling, filesystem, cli, path |
| No plotable data found in {args.input_file} | console | warning | perf-tooling, empty-data, cli, memory-metrics |
| Could not determine Docling version from pyproject.toml | exception | error | |
| expected one table for {merge_count} merges, got {len(docume | exception | error | |
| unexpected table dimensions: {table.data.num_rows}x{table.da | exception | error |