ComfyBox

ComfyBox 是 Stable Diffusion 的前端界面，无需编写任何代码即可创建自定义的图像生成界面。它在底层使用了 ComfyUI，以提供最大的功能性和可扩展性。

安装

1. 从 这里 下载最新版本，并解压到任意位置。
2. 使用 python main.py --enable-cors-header 启动 ComfyUI 后端。
3. 在解压后的文件夹中打开 run.bat 或 run.sh 脚本（需确保 Python 3 已添加到系统 PATH）。你也可以使用任意 Web 服务器来提供该文件夹的内容。

使用

我们提供了一个预配置的工作流，适用于最常见的文本到图像和图像到图像生成场景。只需点击 Load Default 加载默认工作流，然后点击 Queue Prompt 即可开始生成。

你可以通过点击 Load 并选择包含元数据的 .json 或 .png 文件，或将这些文件直接拖放到图编辑器中，将现有的 ComfyUI 工作流导入 ComfyBox。

注意事项

该项目 仍在开发中，部分功能尚未完善。如果你打算使用它，请注意其中可能存在的局限性。

此外，保存的工作流格式在经过充分测试并最终确定之前可能会发生变化，因此请做好随时丢失部分工作的准备。

功能特性

• 无代码 UI 构建器：一种创新的系统，允许你从基础组件构建自己的 Stable Diffusion 用户界面。
• 多工作流管理：你可以在应用内同时打开多个工作流，并通过标签页进行切换。还可以自定义“发送至”操作，将生成的图像输出复制到其他工作流中以进行进一步处理。
• 兼容现有工作流：将你在 ComfyUI 中创建的工作流导入 ComfyBox，系统会为你自动生成新的用户界面。
• 扩展支持：所有自定义的 ComfyUI 节点均开箱即用。
• 提示队列：无需等待前一个提示完成即可排队多个提示。可以查看当前正在排队和已执行的提示。
• 提示历史：浏览之前生成的提示及其输出图像和参数。
• 移动端友好版：包含针对移动设备优化的界面版本，同时仍支持与桌面版相同的自定义工作流。

开发

环境要求

• git
• pnpm
• 后端需要安装原生的 ComfyUI

安装步骤

注意：如果你使用的是 Windows 系统，以下命令必须在 Git Bash 中运行。

1. 克隆包含子模块的仓库：

git clone https://github.com/space-nuko/ComfyBox --recursive

2. 运行 pnpm install
3. 运行 pnpm prebuild
4. 运行 pnpm dev
5. 使用 python main.py --enable-cors-header 启动 ComfyUI
6. 打开浏览器访问 http://localhost:3000

ComfyBox 快速上手指南

ComfyBox 是一个基于 Stable Diffusion 的前端工具，允许用户无需编写代码即可创建自定义的图像生成界面。它底层调用 ComfyUI，兼具强大的功能与扩展性。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows、macOS 或 Linux。
  • 注意：若在 Windows 上进行开发部署，必须使用 Git Bash 运行命令。
• Python：已安装 Python 3 并配置到系统环境变量 (PATH) 中。
• 后端依赖：已安装原版的 ComfyUI。
• 开发工具（仅源码部署需要）：
  • git
  • pnpm (Node.js 包管理器)

安装步骤

您可以选择下载预编译版本（推荐普通用户）或从源码构建（推荐开发者）。

方式一：使用预编译版本（推荐）

1. 下载程序 访问 最新发行版页面 下载压缩包，并将其解压到任意目录。

2. 启动后端 打开终端，进入您的 ComfyUI 安装目录，运行以下命令启动后端服务：

   python main.py --enable-cors-header
   

3. 启动前端 进入刚才解压 ComfyBox 的文件夹：

   • Windows: 双击运行 run.bat。
   • macOS/Linux: 在终端运行 ./run.sh。
   • 备选方案：您也可以使用该文件夹内的文件，通过任意 Web 服务器进行托管。

方式二：源码构建（开发模式）

1. 克隆仓库

   git clone https://github.com/space-nuko/ComfyBox --recursive
   cd ComfyBox
   

2. 安装依赖

   pnpm install
   

3. 预构建与启动

   pnpm prebuild
   pnpm dev
   

4. 启动后端 确保在另一个终端窗口中启动了开启 CORS 的 ComfyUI：

   python main.py --enable-cors-header
   

5. 访问界面 在浏览器中打开 http://localhost:3000。

基本使用

安装完成后，您可以立即开始生成图像：

1. 加载默认工作流 启动界面后，点击 Load Default 按钮。系统已预配置了最常用的 "文生图" (txt2img) 和 "图生图" (img2img) 工作流。

2. 生成图像 输入提示词（Prompt），然后点击 Queue Prompt 按钮即可开始生成。

3. 导入现有工作流 如果您已有 ComfyUI 的工作流文件（.json 或包含元数据的 .png）：

   • 点击 Load 按钮选择文件；
   • 或者直接将文件拖拽到图形查看器区域。 ComfyBox 将自动为您解析并生成对应的操作界面。

4. 多任务队列 您可以连续提交多个提示词加入队列（Prompt Queue），无需等待前一个任务完成。生成的历史记录可在 Prompt History 中查看。

注意事项：本项目目前仍在建设中，部分功能可能尚未完善。保存的工作流格式在未来测试稳定前可能会发生变化，建议定期备份重要工作。