{"record":{"id":"557988c74950b3a2","repo":"LykosAI/StabilityMatrix","slug":"your-package-has-not-yet-been-upgraded-to-use-hip-sdk-6-4-to","errorCode":null,"errorMessage":"Your package has not yet been upgraded to use HIP SDK 6.4. To continue, please update this package or select \"Change Version\" from the 3-dots menu to have it upgraded automatically for you","messagePattern":"Your package has not yet been upgraded to use HIP SDK 6\\.4\\. To continue, please update this package or select \"Change Version\" from the 3-dots menu to have it upgraded automatically for you","errorType":"exception","errorClass":"MissingPrerequisiteException","httpStatus":null,"severity":"error","filePath":"StabilityMatrix.Core/Models/Packages/ComfyZluda.cs","lineNumber":203,"sourceCode":"            onConsoleOutput,\n            GetEnvVars(true)\n        );\n        await installProcess.WaitForExitAsync(cancellationToken).ConfigureAwait(false);\n\n        progress?.Report(new ProgressReport(1, \"Installed Successfully\", isIndeterminate: false));\n    }\n\n    public override async Task RunPackage(\n        string installLocation,\n        InstalledPackage installedPackage,\n        RunPackageOptions options,\n        Action<ProcessOutput>? onConsoleOutput = null,\n        CancellationToken cancellationToken = default\n    )\n    {\n        if (!PrerequisiteHelper.IsHipSdkInstalled)\n        {\n            throw new MissingPrerequisiteException(\n                \"HIP SDK\",\n                \"Your package has not yet been upgraded to use HIP SDK 6.4. To continue, please update this package or select \\\"Change Version\\\" from the 3-dots menu to have it upgraded automatically for you\"\n            );\n        }\n        await SetupVenv(installLocation, pythonVersion: PyVersion.Parse(installedPackage.PythonVersion))\n            .ConfigureAwait(false);\n\n        var launchArguments = NormalizeLaunchArguments(installedPackage, options.Arguments);\n\n        var zludaPath = Path.Combine(installLocation, LaunchCommand);\n        ProcessArgs args = [\"--\", VenvRunner.PythonPath.ToString(), \"main.py\", .. launchArguments];\n        zludaProcess = ProcessRunner.StartAnsiProcess(\n            zludaPath,\n            args,\n            installLocation,\n            HandleConsoleOutput,\n            GetEnvVars(false)\n        );","sourceCodeStart":185,"sourceCodeEnd":221,"githubUrl":"https://github.com/LykosAI/StabilityMatrix/blob/af93d6ef57c01cd890d7e0ad0a9ea8c9fcda3002/StabilityMatrix.Core/Models/Packages/ComfyZluda.cs#L185-L221","documentation":"ComfyZluda.RunPackage throws MissingPrerequisiteException when PrerequisiteHelper.IsHipSdkInstalled is false. AMD GPU packages like ComfyUI-Zluda require the AMD HIP SDK to be present on Windows before launching. The message also signals that older package versions targeting a previous HIP SDK must be upgraded to the HIP SDK 6.4-based version.","triggerScenarios":"Calling RunPackage on a ComfyZluda package on a machine where the HIP SDK is not detected (never installed, or an older 5.x/6.x-mismatched install that the check does not recognize).","commonSituations":"Fresh Windows AMD setup where the user skipped HIP SDK installation; user installed HIP SDK but not the version the updated package expects; package installed before the 6.4 upgrade and never updated via 'Change Version'.","solutions":["Install AMD HIP SDK 6.4 from AMD's website and re-run detection (restart the app so PrerequisiteHelper re-scans).","Update the package, or use the 3-dots menu 'Change Version' to let Stability Matrix upgrade it to the HIP SDK 6.4-compatible version.","Verify the HIP SDK install path is the standard one the detection logic checks (registry/Program Files AMD folder).","If HIP SDK is genuinely installed, check that the installed flavor matches your GPU (e.g. ROCm HIP SDK for supported RDNA cards)."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if (!PrerequisiteHelper.IsHipSdkInstalled)\n{\n    // prompt user to install HIP SDK 6.4 or upgrade the package before calling RunPackage\n    return;\n}\nawait package.RunPackage(...);","typeGuard":null,"tryCatchPattern":"try { await package.RunPackage(...); }\ncatch (MissingPrerequisiteException ex) { ShowInstallPrerequisiteDialog(ex.Prerequisite); }","preventionTips":["Check the Prerequisites page before installing/launching AMD GPU packages","Install HIP SDK 6.4 before adding Zluda/AMD packages","Keep packages updated so they target the SDK version Stability Matrix expects"],"tags":["missing-prerequisite","hip-sdk","amd-gpu","windows"],"backgroundTag":"missing-dependency","analyzedSha":"af93d6ef57c01cd890d7e0ad0a9ea8c9fcda3002","analyzedAt":"2026-09-12T19:02:43.389Z","contentChangedAt":"2026-09-12T19:02:43.389Z","schemaVersion":2},"datasetVersion":"2026-09-16T04:17:20.429Z"}