Wonderful Launcher Quick Start

Use this guide when you want the shortest path from opening Wonderful Launcher to a working ComfyUI workspace.

What this guide covers

• selecting the active ComfyUI runtime package
• opening the package selector when you need to add or switch packages
• launching ComfyUI from Home
• watching startup logs without leaving the launcher
• opening the embedded Workspace

Before you start

• Install Wonderful Launcher on Windows.
• If you already have a ComfyUI folder, keep its location ready in case you need to add it from the package selector.
• If the correct package is already selected in the bottom package selector, you can skip Step 2 and go straight to launch.

Managed package vs existing folder

Step 1: Open Home

Start on Home. This page is where you confirm the active package, launch ComfyUI, read startup logs, and jump into Workspace.

Step 2: Confirm the active package

Use the package selector near the bottom of Home to confirm which ComfyUI runtime will launch.

If the package you need is already listed, select it and continue. If you need to add another ComfyUI folder, open the selector and choose Add ComfyUI Directory.

In the current Avalonia UI, package setup and switching happen from this selector rather than a separate first-run install dialog.

Step 3: Launch ComfyUI and read the startup logs

Back on Home, click Launch ComfyUI. The launcher keeps you on the same page and expands the startup log panel so you can watch what is happening without switching to a separate terminal window.

Step 4: Open Workspace

When the title bar changes to ComfyUI running and the Workspace entry becomes available in the right-side Toolbox, open Workspace. The embedded ComfyUI page opens inside Wonderful Launcher.

Your exact canvas can vary. A fresh package usually opens the default workflow. An existing package may reopen the last workflow you used.

What success looks like

When ComfyUI has fully started, you should see:

• The title bar shows a green ComfyUI running status.
• The package selector at the bottom shows the active runtime package.
• The Home log panel shows the GUI URL or a ready signal.
• The Workspace entry becomes available in the right-side Toolbox.
• Opening Workspace loads the embedded ComfyUI web UI.

If startup fails

Open the log panel first. Copy the visible error message, then use the related troubleshooting guides.

• ComfyUI startup failed
• ComfyUI plugin import failed
• Dependency conflicts

If Workspace opens with warnings

If the launcher starts correctly but the Workspace reports missing nodes or missing models, continue with the workflow-specific guides:

• Install custom nodes
• ComfyUI custom nodes broke environment
• Download Models

Where to find logs

If something goes wrong, logs are the fastest way to diagnose it:

1. Home log panel: expand the log area under the launch button to watch real-time output.
2. Startup Logs: open Startup Logs from the right-side Toolbox when you want to return to the launch output.
3. Task console: open Task console from the right-side Toolbox for launcher-side task sessions.
4. Log files on disk: the package directory keeps the latest .log files for deeper inspection.

Beginner FAQ

Can I run multiple ComfyUI packages at the same time?

No. Wonderful Launcher runs one ComfyUI instance at a time. Stop the current one first, then switch packages from Home.

Do I need a GPU?

A dedicated NVIDIA GPU is strongly recommended for practical image generation. CPU-only startup works, but image generation will be very slow.

Where do I switch packages?

Use the package selector near the bottom of Home. That is the fastest way to move between imported or installed runtimes.

Next guides

• System Requirements
• Install Custom Nodes
• Common Issues