CA

    ComfyUI AMD WSL2 Doctor

    by Y_Y_ai

    1

    Diagnoses and fixes broken ComfyUI installations running on AMD Radeon GPUs under WSL2 (ROCm, ZLUDA, DirectML).

    $9

    /mo

    Subscription · cancel anytime

    Secure checkout via Stripe

    • Always the latest version
    • Delivered live to your agent via MCP
    • Cancel anytime, access ends at period end

    Works with the AI tools you already use

    CCCGGVW

    About this skill

    How to Use:
    To start, simply import this skill package into your AI agent environment and instruct your agent:
    "Load the skill defined in SKILL.md and help me diagnose my ComfyUI AMD setup."

    The agent will actively guide you to isolate which layer is failing. When troubleshooting, it will prompt you:
    1. To paste the exact traceback or describe the symptom (e.g. black images, OOM crash, GPU not found).
    2. To run targeted diagnostic commands (one at a time) to identify the root cause.
    3. To confirm before executing any package reinstallation or modification.

    ---
    About ComfyUI AMD WSL2 Doctor
    ComfyUI AMD WSL2 Doctor is a production-grade diagnostic skill package designed to help developers, creators, and AI artists running ComfyUI on AMD Radeon GPUs inside WSL2 (Windows Subsystem for Linux).

    AMD Radeon support under WSL2 is highly fragile because it sits at the intersection of Windows GPU drivers, WSL2 passthrough layers, ROCm/HIP runtimes, and PyTorch ROCm wheels. A single update to any of these components can silently break your entire image generation pipeline.

    This skill provides your AI agent with a specialized, step-by-step diagnostic framework. It avoids broad "reinstall everything" suggestions and instead isolates the exact failure point across your system layers within minutes.

    Key Highlights:
    • Precise Layer Isolation: Determines whether the failure lies in the Windows WDDM driver, WSL2's DXG bridge, system ROCm libraries, PyTorch wheels, or custom node dependencies.
    • Custom Node Protection: Provides strategies to pin PyTorch version using constraints, preventing ComfyUI Manager or custom node installers from overwriting your ROCm build with a CPU or CUDA version.
    • Numerical Precision Fixing: Addresses AMD-specific NaN/black image bugs caused by bfloat16 to numpy conversions and recommends targeted FP32 workarounds.
    • VRAM & Memory Tuning: Solves WSL2 RAM caps and PyTorch allocator limits that trigger Out-of-Memory crashes even on high-VRAM setups.

    Details

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Security Scanned

    Passed automated security review

    Permissions

    Write Files
    Read Files
    Browser
    Network Access
    Environment Variables

    Requires file reading to access skill guides, and network/browser access to cross-reference AMD compatibility pages and PyTorch wheel releases for the user's specific GPU and driver version.

    Creator

    AI Agent Architect specializing in R&D and tech innovation. I design high-performance, specialized AI agent skills to accelerate advanced product design, strategic backcasting, and system automation.

    Frequently Asked Questions

    More Premium Skills