| # Setup Runner (Mockup Frontend) — Quick Reference |
|
|
| The "mockup frontend" for testing published setups is the **Setup Runner |
| Simulator**. It is served by ComfyUI itself — you do not launch it separately. |
|
|
| ## Open it |
|
|
| Pattern — **always** the running Comfy address + a fixed path: |
|
|
| ``` |
| <your-comfy-address>/koolook/setup_runner_simulator.html |
| ``` |
|
|
| So whatever URL ComfyUI prints in its console on startup, e.g. |
|
|
| ``` |
| To see the GUI go to: http://127.0.0.1:8000 |
| ``` |
|
|
| just tack on `/koolook/setup_runner_simulator.html`: |
|
|
| ``` |
| http://127.0.0.1:8000/koolook/setup_runner_simulator.html |
| ``` |
|
|
| Open it in a browser **on the same PC as ComfyUI**. Only the port changes |
| between machines — the `/koolook/...` path is constant. Bookmark it for next |
| time. |
|
|
| ## Run a setup from the live registry (can actually Run) |
|
|
| 1. Click **Load setups** — pulls every published setup from the running Comfy |
| via the Koolook API. |
| 2. Pick one in the **Published setup** dropdown. |
| 3. Fill the app form, then click **Run setup**. |
|
|
| This path executes on the local Comfy nodes and polls to a terminal status |
| (`succeeded` / `failed` / `lost`). |
|
|
| ## Load a published-setup `.json` file (inspect-only) |
|
|
| 1. Use the **Setup file** picker and choose an exported published-setup JSON. |
| 2. The form and contract render for review — but **Run is disabled** for |
| file-loaded setups. Only the live registry can execute. |
| 3. To actually run one, publish it into the running ComfyUI registry first, |
| then use **Load setups** above. |
|
|
| ## Notes |
|
|
| - The **ComfyUI API base** field can stay empty when opened from the koolook |
| route (same origin). Only fill it if you opened the page from disk. |
| - `?demo=1` on the URL renders the UI with fake setups, no Comfy needed. |
| - A `failed` run with `video is not a valid path` (or similar) is a workflow / |
| input-path problem, not a frontend problem — the frontend reaching that error |
| means the round-trip works. |
|
|
| Source: [`../../web/setup_runner_simulator.html`](../../web/setup_runner_simulator.html), |
| route in [`../../koolook_routes.py`](../../koolook_routes.py). |
|
|
