[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73901":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":28,"readmeContent":29,"aiSummary":30,"trendingCount":16,"starSnapshotCount":16,"syncStatus":31,"lastSyncTime":32,"discoverSource":33},73901,"desktop","Comfy-Org\u002Fdesktop","Comfy-Org","The desktop app for ComfyUI (Windows & macOS)","https:\u002F\u002Fcomfy.org\u002Fdownload",null,"TypeScript",2304,223,29,48,0,19,34,97,57,105.75,"GNU General Public License v3.0",false,"main",[26,27],"ai","comfyui","2026-06-12 04:01:12","# ComfyUI Desktop\n\n![Beta](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbeta-blue.svg)\n\n# USER GUIDE\n\nPlease read the [user guide](https:\u002F\u002Fdocs.comfy.org\u002Finstallation\u002Fdesktop)\n\n# Download\n\nWindows (NVIDIA) NSIS x64: [Download](https:\u002F\u002Fdownload.comfy.org\u002Fwindows\u002Fnsis\u002Fx64)\n\nmacOS ARM: [Download](https:\u002F\u002Fdownload.comfy.org\u002Fmac\u002Fdmg\u002Farm64)\n\n# Overview\n\nThis desktop app is a packaged way to use [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI) and comes bundled with a few things:\n\n- Stable version of ComfyUI from [releases](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Freleases)\n- [ComfyUI_frontend](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002FComfyUI_frontend)\n- [ComfyUI-Manager](https:\u002F\u002Fgithub.com\u002Fltdrdata\u002FComfyUI-Manager) (installed via pip when `--enable-manager` is set; legacy custom node is only cloned for older ComfyUI versions)\n- [uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv)\n\nOn startup, it will install all the necessary python dependencies with uv and start the ComfyUI server. The app will automatically update with stable releases of ComfyUI, ComfyUI-Manager (pip), and the uv executable as well as some desktop-specific features.\n\nDevelopers, read on.\n\n## Installed Files\n\n### Electron\n\nThe desktop application comes bundled with:\n\n- ComfyUI source code\n- ComfyUI-Manager (pip package or legacy custom node, depending on the bundled ComfyUI version)\n- Electron, Chromium binaries, and node modules\n\n**Windows**\n\nWe use the [NSIS installer](https:\u002F\u002Fwww.electron.build\u002Fnsis.html) for Windows and it will install files in these locations:\n\nBundled Resources: `%LOCALAPPDATA%\\Programs\\ComfyUI`\n\n![screenshot of resources directory](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0e1d4a9a-7b7e-4536-ad4b-9e6123873706)\n\nUser files are stored here: `%APPDATA%\\ComfyUI`\n\nAutomatic Updates: `%LOCALAPPDATA%\\comfyui-electron-updater` or `%LOCALAPPDATA%\\@comfyorgcomfyui-electron-updater`\n\n**macOS**\n\nThe macOS application is distributed as a [DMG](https:\u002F\u002Fwww.electron.build\u002Fdmg) and will install files in:\n\n`~\u002FLibrary\u002FApplication Support\u002FComfyUI`\n\nThe application will be dragged into `\u002FApplications`\n\n**Linux**\n\n`~\u002F.config\u002FComfyUI`\n\n### ComfyUI\n\nYou will also be asked to select a location to store ComfyUI files like models, inputs, outputs, custom_nodes and saved workflows. This directory is stored in the `basePath` key of `config.json`.\n\nOn Windows: `%APPDATA%\\ComfyUI\\config.json`\n\nOn macOS: `~\u002FLibrary\u002FApplication Support\u002FComfyUI\u002Fconfig.json`\n\nOn Linux: `~\u002F.config\u002FComfyUI\u002Fconfig.json`\n\n#### Model Paths\n\nThis directory is also written as the `base_path` in `extra_models_config.yaml`. The Desktop app will look for model checkpoints here by default, but you can add additional models to the search path by editing this file.\n\nOn Windows: `%APPDATA%\\ComfyUI\\extra_models_config.yaml`\n\nOn macOS: `~\u002FLibrary\u002FApplication Support\u002FComfyUI\u002Fextra_models_config.yaml`\n\nOn Linux: `~\u002F.config\u002FComfyUI\u002Fextra_models_config.yaml`\n\n### Logs\n\nWe use electron-log to log everything. Electron main process logs are in `main.log`, and ComfyUI server logs are in `comfyui_\u003Cdate>.log`.\n\n```\non Linux: ~\u002F.config\u002F{app name}\u002Flogs\non macOS: ~\u002FLibrary\u002FLogs\u002F{app name}\non Windows: %AppData%\\{app name}\\logs\n```\n\n# Development\n\n## Setup Python\n\nMake sure you have python 3.12+ installed. It is recommended to setup a virtual environment.\n\nLinux\u002FMacOS:\n\n```bash\npython -m venv venv\nsource venv\u002Fbin\u002Factivate\n```\n\nWindows:\n\n```powershell\npy -3.12 -m venv venv\n.\\venv\\Scripts\\Activate.ps1\n```\n\n## Windows\n\n### Visual Studio\n\nVisual studio 2019 or later with the Desktop C++ workload is required for `node-gyp`. See the `node-gyp` [windows installation notes](https:\u002F\u002Fgithub.com\u002Fnodejs\u002Fnode-gyp#on-windows). Also requires the `spectre-mitigated` libraries, found in the individual components section of the VS installer.\n\nConfirmed working:\n\n- Visual Studio Community 2022 - 17.12.1\n- Desktop development with C++ workload\n- MSVC v143 x64 spectre-mitigated libraries (Latest \u002F v14.42-17.12)\n  - Open the Visual Studio Installer\n  - Click \"Modify\" on your Visual Studio 2022 Community installation\n  - Go to the \"Individual Components\" tab\n  - Search for \"Spectre\"\n  - Check the boxes for the Spectre-mitigated libraries that match your project's architecture (x86 and\u002For x64)\n  - ![image](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F0829db3d-84b7-48e8-9d13-c72c35169a05)\n\nLook for \"MSVC v143 - VS 2022 C++ x64\u002Fx86 Spectre-mitigated libs\"\nIf you're using other toolsets, you may need their corresponding Spectre-mitigated libraries as well\n\n## NPM Dependencies\n\n### Node\n\nWe recommend using [nvm](https:\u002F\u002Fgithub.com\u002Fnvm-sh\u002Fnvm) to manage node versions. This project uses node v20.x.\n\n#### Windows\n\nMicrosoft recommends [nvm-windows](https:\u002F\u002Fgithub.com\u002Fcoreybutler\u002Fnvm-windows) on their [Node.js on Windows page](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fwindows\u002Fdev-environment\u002Fjavascript\u002Fnodejs-on-windows#install-nvm-windows-nodejs-and-npm).\n\n```ps1\nnvm install 20\nnvm use 20\n```\n\n### Yarn\n\nThis project uses `yarn` as its package manager. If you do not already have a `yarn` binary available on your PATH, run:\n\n```bash\n# corepack is a set of utilities included with all recent distributions of node\ncorepack enable\nyarn set version 4.5.0 # Look at the packageManager key in package.json for the exact version.\n```\n\nThis will install a usable `yarn` binary. Then, in the root directory of this repo (ie adjacent to the top-level package.json file), run:\n\n```bash\nyarn install\n```\n\n## ComfyUI Assets\n\nBefore you can start the electron application, you need to download the ComfyUI source code and other things that are usually bundled with the application.\n\n### ComfyUI and other dependencies\n\nFirst, initialize the application resources by running `yarn make:assets`:\n\nThis command will install ComfyUI under `assets\u002F`. If the bundled ComfyUI version contains `manager_requirements.txt`, ComfyUI-Manager will be installed via pip at runtime; otherwise the legacy custom node is cloned for compatibility. The exact versions of each package is defined in `package.json`.\n\nYou can then run `start` to build and launch the app. A watcher will also be started; it will automatically rebuild the app when a source file is changed:\n\n```bash\ndeactivate # Deactivate your existing python env to avoid influencing the\nyarn start\n```\n\nYou can also build the package and\u002For distributables using the `make` command:\n\n```bash\n# build the platform-dependent package and any distributables\nyarn make\n# build cross-platform, e.g. windows from linux\nyarn make --windows\n```\n\n### Compiled Requirements\n\nThe source of truth for how compiled requirements are produced is in the header comments of the `.compiled` files. See `assets\u002Frequirements\u002F*.compiled` for the exact commands and overrides in use.\n\n### Troubleshooting\n\nIf you get an error similar to:\n\n```\nThe module '\u002Felectron\u002Fnode_modules\u002Fnode-pty\u002Fbuild\u002FRelease\u002Fpty.node' was compiled against a different Node.js version using NODE_MODULE_VERSION 115. This version of Node.js requires NODE_MODULE_VERSION 125. Please try re-compiling or re-installing the module (for instance, using `npm rebuild` or `npm install`).\n```\n\nYou will need to rebuild the node-pty using [electron-rebuild](https:\u002F\u002Fwww.electronjs.org\u002Fdocs\u002Flatest\u002Ftutorial\u002Fusing-native-node-modules), for example:\n\n```\nnpx electron-rebuild\n```\n\nor if that fails\n\n```\nyarn add -D @electron\u002Frebuild\nrm -rf node_modules\nrm yarn.lock\nyarn install\nnpx electron-rebuild\n```\n\n#### Missing libraries\n\nYou may get errors reporting that the build is unable to find e.g. `libnss3.so` if `electron` prerequisites are not included in your distro. Find the correct package for your distro and install.\n\n`apt` example:\n\n```\napt-get install libnss3\n```\n\n### Debugger\n\nThere are helpful debug launch scripts for VSCode \u002F Cursor under `.vscode\u002Flaunch.json`. The default launch script runs the Electron launcher in the project root and attaches the debugger. By default, the app is not built when this is used.\n\nThe default launch script can be run by pressing `F5` in VSCode or VSCode derivative. `Ctrl + Shift + F5` restarts the app with the debugger attached. `Shift + F5` terminates the debugger and the process tree it is attached to.\n\nTo keep the app built and up to date as you make changes, run the `Start Vite Build Watchers` build task defined in `.vscode\u002Ftasks.json`. This spawns two watcher tasks - one for the main app, and one for the preload script. These watchers will automatically rebuild the app when a source file is changed.\n\nThe launch environment can be customised, e.g. add a `\"linux\"` section to source your `~\u002F.profile` (and other interactive config) when debugging in linux:\n\n```json\n{\n  \"version\": \"2.0.0\",\n  \"tasks\": [\n    {\n      \"linux\": { \"options\": { \"shell\": { \"args\": [\"-ci\"] } } }\n    }\n  ]\n}\n```\n\n### Troubleshooting the packaged app\n\nWhen the app has been packaged for use as a production app, it ignores environment variables used to configure development settings. To force the app to read env vars when packaged, use the `--dev-mode` command line argument to launch the app.\n\n# Release\n\nWe use Todesktop to build and codesign our distributables. To make a new release:\n\n1. Create a PR that updates package.json to the next version.\n1. Create a Github Release with semantic version tag eg. \"v1.0.0\"\n1. Make sure it is a pre-release.\n1. Check the Github action \"Publish All\" runs. It should update the release body with Download links when it is finished.\n1. Test the build, and if it looks good release it on ToDesktop. Also mark the release as \"Latest\".\n\nIf a build fails for some reason, you can manually retry by running the \"Publish All\" GH action with a release tag as input.\n\n## Release using Claude Code\n\nThere is a Claude Code command, \"bump-stable\", that can be used to automate the release process.\n\n## Updating uv compiled requirements\n\nApplying the \"Update Compiled Requirements\" label to an open PR will automatically update compiled requirements. If changes are made, the action commits the updated files to the PR.\n\n## Utility scripts\n\nA number of utility scripts are defined under the \"scripts\" field of package.json. For example, to clean up the build artifacts you can run:\n\n```bash\nyarn clean\n\n# Remove files created by yarn make:assets\nyarn clean:assets\n\n# clean:slate also removes node_modules\nyarn clean:slate\n```\n\n## Crash Reports & Metrics\n\nAt the onboarding step, you can opt-in to send us usage metrics. This really helps us prioritize issues and focus our limited engineering time. Read our privacy policy [here](https:\u002F\u002Fcomfy.org\u002Fprivacy).\n\nYou can opt-out at anytime from the settings menu and nothing will ever be sent.\n\nIn either case, no personal data, workflows or logs will be sent.\n","ComfyUI Desktop 是一款为 ComfyUI 设计的桌面应用程序，支持 Windows 和 macOS 系统。该应用集成了稳定的 ComfyUI 版本、前端界面、管理器及 uv 工具，并在启动时自动安装所有必要的 Python 依赖项，从而简化了用户的设置过程。其核心功能包括自动更新机制和对特定桌面功能的支持。适用于需要便捷地访问和使用 ComfyUI 进行人工智能相关开发或实验的用户，无论是初学者还是经验丰富的开发者都能从中受益。",2,"2026-06-11 03:47:51","high_star"]