"Deployment Failed: Downloading the Resource Package"

Symptoms

During the first deployment of a ComfyUI environment, the progress stalls at the "Downloading resource package" step and then reports a deployment failure.

Cause

The deployment process needs to download the ComfyUI installation package from GitHub. Slow or unstable access to GitHub is the most common cause of failure. Specific reasons include:

• Network restrictions: Direct connections to GitHub can be slow with high packet loss, causing large file downloads to time out
• Proxy misconfiguration: A proxy tool (Clash, v2rayN, etc.) is installed but the system or Git is not routing traffic through it
• Firewall blocking: Corporate or school networks may block GitHub domains
• Insufficient disk space: The installation drive does not have enough free space (at least 5 GB is required)

---

Solutions

Option 1: Configure a proxy in Wonderful Launcher (recommended)

If you already use a proxy tool (Clash, v2rayN, Shadowrocket, etc.), you just need to tell Wonderful Launcher to route traffic through it.

1. Open the Settings page in Wonderful Launcher
2. Find the Network Proxy setting
3. Enter your proxy address, then retry the deployment

Common local proxy addresses:

Proxy tool	HTTP proxy address	SOCKS5 proxy address
Clash / Clash Verge	http://127.0.0.1:7890	socks5://127.0.0.1:7891
v2rayN	http://127.0.0.1:10809	socks5://127.0.0.1:10808
Shadowsocks	http://127.0.0.1:1080	socks5://127.0.0.1:1080

Note: The port numbers above are defaults. Check your proxy tool to confirm the actual ports it uses.

---

Option 2: Set system environment variables (proxy all programs)

If Option 1 does not work, you can set proxy environment variables at the system level.

Temporary (current terminal session only):

Open PowerShell and run:

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

Or in CMD:

set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

Replace 7890 with the port your proxy tool actually uses.

Permanent (write to system environment variables):

1. Press Win + R, type sysdm.cpl, and press Enter
2. Go to the Advanced tab and click Environment Variables
3. Under User variables, create two new entries:
   • Variable name: HTTP_PROXY, Value: http://127.0.0.1:7890
   • Variable name: HTTPS_PROXY, Value: http://127.0.0.1:7890
4. Click OK, then restart Wonderful Launcher and retry the deployment

---

Option 3: Configure a Git proxy

The deployment process uses Git to clone repositories from GitHub. If Git is not using the proxy, the deployment can still fail even when GitHub loads fine in a browser.

Set a global Git proxy:

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

Proxy only GitHub traffic (recommended — leaves other repos unaffected):

git config --global http.https://github.com.proxy http://127.0.0.1:7890

Use a SOCKS5 proxy:

git config --global http.https://github.com.proxy socks5://127.0.0.1:7891

Verify the configuration:

git config --global --get http.proxy

Remove the proxy setting (to revert):

git config --global --unset http.proxy
git config --global --unset https.proxy

---

Option 4: Make sure the proxy tool is running

Often the issue is not configuration but that the proxy tool itself is not active. Check the following:

1. Open your proxy tool (Clash Verge, v2rayN, etc.) and confirm it is running
2. Confirm that System Proxy or Global Mode is enabled (not rule-based mode only)
3. Visit https://github.com in a browser to confirm it loads
4. If the browser works but deployment still fails, the proxy is not reaching Git — see Option 2 or Option 3

---

Option 5: Check disk space

Deploying ComfyUI requires at least 5 GB of free disk space.

Check free space in PowerShell:

Get-PSDrive -PSProvider FileSystem | Select-Object Name, @{N='Free(GB)';E={[math]::Round($_.Free/1GB,2)}}, @{N='Used(GB)';E={[math]::Round($_.Used/1GB,2)}}

Check in CMD:

wmic logicaldisk get name,freespace,size

If space is low, free up disk space or change the installation directory in Wonderful Launcher settings to a drive with more room.

---

Option 6: Retry the deployment

GitHub connection quality can fluctuate, and occasional timeouts are normal. Close the deployment dialog and click deploy again to retry. Try during off-peak hours for better results.

---

Still not resolved?

If none of the above methods work, contact support through the Contact Us button inside the app and include:

• Your network environment (home broadband / corporate network / school network)
• Whether you use a proxy tool, and its name and version
• A screenshot of the error message shown when deployment fails