comfyEz README

The project's README from github.com/amirrezasalimi/comfyEz. As one markdown file: README.md.

ComfyEz

ComfyEz is a modern, feature-rich web interface designed to interact with a local ComfyUI instance.

It abstracts the complex node-based graph into a sleek, professional "Playground" UI (similar to commercial AI generators) while retaining the flexibility of ComfyUI through a powerful Workflow & Node Mapping system. It also integrates LLM capabilities for prompt engineering and complex inpainting tools.

ComfyEz

✨ Key Features

🎨 Core Generation

🧠 Workflow System

🤖 AI-Powered Prompting (LLM Integration)

Integrates with OpenAI-compatible APIs (OpenRouter, OpenAI, local LLMs) to supercharge creativity:

🖌️ Advanced Inpainting

A dedicated, fully-featured inpainting editor:

⚡ Smart Queue & History

💾 Persistence


🛠️ Technology Stack


🚀 Getting Started

Prerequisites

  1. ComfyUI: You must have ComfyUI running locally.
    • Default address: http://127.0.0.1:8188
    • CORS Note: You may need to run ComfyUI with --enable-cors-header * if accessing from a different origin.
  2. Bun: You'll need Bun installed.
    • macOS & Linux:
      curl -fsSL https://bun.com/install | bash
      
    • Windows:
      powershell -c "irm bun.sh/install.ps1|iex"
      

Installation

  1. Clone the repository:

    git clone https://github.com/amirrezasalimi/comfyEz.git
    cd comfyEz
    
  2. Install dependencies:

    bun install
    
  3. Start the development server:

    bun dev
    

⚙️ Configuration

connecting to ComfyUI

  1. Click the Settings (Gear) icon in the sidebar.
  2. Set Host URL to your ComfyUI instance (e.g., http://127.0.0.1:8188).

Setting up LLM Features

  1. In Settings, enable LLM Config.
  2. API Host: Defaults to https://openrouter.ai/api/v1 (or use https://api.openai.com/v1).
  3. API Key: Enter your key (stored locally in browser).
  4. Model: Click "Fetch List" to grab available models or type one manually (e.g., google/gemini-2.0-flash, gpt-4o).

🧩 How Workflow Mapping Works

This app allows you to use any ComfyUI workflow by "mapping" generic UI controls to specific Node IDs.

  1. Open the Workflow Editor (Fork icon in sidebar).
  2. Import a ComfyUI JSON file (Save as API Format from ComfyUI).
  3. The JSON Editor on the right shows the raw graph.
  4. The Mapping Column on the right allows you to select which node corresponds to:
    • Prompt Node: Where the positive text goes.
    • Model Node: Where the checkpoint is loaded.
    • Seed/Steps/CFG: Usually the KSampler node.
    • Preview Node: The final image output node.
  5. Save the preset. The UI will now control that specific workflow.

⌨️ Shortcuts & Tips

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.


🙏 Thanks

Made In AI Studio with Gemini 3

📄 License

MIT

comfyEz (amirrezasalimi/comfyEz)

Searching Database…

Что это такое?Веб-интерфейс для локального экземпляра ComfyUI: он оборачивает граф узлов в аккуратный UI в стиле Playground, как у коммерческих AI-генераторов, добавляя инструменты для промптов на основе LLM и отдельный редактор для inpainting.
Так мне нужно ставить десктопное приложение, или как это работает вместе с ComfyUI?Это самостоятельное веб-приложение на React, которое вы запускаете сами и открываете в браузере. Бэкенда нет — оно общается с вашим локальным ComfyUI напрямую через его API, и все данные остаются в браузере.
Как его запустить?Установите Bun, клонируйте репозиторий, выполните bun install, затем запустите dev-сервер. В приложении откройте Settings (иконка с шестерёнкой) и укажите Host URL вашего экземпляра ComfyUI.
Что нужно установить заранее, чтобы всё заработало?Локально запущенный ComfyUI (по его стандартному адресу) и Bun. Если вы раздаёте UI с другого origin, запустите ComfyUI с флагом --enable-cors-header, иначе браузер заблокирует запросы.
Получится ли использовать мои готовые воркфлоу из ComfyUI?Да — импортируйте любой JSON воркфлоу, сохранённый в формате API ComfyUI, и привяжите элементы управления UI (промпт, чекпоинт, seed/steps/CFG у KSampler, превью) к ID узлов, не трогая код. SDXL, SD1.5, Flux и свои воркфлоу работают после привязки.
Куда попадают мои сгенерированные картинки и API-ключи?Никуда наружу: картинки, история и состояние очереди хранятся в IndexedDB вашего браузера, а настройки, выбранные воркфлоу и API-ключи — в localStorage. Никакая внешняя база данных не используется.
Очередь генерации сохранится, если обновить страницу?Да — очередь хранится в IndexedDB и переживает перезагрузку, а после обновления приложение автоматически возобновляет проверку статуса незавершённых задач. Элементы очереди также можно переставлять, удалять или очистить целиком.
Можно ли воссоздать понравившуюся картинку из истории?Да, через Remix: клик по любому элементу истории мгновенно восстанавливает все параметры, воркфлоу и seed, использованные при генерации, — полные метаданные сохраняются для каждой картинки.
Поддерживается ли наложение нескольких LoRA сразу?Да — LoRA подгружаются динамически и могут складываться; бэкенд автоматически последовательно соединяет их узлы Model и CLIP в воркфлоу.
А увеличить разрешение результата можно?Да, апскейл включается переключателем, доступны методы вроде Lanczos и Bicubic и свои коэффициенты масштабирования.
Size
0.9 MB
Stars
77
Updated
CommitDec 10
Age
10mo
Commits · 90 Days