{"record":{"id":"455d4646aeb4097e","repo":"vllm-project/vllm","slug":"failed-to-initialize-pynccleplbcommunicator-exc","errorCode":null,"errorMessage":"Failed to initialize PyNcclEplbCommunicator ({exc}).","messagePattern":"Failed to initialize PyNcclEplbCommunicator \\((.+?)\\)\\.","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"vllm/distributed/eplb/eplb_communicator.py","lineNumber":725,"sourceCode":"        if unsupported_dtypes:\n            raise RuntimeError(\n                \"EPLB communicator 'pynccl' requested but expert weights contain \"\n                \"unsupported dtypes: \"\n                f\"({', '.join(str(dtype) for dtype in unsupported_dtypes)}).\"\n            )\n\n        device_comm = group_coordinator.device_communicator\n        pynccl_comm = (\n            getattr(device_comm, \"pynccl_comm\", None)\n            if device_comm is not None\n            else None\n        )\n        if pynccl_comm is None or pynccl_comm.disabled or not pynccl_comm.available:\n            raise RuntimeError(\"EPLB communicator 'pynccl' requested but unavailable.\")\n        try:\n            return PyNcclEplbCommunicator(pynccl_comm=pynccl_comm)\n        except Exception as exc:\n            raise RuntimeError(\n                f\"Failed to initialize PyNcclEplbCommunicator ({exc}).\"\n            ) from exc\n\n    is_stateless = isinstance(group_coordinator, StatelessGroupCoordinator)\n    if is_stateless:\n        if backend == \"nixl\":\n            pass  # handled below with defer_remote_setup=True\n        elif backend not in (\"torch_nccl\", \"pynccl\"):\n            raise ValueError(\n                f\"Elastic EP requires 'torch_nccl', 'pynccl', or 'nixl' \"\n                f\"EPLB communicator (got '{backend}').\"\n            )\n        else:\n            if backend == \"torch_nccl\":\n                logger.warning(\n                    \"Stateless elastic EP requires PyNCCL backend. \"\n                    \"Forcing EPLB communicator to 'pynccl'.\"\n                )","sourceCodeStart":707,"sourceCodeEnd":743,"githubUrl":"https://github.com/vllm-project/vllm/blob/c794754062d49a8fdb63ab3c5215b488b865030c/vllm/distributed/eplb/eplb_communicator.py#L707-L743","documentation":"Error \"Failed to initialize PyNcclEplbCommunicator ({exc}).\" thrown in vllm-project/vllm.","triggerScenarios":"Raised at vllm/distributed/eplb/eplb_communicator.py:725 when validation fails: Failed to initialize PyNcclEplbCommunicator. Typically triggered by an incompatible or incomplete vLLM configuration, an unsupported platform/backend combination, or a runtime resource/dependency that is missing.","commonSituations":"Commonly encountered at vllm/distributed/eplb/eplb_communicator.py:725 during vLLM startup/config validation or runtime setup when: (1) conflicting CLI flags or config fields are combined, (2) the current platform (CUDA/ROCm/CPU/XPU) or installed optional packages do not support the requested feature, or (3) a required value is absent or out of range. Resolve by correcting the configuration as described in the message, or by selecting a supported alternative.","solutions":["Inspect the wrapped exception in the error for the root cause of PyNcclEplbCommunicator initialization failure."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"c794754062d49a8fdb63ab3c5215b488b865030c","analyzedAt":"2026-08-14T21:17:39.825Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}