---
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