huggingface/pytorch-image-models · warning · FutureWarning
Importing from {__name__} is deprecated, please import via t
Error message
Importing from {__name__} is deprecated, please import via timm.optim What it means
Importing timm.optim.optim_factory is deprecated: the functions moved to timm.optim._optim_factory and timm.optim._param_groups, and this shim re-exports them with a FutureWarning. The comment in the shim acknowledges the common 'import timm.optim.optim_factory as optim_factory' pattern.
Source
Thrown at timm/optim/optim_factory.py:7
# lots of uses of these functions directly, ala 'import timm.optim.optim_factory as optim_factory', fun :/
from ._optim_factory import create_optimizer, create_optimizer_v2, optimizer_kwargs
from ._param_groups import param_groups_layer_decay, param_groups_weight_decay, group_parameters, _layer_map, _group
import warnings
warnings.warn(f"Importing from {__name__} is deprecated, please import via timm.optim", FutureWarning)
View on GitHub (pinned to 9a5261e31b)
Solutions
- Change to from timm.optim import create_optimizer_v2, optimizer_kwargs
- For module-style usage: import timm.optim as optim_factory
- Grep for 'timm.optim.optim_factory' and 'optim_factory.create_optimizer' references and migrate
Example fix
# before import timm.optim.optim_factory as optim_factory optimizer = optim_factory.create_optimizer_v2(model, opt='adamw', lr=1e-3) # after from timm.optim import create_optimizer_v2 optimizer = create_optimizer_v2(model, opt='adamw', lr=1e-3)
Defensive patterns
Strategy: validation
Validate before calling
from timm.optim import create_optimizer_v2, optimizer_kwargs # modern path
Prevention
- Use from timm.optim import ... in training scripts
- Grep for 'optim_factory' references when upgrading
- Pin timm>=0.9 and run import smoke tests in CI
When it happens
Trigger: import timm.optim.optim_factory as optim_factory; from timm.optim.optim_factory import create_optimizer, create_optimizer_v2, optimizer_kwargs — pervasive in timm-based training repos.
Common situations: Nearly every training script from the timm/examples lineage after upgrading timm past the module rename.
Related errors
- Importing from {__name__} is deprecated, please import via t
- Importing from {__name__} is deprecated, please import via t
- Importing from {__name__} is deprecated, please import via t
- Importing from {__name__} is deprecated, please import via t
- Importing from {__name__} is deprecated, please import via t
AI-assisted analysis of huggingface/pytorch-image-models@9a5261e31b (2026-08-27).
Data as JSON: /api/errors/e4aad8516b43d56b.
Report an issue: GitHub.