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.models

What it means

Importing timm.models.registry is deprecated: the module moved to timm.models._registry and this shim re-exports it with a FutureWarning. Use timm.models (or timm.models._registry) for register_model and registry lookups.

Source

Thrown at timm/models/registry.py:4

from ._registry import *

import warnings
warnings.warn(f"Importing from {__name__} is deprecated, please import via timm.models", FutureWarning)

View on GitHub (pinned to 9a5261e31b)

Solutions

  1. Use from timm import register_model or from timm.models import register_model
  2. Use timm.models._registry for entrypoint dicts (_model_entrypoints, _model_to_module)
  3. Grep for 'timm.models.registry' and migrate

Example fix

# before
from timm.models.registry import register_model
# after
from timm import register_model
Defensive patterns

Strategy: validation

Validate before calling

from timm import register_model  # modern path
from timm.models._registry import _model_entrypoints  # if you need registry internals

Prevention

When it happens

Trigger: from timm.models.registry import register_model; import timm.models.registry in code defining custom timm models.

Common situations: Custom model plugins registering architectures, written against pre-0.9 timm.

Related errors

AI-assisted analysis of huggingface/pytorch-image-models@9a5261e31b (2026-08-27). Data as JSON: /api/errors/005d620a230b129e. Report an issue: GitHub.