DocumentationGetting Started

Generate Your First Image

Install HandyComfy, connect your ComfyUI server, choose the T2I workflow and its models, then generate an image from Chat.

This guide takes you through the shortest recommended path from opening HandyComfy for the first time to generating an image. It uses the included T2I workflow and does not cover other workflow import methods or advanced features.

HandyComfy controls the workflow from your phone or tablet. Your connected ComfyUI system performs the generation.

Before you begin

You need:

  • HandyComfy on an iOS or Android device.
  • A computer or server running ComfyUI.
  • The models required by the T2I workflow installed in that ComfyUI environment.
  • For this local setup, your mobile device and ComfyUI computer on the same network.

1. Install and open HandyComfy

Install HandyComfy from the App Store for iOS or Google Play for Android, then open it. On first launch, the app may show its built-in onboarding tutorial. You can follow that tutorial alongside this guide.

You do not need to configure every HandyComfy feature before creating your first image.

2. Connect to ComfyUI

In HandyComfy:

  1. Open Settings.
  2. Select Server Management.
  3. Open the ComfyUI section.
  4. Configure your ComfyUI server.
  5. Check the system status area at the bottom of the app. Continue only when the dot beside ComfyUI is green.

Settings · connection status

HandyComfy Settings showing Server Management and a green ComfyUI status indicator at the bottom
Open Server Management from Settings. The green ComfyUI indicator at the bottom confirms an active connection.

For server addresses, connection testing, local networking, or remote access, follow the detailed Connect to ComfyUI guide under Setup & Connection. Do not continue until the indicator is green.

3. Select the T2I workflow

  1. Open the Workflow tab.
  2. Open the hamburger menu on the left.
  3. In the workflow list, select T2I.

T2I is the recommended workflow for this guide because it generates an image from a text prompt.

Workflow · T2I selection

HandyComfy Workflow List with the T2I group expanded and a T2I workflow selected
Open the Workflow menu and choose the T2I workflow.

4. Choose the workflow models

With T2I selected:

  1. Open the Model tab in the workflow.
  2. Choose an available model for every required field.

Depending on the workflow, required fields may include a diffusion model, text encoder, VAE, or another model component. You do not need to understand every model type for this first run; make sure each required field has an appropriate available selection.

Workflow · Model

The HandyComfy Model tab showing diffusion-model and text-encoder selections
Select the models required by the workflow. The exact model names depend on your ComfyUI environment.

5. Enter a prompt in Chat

  1. Open the Chat tab.
  2. Enter a short text prompt. For example:

A stunning view of Paris, France

The selected T2I workflow remains responsible for the generation. You do not need to return to the ComfyUI desktop interface.

Chat · prompt input

HandyComfy Chat with the T2I workflow selected and a text prompt ready to submit
Enter a simple prompt in Chat with T2I selected.

6. Generate the image

Submit the prompt using the send control beside the Chat input.

HandyComfy sends the configured T2I workflow to your connected ComfyUI server. ComfyUI runs the workflow and returns the completed image to HandyComfy.

When the image appears in Chat, you have completed your first generation.

Chat · completed generation

HandyComfy Chat showing generated images returned after a T2I prompt
The finished images return to HandyComfy after your ComfyUI system completes the workflow.

Common problems

The ComfyUI indicator is not green

Return to Settings and verify the server address, network connection, ComfyUI --listen setting, and firewall access. Do not try to generate until the connection is active.

A required model is not available

The model must be installed in the connected ComfyUI environment before HandyComfy can select it. See Models for selection, refresh, and missing-model guidance.

Next steps