MCPcopy Index your code
hub / github.com/AIGCTV/V-comfyui-launcher

github.com/AIGCTV/V-comfyui-launcher @v1.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.1.0 ↗ · + Follow
118 symbols 245 edges 27 files 22 documented · 19%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

V ComfyUI Launcher

English | 中文

License

YouTube Bilibili

A ComfyUI launcher built for creators: one-click startup, visual version management, RunningHub workflow conversion, model sharing, and Photoshop workflow support for ComfyUI portable packages.

Highlights

1. RunningHub workflow conversion

  • Convert supported RunningHub image apps into local ComfyUI-compatible workflow JSON.
  • Track cloud task status and account balance from the launcher.
  • Use generated workflows in Photoshop-oriented ComfyUI workflows.

2. Visual Git version management

  • Browse Stable and Dev branch histories from the UI.
  • Switch ComfyUI versions without typing Git commands.
  • Use a GitHub mirror/proxy option when network access is slow.

3. Portable environment management

  • Use bundled Python/Git by default.
  • Override Python or Git paths when you need a custom local environment.
  • Switch CPU/GPU launch modes from the dashboard.

4. Model sharing

  • Create model-directory symlinks for multiple ComfyUI portable packages.
  • Reduce duplicated model downloads and disk usage.

Installation

1. Git runtime

The launcher uses Git for version management and updates. Install or unpack a Windows Git runtime before running version-management features.

Suggested sources:

2. Directory layout

ComfyUI_windows_portable/
├── git/                  # Git runtime
├── ComfyUI/              # ComfyUI source directory
├── python_embedded/      # Portable Python environment
├── launcher/             # Launcher source/resources for ZIP builds
└── AIGCTV_Launcher.exe   # Single-file launcher build

3. Quick start

  1. Organize your directories as shown above.
  2. Run AIGCTV_Launcher.exe.
  3. After environment detection is complete, select GPU or CPU and start ComfyUI.

Documentation

ComfyUI V-Launcher Tutorial

See the detailed manual: V ComfyUI Launcher User Manual

The manual covers:

  1. Dashboard: basic operation and directory shortcuts.
  2. Console: logs and dependency installation.
  3. Versions: ComfyUI update and rollback.
  4. PS Plugins: Photoshop workflow integration.
  5. Settings: model sharing and advanced configuration.
  6. Themes: dark and light mode.

Build and Development

# Install dependencies
npm install

# Start development environment
npm run electron:dev

# Build source bundle
npm run build

# Build portable release
npm run electron:build:portable

Release binaries or ZIP packages should be published with the corresponding source code for the exact release tag or commit.

Modification Notice

This project contains modifications by AIGCTV.

Modified date: 2026-06-01

Major changes:

  • Added RunningHub workflow integration.
  • Added visual Git version management.
  • Added model sharing and symlink management.
  • Added Photoshop workflow support.
  • Added public-source packaging hygiene and security documentation.

Third-Party Plugin Notice

launcher-config.json links to https://github.com/AIGCTV/comfyui-photoshop-fix, which is related to the upstream NimaNzrii/comfyui-photoshop project. That plugin is not licensed by this repository. If a release bundles that plugin or a modified copy of it, confirm and follow the plugin's own license and any required author permissions first.

License

This project is licensed under the GNU General Public License v3.0 only (GPL-3.0-only).

See LICENSE for details.

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 98
Interface 18
Enum 2

Languages

TypeScript100%

Modules by API surface

components/RunningHub.tsx14 symbols
App.tsx13 symbols
services/remoteConfig.ts11 symbols
electron/main.cjs11 symbols
electron/license-service.cjs11 symbols
services/githubService.ts10 symbols
electron/update-service.cjs9 symbols
types.ts8 symbols
components/Settings.tsx7 symbols
i18n/LanguageContext.tsx5 symbols
components/Dashboard.tsx4 symbols
ThemeContext.tsx4 symbols

For agents

$ claude mcp add V-comfyui-launcher \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page