An Electron app for managing multiple ComfyUI installations.

• ComfyUI-Standalone-Environments — Standalone environment definitions used by this app to provision Python environments for ComfyUI installations.

Run the NSIS installer (.exe) and launch from the Start Menu or desktop shortcut.

Open the .dmg, drag ComfyUI Desktop 2.0 to Applications, and launch from there.

.deb (Debian/Ubuntu):

sudo apt install ./ComfyUI-Desktop-2.0-*.deb

Then launch from your application menu.

AppImage:

chmod +x ComfyUI-Desktop-2.0-*.AppImage
./ComfyUI-Desktop-2.0-*.AppImage --no-sandbox

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

We recommend using nvm (or nvm-windows) to manage Node versions:

# Install and use Node 22
nvm install 22
nvm use 22

# Verify
node --version   # should print v22.x.x

# Enable pnpm via Corepack (bundled with Node)
corepack enable
pnpm --version

• Build tool: electron-vite
• Renderer: Vue 3 (Composition API) + TypeScript
• State: Pinia
• i18n: vue-i18n (locale files in locales/)
• Styling: Tailwind CSS v4
• Icons: Lucide
• Main process: TypeScript (src/main/)
• Linting: ESLint (flat config) + Prettier
• Testing: Vitest + Vue Test Utils

src/
  main/          # Electron main process (TypeScript)
  preload/       # Preload scripts (context bridge)
  renderer/src/  # Vue 3 renderer
    components/  # Reusable UI components
    composables/ # Vue composables (useModal, useTheme, …)
    stores/      # Pinia stores (session, installation)
    views/       # Top-level views and modal views
    types/       # Renderer-side type re-exports
  types/         # Shared IPC types (single source of truth)
locales/         # i18n translation files
sources/         # Installation source plugins

git clone https://github.com/Comfy-Org/ComfyUI-Desktop-2.0-Beta.git
cd ComfyUI-Desktop-2.0-Beta
pnpm install

Windows / macOS:

pnpm run dev

Linux:

./linux-dev.sh

pnpm run typecheck          # both main + renderer
pnpm run typecheck:node     # main process only
pnpm run typecheck:web      # renderer only

pnpm run lint           # check for lint errors
pnpm run lint:fix       # auto-fix lint errors
pnpm run format         # format with Prettier
pnpm run format:check   # check formatting without writing

pnpm test               # run all unit tests
pnpm run test:watch     # run in watch mode

# Platform-specific
pnpm run build:win      # Windows (NSIS installer)
pnpm run build:mac      # macOS (DMG)
pnpm run build:linux    # Linux (AppImage, .deb)

Build output is written to the dist/ directory.

Pushing a version tag to main triggers the ToDesktop Build & Release workflow. It runs a ToDesktop cloud build and creates a draft GitHub Release with platform download links. The workflow enforces that the tag matches the version in package.json.

1. Bump the version — create a branch, update the version field in package.json (e.g. 0.4.4 → 0.4.5), and open a PR:

   git checkout main && git pull origin main
   git checkout -b release/v0.4.5
   # Edit package.json "version": "0.4.5"
   git add package.json
   git commit -m "chore: bump version to 0.4.5"
   git push origin release/v0.4.5
   # Open a PR targeting main

2. Merge the PR — once CI passes and the PR is approved, merge it into main.

3. Tag and push — pull the merged main, create the tag, and push it to trigger the build:

   git checkout main && git pull origin main
   git tag v0.4.5
   git push origin v0.4.5

4. Publish — once the build finishes, go to the Releases page to review and publish the draft.

On Windows and macOS, all app data lives under the standard Electron userData path.

Dev vs. production path difference: Electron derives the userData directory name from the app's name. In development (pnpm run dev), it uses the name field from package.json (comfyui-desktop-2), while packaged builds use the productName from electron-builder.yml (ComfyUI Desktop 2.0). This means the two environments use separate data directories:

	Windows	macOS	Linux
Dev	%APPDATA%\comfyui-desktop-2	~/Library/Application Support/comfyui-desktop-2	~/.config/comfyui-desktop-2
Production	%APPDATA%\ComfyUI Desktop 2.0	~/Library/Application Support/ComfyUI Desktop 2.0	~/.config/ComfyUI Desktop 2.0

On Linux, the app follows the XDG Base Directory Specification:

Existing files at the old ~/.config/comfyui-desktop-2 location are automatically migrated on first launch.