DocumentationSetup & Connection

Local Network Connection

Connect HandyComfy to a ComfyUI system reachable on the same network.

Use a local network connection when your HandyComfy phone or tablet and the computer running ComfyUI are on the same Wi-Fi or local network.

Prepare ComfyUI

Start ComfyUI with network listening enabled. For a standard Python installation, use:

python main.py --listen

Your launch command may differ depending on how ComfyUI was installed. The important requirement is that ComfyUI starts with --listen.

Add the local server in HandyComfy

  1. Connect the phone and ComfyUI computer to the same local network.

  2. Find the local IP address of the computer running ComfyUI. The steps vary by operating system.

  3. In HandyComfy, open Settings → Server Management → ComfyUI and add a server.

  4. Enter the computer’s local IP address and ComfyUI port. A typical address looks like:

    http://192.168.0.10:8188

    Replace the example IP with the address of your own ComfyUI computer.

  5. Save the server and select Test Connection.

  6. Confirm that the server is connected and the ComfyUI indicator in the bottom status bar is green.

For the full server form and connection-status steps, see Connect to ComfyUI.