LykosAI/StabilityMatrix · error · MissingPrerequisiteException

Your package has not yet been upgraded to use HIP SDK 6.4…

Error message

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

What it means

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.

Solutions

  1. Install/repair AMD HIP SDK 6.4, then restart Stability Matrix so the prerequisite check passes.
  2. Update the package or pick 'Change Version' from the 3-dots menu to auto-upgrade to the HIP SDK 6.4 build.
  3. Confirm the SDK version recognized by PrerequisiteHelper matches 6.4; reinstall if the registry entries are stale.
  4. As a workaround, switch to the non-Zluda/CPU variant if your hardware doesn't support HIP.
Defensive patterns

Strategy: validation

Validate before calling

if (!PrerequisiteHelper.IsHipSdkInstalled)
{
    // direct user to install HIP SDK 6.4 or use 'Change Version' to upgrade the package
    return;
}
await package.RunPackage(...);

Try / catch

try { await package.RunPackage(...); }
catch (MissingPrerequisiteException ex) { ShowHipSdkInstallPrompt(ex); }

Prevention

When it happens

Trigger: 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).

Common situations: 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.

Understand the failure class

Background: "not installed", "pip install", "required for": how missing-dependency errors surface across open-source libraries — this error's family across 34 libraries.

Related errors

AI-assisted analysis of LykosAI/StabilityMatrix@af93d6ef57 (2026-09-12). Data as JSON: /api/errors/75781b5704278e24. Report an issue: GitHub.

Appendix: source

Thrown at StabilityMatrix.Core/Models/Packages/ForgeAmdGpu.cs:126

                installLocation,
                pythonVersion: options.PythonOptions.PythonVersion
            )
            .ConfigureAwait(false);
        await venvRunner.PipInstall("--upgrade pip wheel", onConsoleOutput).ConfigureAwait(false);
        progress?.Report(new ProgressReport(1, "Install finished", isIndeterminate: false));
    }

    public override async Task RunPackage(
        string installLocation,
        InstalledPackage installedPackage,
        RunPackageOptions options,
        Action<ProcessOutput>? onConsoleOutput = null,
        CancellationToken cancellationToken = default
    )
    {
        if (!PrerequisiteHelper.IsHipSdkInstalled)
        {
            throw new MissingPrerequisiteException(
                "HIP SDK",
                "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"
            );
        }
        await SetupVenv(installLocation, pythonVersion: PyVersion.Parse(installedPackage.PythonVersion))
            .ConfigureAwait(false);
        var portableGitBin = new DirectoryPath(PrerequisiteHelper.GitBinPath);
        var hipPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.ProgramFiles),
            "AMD",
            "ROCm",
            "6.4"
        );
        var hipBinPath = Path.Combine(hipPath, "bin");
        var envVars = new Dictionary<string, string>
        {
            ["ZLUDA_COMGR_LOG_LEVEL"] = "1",
            ["HIP_PATH"] = hipPath,

View on GitHub (pinned to af93d6ef57)