feat: Inference engines abstraction for object detection model family with Transformers and ONNXRuntime

[cau-git]

This PR establishes an implementation of generic inference engines for the object-detection model family.
It defines the required option types, base classes, factories, onnx inference engine, and a stage for layout models (in ONNX format) to demonstrate the principle (WIP).

TODO:

• Transformers inference engine
• Working layout stage with both ONNX and transformers inference engine.
• All inference engines generically understand how to apply model settings that can be read from HF configuration, such as this for e.g. class label mapping.
• Cleanup of arguments
• Support for remote API model "inference engine"
• Example unit

What this PR does not include

• The standard layout model implementation still remains the default
• No CLI-level exposure for new runtime choices

For reference: https://github.com/docling-project/docling/blob/main/docs/usage/model_catalog.md

Checklist:

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

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?(!)?:

[github-actions]

✅ DCO Check Passed

Thanks @cau-git, all your commits are properly signed off. 🎉

[codecov]

Codecov Report

❌ Patch coverage is 26.83438% with 349 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...dels/inference_engines/object_detection/hf_base.py	0.00%	87 Missing ⚠️
...ce_engines/object_detection/transformers_engine.py	0.00%	74 Missing ⚠️
...nce_engines/object_detection/onnxruntime_engine.py	0.00%	73 Missing ⚠️
...els/stages/layout/layout_object_detection_model.py	30.76%	54 Missing ⚠️
docling/datamodel/stage_model_specs.py	54.41%	31 Missing ⚠️
...dels/inference_engines/object_detection/factory.py	33.33%	16 Missing ⚠️
.../models/inference_engines/object_detection/base.py	70.83%	14 Missing ⚠️

📢 Thoughts on this report? Let us know!

[dosubot]

Related Documentation

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

^{How did I do? Any feedback?}  

[dolfim-ibm]

great 🚀