{"record":{"id":"1d1af2d36d78af20","repo":"tensorflow/models","slug":"must-specify-task-index-when-number-of-workers-1","errorCode":null,"errorMessage":"Must specify task_index when number of workers > 1","messagePattern":"Must specify task_index when number of workers > 1","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"official/common/distribute_utils.py","lineNumber":226,"sourceCode":"  \"\"\"Set multi-worker cluster spec in TF_CONFIG environment variable.\n\n  Args:\n    worker_hosts: comma-separated list of worker ip:port pairs.\n    task_index: index of the worker.\n\n  Returns:\n    Number of workers in the cluster.\n  \"\"\"\n  tf_config = json.loads(os.environ.get(\"TF_CONFIG\", \"{}\"))\n  if tf_config:\n    num_workers = (\n        len(tf_config[\"cluster\"].get(\"chief\", [])) +\n        len(tf_config[\"cluster\"].get(\"worker\", [])))\n  elif worker_hosts:\n    workers = worker_hosts.split(\",\")\n    num_workers = len(workers)\n    if num_workers > 1 and task_index < 0:\n      raise ValueError(\"Must specify task_index when number of workers > 1\")\n    task_index = 0 if num_workers == 1 else task_index\n    os.environ[\"TF_CONFIG\"] = json.dumps({\n        \"cluster\": {\n            \"worker\": workers\n        },\n        \"task\": {\n            \"type\": \"worker\",\n            \"index\": task_index\n        }\n    })\n  else:\n    num_workers = 1\n  return num_workers\n\n\ndef get_strategy_scope(strategy):\n  if strategy:\n    strategy_scope = strategy.scope()","sourceCodeStart":208,"sourceCodeEnd":244,"githubUrl":"https://github.com/tensorflow/models/blob/e006f5f0d534913e49c1f1dae87364039fa607e2/official/common/distribute_utils.py#L208-L244","documentation":"Error \"Must specify task_index when number of workers > 1\" thrown in tensorflow/models.","triggerScenarios":"Thrown at official/common/distribute_utils.py:226 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"e006f5f0d534913e49c1f1dae87364039fa607e2","analyzedAt":"2026-08-24T14:09:15.576Z","schemaVersion":2},"datasetVersion":"2026-08-24T17:17:21.512Z"}