{"record":{"id":"75781b5704278e24","repo":"LykosAI/StabilityMatrix","slug":"your-package-has-not-yet-been-upgraded-to-use-hip-sdk-6-4-to-75781b","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/ForgeAmdGpu.cs","lineNumber":126,"sourceCode":"                installLocation,\n                pythonVersion: options.PythonOptions.PythonVersion\n            )\n            .ConfigureAwait(false);\n        await venvRunner.PipInstall(\"--upgrade pip wheel\", onConsoleOutput).ConfigureAwait(false);\n        progress?.Report(new ProgressReport(1, \"Install finished\", 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        var portableGitBin = new DirectoryPath(PrerequisiteHelper.GitBinPath);\n        var hipPath = Path.Combine(\n            Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles),\n            \"AMD\",\n            \"ROCm\",\n            \"6.4\"\n        );\n        var hipBinPath = Path.Combine(hipPath, \"bin\");\n        var envVars = new Dictionary<string, string>\n        {\n            [\"ZLUDA_COMGR_LOG_LEVEL\"] = \"1\",\n            [\"HIP_PATH\"] = hipPath,","sourceCodeStart":108,"sourceCodeEnd":144,"githubUrl":"https://github.com/LykosAI/StabilityMatrix/blob/af93d6ef57c01cd890d7e0ad0a9ea8c9fcda3002/StabilityMatrix.Core/Models/Packages/ForgeAmdGpu.cs#L108-L144","documentation":"ForgeAmdGpu.RunPackage throws MissingPrerequisiteException when PrerequisiteHelper.IsHipSdkInstalled is false. The Forge AMD GPU package needs the HIP SDK to launch, and this message indicates the installed package version predates the HIP SDK 6.4 upgrade and must be updated or auto-migrated.","triggerScenarios":"RunPackage on a ForgeAmdGpu package when the HIP SDK is absent or not detected (old SDK version, broken install, or package not yet migrated to 6.4).","commonSituations":"User switches to the AMD GPU Forge variant on a machine without HIP SDK; HIP SDK was uninstalled during driver cleanup; package pinned to a pre-6.4 version.","solutions":["Install/repair AMD HIP SDK 6.4, then restart Stability Matrix so the prerequisite check passes.","Update the package or pick 'Change Version' from the 3-dots menu to auto-upgrade to the HIP SDK 6.4 build.","Confirm the SDK version recognized by PrerequisiteHelper matches 6.4; reinstall if the registry entries are stale.","As a workaround, switch to the non-Zluda/CPU variant if your hardware doesn't support HIP."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if (!PrerequisiteHelper.IsHipSdkInstalled)\n{\n    // direct user to install HIP SDK 6.4 or use 'Change Version' to upgrade the package\n    return;\n}\nawait package.RunPackage(...);","typeGuard":null,"tryCatchPattern":"try { await package.RunPackage(...); }\ncatch (MissingPrerequisiteException ex) { ShowHipSdkInstallPrompt(ex); }","preventionTips":["Verify HIP SDK presence after driver/OS updates which can remove it","Use the 'Change Version' migration prompt when offered","Restart the app after installing HIP SDK so detection refreshes"],"tags":["missing-prerequisite","hip-sdk","amd-gpu","forge"],"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"}