horde-engine 3.2.9__tar.gz → 3.2.10__tar.gz

{horde_engine-3.2.9 → horde_engine-3.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: horde-engine
-Version: 3.2.9
+Version: 3.2.10
 Summary: A wrapper around ComfyUI to allow use by AI Horde.
 Project-URL: Homepage, https://github.com/Haidra-Org/hordelib
 Project-URL: Bug Tracker, https://github.com/Haidra-Org/hordelib/issues

{horde_engine-3.2.9 → horde_engine-3.2.10}/hordelib/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '3.2.9'
-__version_tuple__ = version_tuple = (3, 2, 9)
+__version__ = version = '3.2.10'
+__version_tuple__ = version_tuple = (3, 2, 10)
 
 __commit_id__ = commit_id = None

{horde_engine-3.2.9 → horde_engine-3.2.10}/hordelib/api.py

@@ -7,6 +7,8 @@ nothing here triggers a ComfyUI import (``hordelib.initialise()`` does that expl
 The contract is enforced by ``tests/meta/test_public_api_contract.py``.
 """
 
+from typing import TYPE_CHECKING
+
 from hordelib import initialise, is_initialised
 from hordelib.execution.interface import (
     ExecutionBackend,
@@ -67,7 +69,6 @@ from hordelib.pipeline.payload_pp import (
     classify_post_processor,
 )
 from hordelib.preload import controlnet_annotators_present
-from hordelib.shared_model_manager import SharedModelManager
 from hordelib.utils.ioredirect import ComfyUIProgress, ComfyUIProgressUnit
 from hordelib.utils.logger import HordeLog
 from hordelib.utils.torch_memory import (
@@ -82,6 +83,11 @@ from hordelib.utils.torch_memory import (
     log_free_ram,
 )
 
+if TYPE_CHECKING:
+    # Re-exported lazily (see ``__getattr__`` below) so the type checker still sees the name without the
+    # eager import that would drag torch into every consumer of this facade.
+    from hordelib.shared_model_manager import SharedModelManager
+
 __all__ = [
     "CONTROLNET_ANNOTATOR_DOWNLOAD_BYTES",
     "FEATURE_KIND",
@@ -142,3 +148,21 @@ __all__ = [
     "log_free_ram",
     "set_gpu_sampling_lease",
 ]
+
+
+def __getattr__(name: str) -> object:
+    """Lazily resolve the one torch-heavy re-export so the facade's import cost stays honest.
+
+    Every other name above comes from a torch-free submodule, so ``import hordelib.api`` is cheap
+    (~75MB) and pulls no torch. ``SharedModelManager`` is the exception: it transitively imports the
+    concrete model managers, which import torch (~500MB RSS). Re-exporting it eagerly would tax every
+    consumer of this facade with a full torch load, including the worker's torch-free orchestrator and
+    benchmark planner that only want the pure-Python helpers. PEP 562 module ``__getattr__`` defers that
+    import until ``SharedModelManager`` is actually accessed, so a consumer pays for torch only when it
+    asks for something that genuinely needs it.
+    """
+    if name == "SharedModelManager":
+        from hordelib.shared_model_manager import SharedModelManager
+
+        return SharedModelManager
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")