ultralytics 8.3.199 3% Faster Ultralytics Imports with Lazy Model Loading (#21985)

Signed-off-by: Glenn Jocher <glenn.jocher@ultralytics.com>
Co-authored-by: UltralyticsAssistant <web@ultralytics.com>
Co-authored-by: Glenn Jocher <glenn.jocher@ultralytics.com>
This commit is contained in:
Muhammad Rizwan Munawar 2025-09-12 17:02:57 +05:00 committed by GitHub
parent 4b57865cd4
commit 8f7fe171f0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 43 additions and 9 deletions

View File

@ -0,0 +1,20 @@
---
description: Learn how Ultralytics uses lazy imports with __getattr__ to speed up package startup and load model classes like YOLO, NAS, RTDETR, and SAM only when needed.
keywords: Ultralytics, YOLO, lazy import, __getattr__, NAS, RTDETR, SAM, FastSAM, YOLOWorld, performance, startup time, optimization
---
# Reference for `ultralytics/__init__.py`
!!! note
This file is available at [https://github.com/ultralytics/ultralytics/blob/main/ultralytics/\_\_init\_\_.py](https://github.com/ultralytics/ultralytics/blob/main/ultralytics/__init__.py). If you spot a problem please help fix it by [contributing](https://docs.ultralytics.com/help/contributing/) a [Pull Request](https://github.com/ultralytics/ultralytics/edit/main/ultralytics/__init__.py) 🛠️. Thank you 🙏!
<br>
## ::: ultralytics.__getattr__
<br><br><hr><br>
## ::: ultralytics.__dir__
<br><br>

View File

@ -531,6 +531,7 @@ nav:
- hub/api/index.md
- Reference:
- __init__: reference/__init__.md
- cfg:
- __init__: reference/cfg/__init__.md
- data:

View File

@ -1,30 +1,43 @@
# Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/license
__version__ = "8.3.198"
__version__ = "8.3.199"
import importlib
import os
# Set ENV variables (place before imports)
if not os.environ.get("OMP_NUM_THREADS"):
os.environ["OMP_NUM_THREADS"] = "1" # default for reduced CPU utilization during training
from ultralytics.models import NAS, RTDETR, SAM, YOLO, YOLOE, FastSAM, YOLOWorld
from ultralytics.utils import ASSETS, SETTINGS
from ultralytics.utils.checks import check_yolo as checks
from ultralytics.utils.downloads import download
settings = SETTINGS
MODELS = ("YOLO", "YOLOWorld", "YOLOE", "NAS", "SAM", "FastSAM", "RTDETR")
__all__ = (
"__version__",
"ASSETS",
"YOLO",
"YOLOWorld",
"YOLOE",
"NAS",
"SAM",
"FastSAM",
"RTDETR",
*MODELS,
"checks",
"download",
"settings",
)
def __getattr__(name: str):
"""Lazy-import model classes on first access."""
if name in MODELS:
return getattr(importlib.import_module("ultralytics.models"), name)
raise AttributeError(f"module {__name__} has no attribute {name}")
def __dir__():
"""Extend dir() to include lazily available model names for IDE autocompletion."""
return sorted(set(globals()) | set(MODELS))
if __name__ == "__main__":
print(__version__)