Wonderful Launcher Quick Start
Install or import ComfyUI, start the runtime, and open the embedded workspace from Wonderful Launcher.
Tested Environment
- OS: Windows 10 / 11
- Launcher: Wonderful Launcher v1.x
- ComfyUI: Portable / Managed install
- Python: 3.11+
- CUDA / Torch: CUDA 12.x / Torch 2.x
- Last tested: 2026-05-19
Use this guide when you are opening Wonderful Launcher for the first time and want the shortest path into a working ComfyUI workspace.
Ready to get started? Download Wonderful Launcher for Windows and follow along.
What this guide covers
- choosing between Deploy and Import
- starting ComfyUI from the Home page
- checking startup progress
- opening the embedded Workspace
Before you start
You need Wonderful Launcher installed on Windows. If you already have a ComfyUI folder, keep it available so you can import it instead of deploying a fresh package.
Deploy vs Import: which should I pick?
| Deploy | Import | |
|---|---|---|
| When to use | You are new to ComfyUI or want a clean, managed install | You already have a working ComfyUI folder on disk |
| What happens | Launcher downloads and sets up a complete ComfyUI package | Launcher points to your existing folder and manages it in-place |
| Models & nodes | Starts empty — install what you need afterwards | Keeps everything you already have |
| Best for | First-time users | Migrating from a manual or portable install |
Step 1: Open the Home page
When the app opens, stay on Home. This is where you choose the active ComfyUI package and start the runtime.
Step 2: Choose Deploy or Import
Use Deploy when you want Wonderful Launcher to install a managed ComfyUI package for you.
Use Import when you already have a local ComfyUI folder and want the launcher to manage it.
Step 3: Start ComfyUI
Click Get Started or the main start button on Home. The launcher starts ComfyUI and shows progress in the app instead of leaving you to read a separate terminal.
Step 4: Open Workspace
When ComfyUI is ready, open Workspace from the bottom bar. The ComfyUI web interface appears inside the launcher.
What success looks like
When ComfyUI has fully started, you will see:
- The Home page shows a green running indicator next to the active package.
- The Workspace tab in the bottom bar becomes active and clickable.
- Inside Workspace, the ComfyUI node editor loads with the default workflow (or your last-used workflow).
- No red error banners appear at the top of the Home page.
If startup fails
Open the logs first. Copy the visible error message, then use Agent or the related troubleshooting guides to repair the environment.
Where to find logs
If something goes wrong, logs are the fastest way to diagnose:
- In-app log panel — on the Home page, expand the log area below the start button to see real-time output from ComfyUI.
- Log files on disk — Wonderful Launcher writes log files to the
logsfolder inside each ComfyUI package directory. Look for the most recent.logfile. - Windows Event Viewer — for crashes that prevent the launcher itself from starting, check Application logs in the Windows Event Viewer.
When asking for help, always include the last 20–30 lines of the log. This saves everyone time.
Beginner FAQ
Can I run multiple ComfyUI packages at the same time?
No. Wonderful Launcher runs one ComfyUI instance at a time. You can switch between packages by stopping the current one and starting another from the Home page.
Do I need a GPU?
A dedicated NVIDIA GPU with at least 4 GB VRAM is strongly recommended. ComfyUI can run on CPU, but image generation will be extremely slow. AMD GPU support is experimental.
How do I update ComfyUI after deploying it?
Use the package management features on the Home page. The launcher can update ComfyUI and custom nodes in place without losing your models or workflows.
Next guides
You can fix it manually, or download Wonderful Launcher for Windows to diagnose plugin errors, missing dependencies, and broken ComfyUI environments without reinstalling.
Download free for WindowsDid this fix your issue?
Your answer helps prioritize verified ComfyUI repairs.