Skip to content

Repository files navigation

Draekz ComfyUI Client Wrapper

NOTE: I have no connection to the ComfyUI team, nor collaborate with them on what I'm doing. This is purely an add-on tool I use as a quality of life thing and share it with others.

This project aims to provide a really simple way to install a ComfyUI client application on Windows or Linux and have it let you manage multiple tabs without having to mix things up with the local browser, or with cumbersome systems like web application installs on various browsers.

Windows Taskbar:

Screenshot 2025-09-08 175718

Client Window:

Screenshot 2025-09-08 175543

The project uses .NET 8.0 and Avalonia UI to render the same single binary on Windows and Linux. The embedded web view uses WebViewControl-Avalonia, which bundles its own Chromium via CEF — so the wrapper works on any modern Linux distro without depending on the system's webkit2gtk version.

Distribution:

  • Windows — single self-contained .exe packaged into an MSI via WiX Toolset 6.0.1.
  • Linux — native .rpm (Fedora) and .deb (Debian / Ubuntu) packages built with make rpm / make deb. See Building Linux packages below.

The project was originally written using Gemini 2.5 Pro for Windows/WPF, then ported to cross-platform Avalonia, and is meant to be used by the Draekz ComfyUI Installer which allows easy installation of ComfyUI, the Server Manager, the Client Wrapper, a ton of nodes, models and options right from first install.

Building Linux packages

The repo follows the same make-based packaging pattern used by gnome-youtube, gnome-youtube-music, and friends.

make publish        # dotnet publish -c Release -r linux-x64 (self-contained)
make rpm            # → dist/comfyui-client-wrapper-<ver>-1.fc<n>.x86_64.rpm
make deb            # → dist/comfyui-client-wrapper_<ver>-1_amd64.deb
make pkg            # both
make install        # sudo dnf install dist/...rpm
make install-deb    # sudo apt install dist/...deb
make uninstall      # sudo dnf remove
make uninstall-deb  # sudo apt remove

make bump-patch     # 1.0.0 → 1.0.1   (also appends a changelog entry to the .spec)
make bump-minor     # 1.0.0 → 1.1.0
make bump-major     # 1.0.0 → 2.0.0

make clean          # wipe dist/ and the linux-x64 publish output

Both packages install the bundle into /opt/comfyui-client-wrapper/ (single-file binary + CefGlueBrowserProcess/), put a comfyui-client-wrapper symlink in /usr/bin, and register a .desktop entry plus hicolor icons at sizes 32/48/64/128/256/512 (rendered from the .ico via ImageMagick at build time). Each output is tagged with the version from the VERSION file at the repo root.

Build-host dependencies: dotnet-sdk-8.0, make, ImageMagick (magick), and either rpm-build (for .rpm) or dpkg + fakeroot (for .deb). Both can be built from any Linux host regardless of which distro you ultimately install on.

https://github.com/Draek2077/comfyui-ultimate-installer

If you are interested in ComfyUI, please visit:

https://github.com/comfyanonymous/ComfyUI

Support This Project

If you find this project helpful, consider supporting me with a coffee!

Buy Me A Coffee

About

A ComfUI client wrapper that allows managing multiple client browser tabs in a nicely integrated fashion with simple themed user interface.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages