Comfy Desktop

Install, run, and manage ComfyUI from one app — no dependency hell.

Download · Getting Started · Contributing · Discord

Comfy Desktop is the official desktop application for ComfyUI, the node-based engine for generative AI. It installs ComfyUI into a self-contained, GPU-ready environment, lets you run multiple independent setups side by side, and keeps them updated — so you spend your time building workflows instead of fighting Python, CUDA, and pip.

Features

• 🧩 Multiple installs, side by side — run as many independent ComfyUI setups as you like, each with its own version, models, and custom nodes. Switch between them without conflicts.
• 📦 Isolated, GPU-ready environments — each install ships a relocatable Python with PyTorch and GPU wheels prebuilt. No pip/uv failures, no CUDA roulette at install time.
• 🔄 One-click updates — update ComfyUI (and custom nodes) to the latest version in place. No terminal, no git, no re-downloading the multi-gigabyte environment.
• 📸 Snapshots & rollback — back up an install and restore it if an update or a custom node breaks something.
• 📥 Bring your existing setup — adopt and migrate existing ComfyUI installations (portable, git, or a previous desktop install) in place.
• 🖥️ Cross-platform — Windows, macOS, and Linux.
• ⬆️ Built-in auto-updates — the app keeps itself current.
• 🛠️ Works without system Git — bundles a tiny Python + pygit2 bootstrap so clones work on a clean machine.

Download

New to ComfyUI? Just download, install, and open the app — it walks you through creating your first setup. No terminal required.

Requirements: Windows, macOS (Apple Silicon), or Linux. A dedicated GPU (NVIDIA / AMD) or Apple Silicon is recommended for good performance, but not required.

sudo apt install ./*.deb

chmod +x ./*.AppImage
./*.AppImage --no-sandbox

Getting Started

1. Download and install Comfy Desktop for your OS (above).
2. Launch the app.
3. Create a new install — pick a standalone, GPU-ready environment and Comfy Desktop downloads and provisions it for you. (Already have a ComfyUI install? Import it instead.)
4. Hit launch — the app starts ComfyUI and opens it, ready to build.

From there you can add more installs, take snapshots before risky changes, and update ComfyUI or its custom nodes per install.

Development

Contributions are welcome. The app is an Electron + Vue 3 + TypeScript project built with electron-vite.

Prerequisites

• Node.js v22 LTS or later
• pnpm v10 or later (via Corepack)

nvm install 22 && nvm use 22   # recommended — https://github.com/nvm-sh/nvm
corepack enable                # enables pnpm (bundled with Node)

Setup

git clone https://github.com/Comfy-Org/Comfy-Desktop.git
cd Comfy-Desktop
pnpm run init

pnpm run init is the one-shot for a fresh clone: it runs pnpm install (with the postinstall + husky hooks) and pnpm run bootstrap to build the bundled bootstrap Python (see below).

Run in development

pnpm run dev               # Windows / macOS
./linux-dev.sh             # Linux

On Windows/macOS, set up a fresh clone and start the app in one command with pnpm run init:dev.

Common tasks

For the test categories, how to run each, and which one a new test belongs in, see TESTING.md.

Project structure

src/
  main/          # Electron main process (TypeScript)
    sources/     # Install-method plugins (standalone, portable, git, …)
    lib/         # Shared main-process logic + IPC
  preload/       # Context-bridge preload scripts
  renderer/src/  # Vue 3 renderer (components, composables, stores, views)
  types/         # Shared IPC types (single source of truth)
locales/         # i18n translations

Releasing

Production builds go through ToDesktop in CI — nothing is built locally. Any maintainer can cut a release; it's one workflow run plus a PR merge.

To ship a release:

1. Open the Version Bump workflow → Run workflow, and choose:
   • channel — stable for a real release (promotes to Latest), or rc for a pre-release test build.
   • bump — patch / minor / major.
2. It opens a chore: bump version to vX.Y.Z PR, authored by cloud-code-bot and labeled Release.
3. Review, approve, and merge that PR.
4. The rest is automatic — merging tags vX.Y.Z, which triggers the ToDesktop build and ships the new version to Desktop users. No manual tagging, no draft to publish.

gh workflow run version-bump.yml -f channel=stable -f bump=patch

Data & Troubleshooting

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/Comfy-Org/Comfy-Desktop/main/scripts/reset-windows.ps1 -OutFile reset-windows.ps1
powershell -ExecutionPolicy Bypass -File .\reset-windows.ps1

# macOS
curl -fsSLO https://raw.githubusercontent.com/Comfy-Org/Comfy-Desktop/main/scripts/reset-mac.sh && bash reset-mac.sh
# Linux
curl -fsSLO https://raw.githubusercontent.com/Comfy-Org/Comfy-Desktop/main/scripts/reset-linux.sh && bash reset-linux.sh

Contributing

Issues and pull requests are welcome. Before opening a PR, please run pnpm run typecheck, pnpm run lint, and pnpm test locally — see Development. For coding conventions, see AGENTS.md.

Community

• 💬 Discord — comfy.org/discord
• 🌐 Website — comfy.org
• 🐛 Issues — GitHub Issues
• 🧠 ComfyUI — github.com/Comfy-Org/ComfyUI
• 📦 Standalone Environments — ComfyUI-Standalone-Environments

License

Comfy Desktop is dual-licensed:

• GNU Affero General Public License v3.0 or later - free for use under the AGPL's terms (including the network-use source-disclosure obligation).
• Commercial license - for use in proprietary products or hosted services without AGPL obligations. Contact licensing@comfy.org.

Exception: the @comfyorg/comfyui-desktop-bridge-types package (the TypeScript interface for the hosted frontend bridge) remains licensed under the MIT License. This exception applies only to that package and does not determine the licensing obligations of other repository components or combined distributions.

© Comfy Org.