tensorflow/models · error · LookupError

collection path {entry_name} at position {h_idx} is never re

Error message

collection path {entry_name} at position {h_idx} is never registered. Please make sure the {entry_name} and its library is imported and linked to the trainer binary.

What it means

Error "collection path {entry_name} at position {h_idx} is never registered. Please make sure the {entry_name} and its library is imported and linked to the trainer binary." thrown in tensorflow/models.

Source

Thrown at official/core/registry.py:89

  this function will return
  registered_collection["my_model"]["my_exp"]["my_config_0"].

  Args:
    registered_collection: a dictionary. The decorated function or class will be
      retrieved from this collection.
    reg_key: The key for retrieving the registered function or class. If reg_key
      is a string, it can be hierarchical like my_model/my_exp/my_config_0
  Returns:
    The registered function or class.
  Raises:
    LookupError: when reg_key cannot be found.
  """
  if isinstance(reg_key, str):
    hierarchy = reg_key.split("/")
    collection = registered_collection
    for h_idx, entry_name in enumerate(hierarchy):
      if entry_name not in collection:
        raise LookupError(
            f"collection path {entry_name} at position {h_idx} is never "
            f"registered. Please make sure the {entry_name} and its library is "
            "imported and linked to the trainer binary.")
      collection = collection[entry_name]
    return collection
  else:
    if reg_key not in registered_collection:
      raise LookupError(
          f"registration key {reg_key} is never "
          f"registered. Please make sure the {reg_key} and its library is "
          "imported and linked to the trainer binary.")
    return registered_collection[reg_key]

View on GitHub (pinned to e006f5f0d5)

When it happens

Trigger: Thrown at official/core/registry.py:89 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tensorflow/models@e006f5f0d5 (2026-08-24). Data as JSON: /api/errors/7417cd2b377c7bd1. Report an issue: GitHub.