Portable ComfyUI for macOS and Linux 🔹 Pixaroma Community Edition
Dedicated to the Pixaroma team
Core Components
| 🔧 Component | 📝 Note |
|---|---|
| Git | |
| Python | |
| ComfyUI |
Nodes from Pixaroma tutorials
| 🖼️ Image | 🎬 Video | 🎵 Audio | 🧩 Utility / WF | 🤖 Models |
|---|---|---|---|---|
| Tiled Diffusion & VAE | VideoHelperSuite | MelBandRoFormer | ComfyUI Manager | QwenVL |
| Inpaint CropAndStitch | WanVideoWrapper | Qwen3-TTS | Easy-Use | GGUF |
| ControlNet Aux | WanAnimatePreprocess | KJNodes | ||
| LayerStyle | SeedVR2 VideoUpscaler | rgthree | ||
| RMBG | iTools | |||
| Easy-Sam3 | ControlAltAI Nodes | |||
| SCAIL-Pose | TeaCache |
Optional Add-ons Nodes and Tools
| 🧩 Nodes | 🛠️ Tools |
|---|---|
| Nunchaku | Easy-Models-Linker |
| SageAttention (v2.2.0) | ComfyUI-Version-Switcher |
| FlashAttention | Backup ComfyUI |
| InsightFace | Torch-Pack |
| Trellis 2.0 |
- Clone this repository:
git clone --single-branch --branch MAC-Linux https://github.com/Tavris1/ComfyUI-Easy-Install.git
- Make the script executable and run it:
cd ComfyUI-Easy-Install chmod +x ComfyUI-Easy-Install.sh ./ComfyUI-Easy-Install.sh - After installation, start ComfyUI:
cd ComfyUI-Easy-Install ./run_mac_mps.sh - After setup, you can install the following from the Add-ons folder:
- Easy-Models-Linker - Uses existing MODELS folder via extra_model_paths.yaml, no re-download needed
- Some folders like LLM and llm_gguf cannot be redirected this way
- Nunchaku - Installs Nunchaku
- SageAttention - Installs SageAttention v2.2.0
- InsightFace - Installs InsightFace (Pretrained models for non-commercial research only)
- Trellis2 - Installs Trellis 2.0
- Torch-Pack - Quick switching between:
Torch 2.7.1+cu128,Torch 2.8.0+cu128andTorch 2.9.1+cu130 - ComfyUI-Version-Switcher - Reversible rollback to a previous ComfyUI version on issues
- Backup ComfyUI - Backup, restore, and manage your ComfyUI data folders
- Easy-Models-Linker - Uses existing MODELS folder via extra_model_paths.yaml, no re-download needed
Mac M1/M2 Optimization
The run_mac_mps.sh script includes optimizations for Apple Silicon (M1/M2) Macs:
- Memory Management - Memory clearing, optimized GC, configurable MPS watermark ratios
- Performance - MPS graph mode, descriptor caching, unified memory support
- Compatibility - FP32 accumulation, force-upcast attention, Float8 disabled (unsupported on MPS)
Troubleshooting macOS
- Import Failures - Some nodes may fail due to Apple Silicon incompatibility. Check console output and remove non-essential nodes.
- Memory Issues - Adjust
PYTORCH_MPS_HIGH_WATERMARK_RATIO/PYTORCH_MPS_LOW_WATERMARK_RATIOinrun_mac_mps.sh, use smaller models, reduce batch sizes. - Performance - Use GGUF models, prefer smaller models (7B over 13B), avoid CPU-intensive nodes.
Tip
- Multiple ComfyUI installs allowed without conflicts.
- You can rename/move
ComfyUI-Easy-Installfolder after installation.
Standard Linux Installation
- Clone this repository:
git clone -b MAC-Linux --single-branch https://github.com/Tavris1/ComfyUI-Easy-Install.git
- Make the script executable and run it:
cd ComfyUI-Easy-Install chmod +x ComfyUI-Easy-Install.sh ./ComfyUI-Easy-Install.sh - After installation, start ComfyUI:
cd ComfyUI-Easy-Install ./run_nvidia_gpu.sh
Proxmox LXC Container Setup
- Clone this repository:
git clone -b MAC-Linux --single-branch https://github.com/Tavris1/ComfyUI-Easy-Install.git
- Make all scripts executable:
cd ComfyUI-Easy-Install chmod +x *.sh
- Setup Container - Install ComfyUI in the container - GPU Passthrough:
./comfyui-lxc-standalone.sh
Hardware Requirements: At least 8GB RAM · NVMe SSD recommended · GPU passthrough (optional)
Troubleshooting Linux / Proxmox
For Linux/Proxmox support, contact @VenimK on Discord
- Permission Errors:
chmod -R 755 ComfyUI-Easy-Install - Performance: Use NVMe for model storage, configure container resources, consider GPU passthrough
Note
The Proxmox setup automatically configures most settings, but you may need to adjust container resources based on your needs.
Backup ComfyUI
A small interactive utility to back up, restore, and manage your ComfyUI data folders.
- Script:
Add-Ons/backup_comfyui.sh - Version: V2.01.3 (Pixaroma Community Edition, macOS/Linux by VenimK)
- Backup location:
~/ComfyUI_Backups/ComfyUI_backup_YYYYMMDD_HHMMSS - What gets backed up:
user,input,output(always) ·models(optional)
bash Add-Ons/backup_comfyui.sh