tensorflow/models · error · ConfigError

Config file must contain a top-level mapping of settings.

Error message

Config file must contain a top-level mapping of settings.

What it means

Error "Config file must contain a top-level mapping of settings." thrown in tensorflow/models.

Source

Thrown at official/projects/waste_identification_ml/data_generation/auto_labeler_pipeline/config_loader.py:666

  Raises:
      ConfigError: If the file is missing, is not valid YAML, is missing
          required fields, contains out-of-range values, or names a
          ``prompt_to_detect`` that has no block under ``prompts``.
  """
  if not os.path.isfile(config_path):
    raise ConfigError(f"Config file does not exist: {config_path}")

  try:
    with open(config_path, "r", encoding="utf-8") as config_file:
      raw_config = yaml.safe_load(config_file)
  except OSError as error:
    raise ConfigError(f"Cannot read config file: {error}") from error
  except yaml.YAMLError as error:
    raise ConfigError(f"Config file is not valid YAML: {error}") from error

  if not isinstance(raw_config, dict):
    raise ConfigError(
        "Config file must contain a top-level mapping of settings."
    )

  _require_keys(raw_config, _REQUIRED_TOP_LEVEL_KEYS, "config.yaml")

  root_dir = _require_non_empty_string(raw_config["root_dir"], "root_dir")
  sam3_checkpoint_path = _require_non_empty_string(
      raw_config["sam3_checkpoint_path"], "sam3_checkpoint_path"
  )
  cuda_visible_devices = _validate_cuda_visible_devices(
      raw_config["cuda_visible_devices"]
  )

  input_images_folder_name = _require_allowed_folder_name(
      raw_config["input_images_folder_name"], "input_images_folder_name"
  )
  train_val_folder_name = _require_allowed_folder_name(
      raw_config["train_val_folder_name"], "train_val_folder_name"

View on GitHub (pinned to e006f5f0d5)

When it happens

Trigger: Thrown at official/projects/waste_identification_ml/data_generation/auto_labeler_pipeline/config_loader.py:666 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/3dc38b0fb0d352e3. Report an issue: GitHub.