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

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.

Solutions

  1. Install AMD HIP SDK 6.4 from AMD's website and re-run detection (restart the app so PrerequisiteHelper re-scans).
  2. 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.
  3. Verify the HIP SDK install path is the standard one the detection logic checks (registry/Program Files AMD folder).
  4. If HIP SDK is genuinely installed, check that the installed flavor matches your GPU (e.g. ROCm HIP SDK for supported RDNA cards).
Defensive patterns

Strategy: validation

Validate before calling

if (!PrerequisiteHelper.IsHipSdkInstalled)
{
    // prompt user to install HIP SDK 6.4 or upgrade the package before calling RunPackage
    return;
}
await package.RunPackage(...);

Try / catch

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

Prevention

When it happens

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

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

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/557988c74950b3a2. Report an issue: GitHub.

Appendix: source

Thrown at StabilityMatrix.Core/Models/Packages/ComfyZluda.cs:203

            onConsoleOutput,
            GetEnvVars(true)
        );
        await installProcess.WaitForExitAsync(cancellationToken).ConfigureAwait(false);

        progress?.Report(new ProgressReport(1, "Installed Successfully", 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 launchArguments = NormalizeLaunchArguments(installedPackage, options.Arguments);

        var zludaPath = Path.Combine(installLocation, LaunchCommand);
        ProcessArgs args = ["--", VenvRunner.PythonPath.ToString(), "main.py", .. launchArguments];
        zludaProcess = ProcessRunner.StartAnsiProcess(
            zludaPath,
            args,
            installLocation,
            HandleConsoleOutput,
            GetEnvVars(false)
        );

View on GitHub (pinned to af93d6ef57)