Skip to content

Installation

Jump to bottom
Mooshieblob1 edited this page Jun 19, 2026 · 1 revision

Installation

MooshieUI can run as a desktop app, a self-hosted web server, or a thin client against a remote ComfyUI.

One-click setup (Windows/Linux releases)

  1. Download a release from Releases.
  2. Run the app. The setup wizard will:
    • download uv (fast Python package manager)
    • install an isolated Python 3.11 (does not touch your system Python)
    • download the latest ComfyUI from GitHub
    • create a virtual environment
    • auto-detect your GPU (NVIDIA CUDA / AMD ROCm / Intel XPU / CPU)
    • install PyTorch with the right backend (including CUDA 13.0 for Blackwell GPUs)
    • install ComfyUI dependencies and MooshieUI's custom nodes
  3. Start generating. ComfyUI launches automatically with no visible terminal windows.

The installer streams real-time output as a matrix-style backdrop with per-step progress bars and a checklist.

Disk space: roughly 5 to 10 GB (Python + PyTorch + ComfyUI). Install takes 5 to 15 minutes depending on your connection.

Self-host / server mode (Docker)

MooshieUI can run headless and serve the same web UI over your network.

# optional: configure credentials/ports
cp .env.example .env

# build and run
docker compose up -d --build

Then open http://localhost:3200 (or your configured MOOSHIEUI_PORT).

The default compose file includes a persistent data volume (mooshie-data), an optional mounted models directory (MODELS_PATH), admin bootstrap via MOOSHIEUI_ADMIN_USER / MOOSHIEUI_ADMIN_PASS, and NVIDIA GPU reservation on hosts with the NVIDIA runtime.

See Server, LAN and Multi-User for roles, auth, and LAN exposure.

Remote / cloud ComfyUI (RunPod, Vast.ai, etc.)

Use this when MooshieUI runs on your desktop but ComfyUI runs on a cloud GPU.

  1. Deploy the MooshieUI server build on the cloud instance. The Docker image ships ComfyUI, PyTorch, and all MooshieUI custom nodes pre-installed. This is the supported way to get the required nodes onto a remote server. Copying node files by hand is not supported. 
    docker compose up -d --build
# or: docker pull ghcr.io/mooshieblob1/mooshieui:latest
  2. Expose ComfyUI. Either use the web UI on port 3200, or expose ComfyUI port 8188 and use the desktop app as a thin client (RunPod proxy URLs look like https://xxxxx-8188.proxy.runpod.net).
  3. Connect from desktop. On first launch choose Remote server, paste the public ComfyUI URL, and click Validate remote server. MooshieUI skips the local install entirely. You can change the endpoint later in Settings -> Connection.

If validation reports missing custom nodes, redeploy or update the server build and fully restart ComfyUI before retrying.

macOS (source build)

Prebuilt macOS artifacts are currently disabled, so build from source.

Prerequisites: Node.js 18+, Rust (latest stable), Xcode Command Line Tools (xcode-select --install), and the Tauri v2 prerequisites.

git clone https://github.com/Mooshieblob1/MooshieUI.git
cd MooshieUI
npm install
npm run tauri dev      # development
npm run tauri build    # production

The setup wizard still installs ComfyUI/Python/PyTorch on first launch.

Development setup (all platforms)

Prerequisites: Node.js 18+, Rust (latest stable), and the Tauri v2 prerequisites.

git clone https://github.com/Mooshieblob1/MooshieUI.git
cd MooshieUI
npm install
npm run tauri dev

Getting started

Prompting

Generation features

Models and output

Deployment

Help

Clone this wiki locally