[GH-ISSUE #1029] [DevTask] Add better handling for partial / corrupt venv #268

Closed
opened 2026-10-31 22:10:55 +00:00 by bsakaguchi · 2 comments
Owner

Originally created by @webfiltered on GitHub (Mar 6, 2025).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1029

An interrupted initial venv download can result in server start throwing an error about yaml not being installed. This seems to be most-often caused by network issues.

The simplest fix is currently to reset the virtual environment.

Current user process

To reset the virtual environment from the error screen on server start:

  1. Click Troubleshoot
  2. If the All filter at the top is not highlight, click it to show all options
  3. Find Reset virtual environment, then click Reset
  4. Confirm by clicking the red Reset button

After this is done, another task should light up with an error - install python packages. This will install the requirements for ComfyUI Desktop to start. Any packages that are not already cached will automatically be downloaded.

Proposed

  • Detect this error
  • Offer option to reset and re-download

┆Issue is synchronized with this Notion page by Unito

Originally created by @webfiltered on GitHub (Mar 6, 2025). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1029 An interrupted initial venv download can result in server start throwing an error about yaml not being installed. This seems to be most-often caused by network issues. The simplest fix is currently to reset the virtual environment. ### Current user process To reset the virtual environment from the error screen on server start: 1. Click **Troubleshoot** 1. If the **All** filter at the top is not highlight, click it to show all options 1. Find **Reset virtual environment**, then click **Reset** 1. Confirm by clicking the red **Reset** button After this is done, another task should light up with an error - install python packages. This will install the requirements for ComfyUI Desktop to start. Any packages that are not already cached will automatically be downloaded. ### Proposed - [x] Detect this error - [x] Offer option to reset and re-download ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1029-DevTask-Add-better-handling-for-partial-corrupt-venv-1ae6d73d3650816c8b85d6d2b35a17e2) by [Unito](https://www.unito.io)
bsakaguchi 2026-10-31 22:10:55 +00:00
Author
Owner

@dosubot[bot] commented on GitHub (Sep 13, 2025):

Hi, @webfiltered. I'm Dosu, and I'm helping the desktop team manage their backlog and am marking this issue as stale.

Issue Summary:

  • You reported that interrupted initial venv downloads can cause server start failures due to missing packages like yaml.
  • The problem often stems from network issues during the download process.
  • Currently, the only fix is a manual venv reset.
  • You proposed improvements including better error detection, automatic reset and re-download, and the ability to switch download mirrors.
  • There has been no further activity or comments on this issue.

Next Steps:

  • Please let me know if this issue is still relevant with the latest version of the desktop app by commenting here.
  • If I don’t hear back within 7 days, I will automatically close this issue.

Thanks for your understanding and contribution!

<!-- gh-comment-id:3288575371 --> @dosubot[bot] commented on GitHub (Sep 13, 2025): Hi, @webfiltered. I'm [Dosu](https://dosu.dev), and I'm helping the desktop team manage their backlog and am marking this issue as stale. **Issue Summary:** - You reported that interrupted initial venv downloads can cause server start failures due to missing packages like yaml. - The problem often stems from network issues during the download process. - Currently, the only fix is a manual venv reset. - You proposed improvements including better error detection, automatic reset and re-download, and the ability to switch download mirrors. - There has been no further activity or comments on this issue. **Next Steps:** - Please let me know if this issue is still relevant with the latest version of the desktop app by commenting here. - If I don’t hear back within 7 days, I will automatically close this issue. Thanks for your understanding and contribution!
Author
Owner

@webfiltered commented on GitHub (Sep 21, 2025):

Change of mirrors to be addressed elsewhere. Removing subtask. The rest is now automatic.

<!-- gh-comment-id:3316019684 --> @webfiltered commented on GitHub (Sep 21, 2025): Change of mirrors to be addressed elsewhere. Removing subtask. The rest is now automatic.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Comfy-Org/desktop#268
No description provided.