feat: Unified model-family inference engines (including image-classification) and KServe v2 API support

[cau-git]

This PR implements a new Kserve-API engine type (ApiKserveV2ObjectDetectionEngine, ApiKserveV2ImageClassificationEngine) and the necessary options to comsume remote object-detection and image-classifier models in docling. It adheres to the Kserve v2 inference API spec.

Depends on:
#2979

Checklist:

• Documentation has been updated, if necessary.
• Examples have been added, if necessary.
• Tests have been added, if necessary.

[github-actions]

❌ DCO Check Failed

Hi @cau-git, your pull request has failed the Developer Certificate of Origin (DCO) check.

This repository supports remediation commits, so you can fix this without rewriting history — but you must follow the required message format.

---

🛠 Quick Fix: Add a remediation commit

Run this command:

git commit --allow-empty -s -m "DCO Remediation Commit for github-actions[bot] <github-actions[bot]@users.noreply.github.com>

I, github-actions[bot] <github-actions[bot]@users.noreply.github.com>, hereby add my Signed-off-by to this commit: 16b2081035cacf35b7a3209ce2f663891ffdb0dc
I, Christoph Auer <[email protected]>, hereby add my Signed-off-by to this commit: 3dce78f89f881b3691b0b61403793177cab3aa66
I, Christoph Auer <[email protected]>, hereby add my Signed-off-by to this commit: 7bfa2c8c6a6fc8b01a3d6ef1f206b61833ed7cfb"
git push

---

🔧 Advanced: Sign off each commit directly

For the latest commit:

git commit --amend --signoff
git push --force-with-lease

For multiple commits:

git rebase --signoff origin/cau/add-image-classifier-engines
git push --force-with-lease

More info: DCO check report

[codecov]

Codecov Report

❌ Patch coverage is 46.30225% with 167 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...e_engines/object_detection/api_kserve_v2_engine.py	34.93%	54 Missing ⚠️
...gines/image_classification/api_kserve_v2_engine.py	37.14%	44 Missing ⚠️
.../models/inference_engines/common/kserve_v2_http.py	51.68%	43 Missing ⚠️
.../inference_engines/image_classification/hf_base.py	20.00%	16 Missing ⚠️
docling/datamodel/stage_model_specs.py	0.00%	4 Missing ⚠️
...ng/experimental/models/table_crops_layout_model.py	0.00%	1 Missing ⚠️
...els/inference_engines/image_classification/base.py	75.00%	1 Missing ⚠️
.../inference_engines/image_classification/factory.py	83.33%	1 Missing ⚠️
...engines/image_classification/onnxruntime_engine.py	0.00%	1 Missing ⚠️
.../models/inference_engines/object_detection/base.py	75.00%	1 Missing ⚠️
... and 1 more

📢 Thoughts on this report? Let us know!

[dosubot]

Related Documentation

Checked 15 published document(s) in 1 knowledge base(s). No updates required.

^{How did I do? Any feedback?}