| --- |
| license: other |
| license_name: comfyui-gpl3-plus-custom-nodes |
| license_link: https://github.com/comfyanonymous/ComfyUI/blob/master/LICENSE |
| pretty_name: FlipPix ComfyUI Bundle (Linux / WSL) |
| tags: |
| - comfyui |
| - flippix |
| - text-to-image |
| - image-to-video |
| - bundle |
| viewer: false |
| --- |
| |
| # FlipPix — ready-to-run ComfyUI bundle (Linux / WSL) |
|
|
| A complete snapshot of a working [ComfyUI](https://github.com/comfyanonymous/ComfyUI) |
| install for [**FlipPix**](https://github.com/bongobongo2020/flippix): the embedded Python |
| environment (`python_embeded`) **plus every custom node already installed**. Restoring is |
| **extract-and-run** — no `pip`, no virtualenv, no hunting down ~115 custom-node packages. |
|
|
| This is the lowest-friction way to get a guaranteed-working ComfyUI for FlipPix. |
|
|
| | | | |
| |---|---| |
| | **File** | `flippix-comfyui.tar.gz` (~15 GB) | |
| | **Checksum** | `flippix-comfyui.tar.gz.sha256` | |
| | **Target** | Linux or **WSL** on Windows | |
| | **Requires** | NVIDIA GPU + recent driver (the bundle ships CUDA-built PyTorch) | |
| | **Models** | **NOT included** (add your own — see below) | |
|
|
| > Running plain **Windows without WSL**? This Linux bundle won't run natively there. |
| > A separate Windows bundle (`flippix-comfyui-windows.tar.gz`) is the native path — see the |
| > FlipPix repo. |
|
|
| --- |
|
|
| ## Quickest restore (one command) |
|
|
| On a Linux box or in **WSL**, this downloads, verifies the checksum, extracts, and prepares |
| the launcher — no need to grab anything by hand first: |
|
|
| ```bash |
| curl -fsSL https://raw.githubusercontent.com/bongobongo2020/flippix/flippix-prompt-image/scripts/restore-comfyui.sh \ |
| | bash -s -- --hf bongo2k22/flippix-comfyui |
| ``` |
|
|
| Then launch ComfyUI and point FlipPix at it: |
|
|
| ```bash |
| cd ~/flippix-comfyui/ComfyUI-Easy-Install && ./run_nvidia_gpu.sh # serves on 0.0.0.0:8188 |
| ``` |
|
|
| In FlipPix → **Settings**, set the ComfyUI Server URL to `http://127.0.0.1:8188` (or the |
| machine's IP if ComfyUI runs on another box). FlipPix users can also click |
| **Settings → Set up / Restore ComfyUI**, which runs exactly this for you. |
|
|
| --- |
|
|
| ## Manual restore |
|
|
| Prereqs: `tar`, and either the `hf` CLI or `curl`/`wget`. |
|
|
| ```bash |
| # 1. download the bundle + checksum |
| hf download bongo2k22/flippix-comfyui flippix-comfyui.tar.gz --local-dir . |
| hf download bongo2k22/flippix-comfyui flippix-comfyui.tar.gz.sha256 --local-dir . |
| # (or: curl -L -C - -o flippix-comfyui.tar.gz \ |
| # https://huggingface.co/bongo2k22/flippix-comfyui/resolve/main/flippix-comfyui.tar.gz) |
| |
| # 2. verify integrity |
| sha256sum -c flippix-comfyui.tar.gz.sha256 |
| |
| # 3. extract + finalize (rebuilds nothing for python_embeded; just fixes paths) |
| bash restore-comfyui.sh flippix-comfyui.tar.gz ~/ComfyUI |
| cd ~/ComfyUI && ./run_nvidia_gpu.sh |
| ``` |
|
|
| `restore-comfyui.sh` lives in the [FlipPix repo](https://github.com/bongobongo2020/flippix/blob/flippix-prompt-image/scripts/restore-comfyui.sh). |
| For a private/gated copy of this repo, `export HF_TOKEN=hf_xxx` before downloading. |
|
|
| --- |
|
|
| ## Models |
|
|
| Model weights are **not** bundled (they'd add hundreds of GB). After restoring, either: |
|
|
| - point `ComfyUI/models` at an existing weights folder (symlink or `extra_model_paths.yaml`), or |
| - download the FlipPix model set via the manifest |
| [`scripts/flippix-models.txt`](https://github.com/bongobongo2020/flippix/blob/flippix-prompt-image/scripts/flippix-models.txt). |
|
|
| --- |
|
|
| ## What's inside |
|
|
| - `python_embeded/` — portable Python 3.12 with all dependencies for every custom node |
| - `ComfyUI/` — ComfyUI source + `custom_nodes/` (~115 packs) + your workflows/settings |
| - `run_nvidia_gpu.sh` and the other ComfyUI-Easy-Install launchers |
| - `.flippix-backup/manifest.txt` and `custom_nodes.txt` (provenance) + `requirements-freeze.txt` |
|
|
| Excluded: model weights, `output/`, `temp/`, `__pycache__`, and machine-specific run configs. |
|
|
| ## Licensing |
|
|
| This bundle aggregates **ComfyUI** (GPL-3.0) and **many third-party custom nodes**, each under |
| its own license (see `.flippix-backup/custom_nodes.txt` for the list and source repos). It |
| contains **no model weights**. By using it you agree to the respective upstream licenses. |
|
|
| ## Links |
|
|
| - FlipPix: https://github.com/bongobongo2020/flippix |
| - ComfyUI: https://github.com/comfyanonymous/ComfyUI |
| - Setup & backup/restore docs: https://github.com/bongobongo2020/flippix/blob/flippix-prompt-image/scripts/README.md |
|
|
