W
AI-Wiki
← 开源项目

jtydhr88/ComfyArt

已整理
https://github.com/jtydhr88/comfyart

ComfyArt 帮助用户在自己的 ComfyUI 环境中完成海报、图片、视频、音频和 3D 等 AI 创作,不需要账号、点数或云端服务也能使用。它适合希望在本地管理素材、编辑设计并调用多种 AI 工作流的设计师、内容创作者和 ComfyUI 用户。

项目简介

ComfyArt 帮助用户在自己的 ComfyUI 环境中完成海报、图片、视频、音频和 3D 等 AI 创作,不需要账号、点数或云端服务也能使用。它适合希望在本地管理素材、编辑设计并调用多种 AI 工作流的设计师、内容创作者和 ComfyUI 用户。

官方仓库资料

主要语言
TypeScript
许可证
MIT
默认分支
main
Stars
515
Forks
89
Open Issues
0
仓库状态
正常运行
派生仓库
非 Fork
数据采样
2026/11/12 14:30:43
资料抓取
2026/11/12 14:30:43
首次收录
2026/11/12 14:30:43

Topics:仓库未提供

AI 整理 · 基于已抓取的官方资料

核心功能

  • 无限设计画布:支持页面、画板、图层面板、评论、快照历史,以及导出 PNG、JPG、PDF、可编辑 PPTX。
  • 文本与矢量编辑:支持富文本、字体选择、填充样式、混合模式、钢笔工具、节点编辑和布尔运算。
  • 图像生成与编辑:支持多种本地图像模型、参考图、结构模式、调色板、基础图,以及快速编辑、放大、去背景、擦除、裁剪、翻转旋转、调整、局部重绘、扩图、分层、文字编辑、风格迁移和矢量化。
  • 视频生成与编辑:支持文本生成视频、首尾帧生成、参考图生成、故事板生成、视频延展、运动控制、唇同步和多片段时间线导出。
  • Edit Elements:可将平面海报转换为可编辑画板,识别文字层、抠出产品和标志、清理背景,并在编辑后重新渲染。
  • Mockups:可将设计贴到产品照片上,实时跟随褶皱和阴影,并支持烘焙或通过 AI 融合。
  • 音频与 3D:支持音乐、配音、语音克隆、音效卡片,以及从图像生成带纹理的 3D 模型。
  • 素材与品牌管理:包含 My Assets、品牌套件编辑器、角色、产品和参考板。
  • 设计 Agent:可通过 MCP 使用画布、生成、编辑、视频、音频、3D、Mockup、文字、形状、页面和记忆等工具。
  • 运行位置选择:可在本机、Comfy Cloud 或局域网其他 ComfyUI 实例上运行生成任务。

适用场景

  • 从一句话开始创建设计项目或生成视觉内容。
  • 制作社交媒体海报、品牌物料、产品展示图和可编辑幻灯片。
  • 对已有图片进行去背景、扩图、重绘、分层、文字编辑和风格迁移。
  • 将平面海报还原为可编辑画板并继续修改。
  • 把设计贴到产品照片上制作 Mockup 效果。
  • 生成短视频、故事板视频、参考图视频或带音频的视频内容。
  • 生成音乐、配音、语音克隆和音效素材。
  • 从图像生成 3D 模型。
  • 让设计 Agent 在画布上执行生成、编辑和排版任务。
  • 通过局域网多台 ComfyUI 机器分担生成任务,或在没有本地 GPU 时使用 Comfy Cloud。

使用方式

  • 将仓库克隆到 ComfyUI 的 custom_nodes 目录:git clone https://github.com/jtydhr88/ComfyArt。
  • 在 ComfyUI 的 Python 环境中运行:pip install -r requirements.txt。
  • 重启 ComfyUI 或 Comfy Desktop。
  • 点击 ComfyUI 顶部栏中的 ComfyArt,或打开 http://127.0.0.1:8188/comfyart/。
  • 如果没有本地 GPU,可在启动 ComfyUI 前设置 COMFY_API_KEY,并在设置中选择 Generate on → Comfy Cloud。
  • 如需使用局域网机器运行任务,可让其他 ComfyUI 实例以 --listen 启动,并在 Settings → LAN instances 中添加名称、地址和端口。
  • 如需启用 Agent,在 Agent Settings 中打开 MCP 和 Agent,并按所选 Agent 配置对应命令行工具或 OpenAI 兼容接口。
  • 如需从其他 MCP 客户端使用项目,可启用 MCP 后添加 http://127.0.0.1:8188/comfyart/mcp?project=<project-id>。

技术特点

  • 项目语言为 TypeScript,并作为 ComfyUI 自定义节点使用。
  • 构建后的页面已提交在 dist/ 中,普通安装不需要重新构建。
  • 修改 src/ 后可使用 npm install && npm run build 重新构建。
  • 开发模式可使用 npm run dev 启动 Vite,并将 /api 代理到 http://127.0.0.1:8188;可用 COMFY_URL 覆盖目标地址。
  • 项目、快照历史和 Agent 聊天保存到 SQLite 数据库 user/__comfyart/data.db。
  • 旧版本中位于 comfyart/projects/ 的 JSON 项目会在首次打开 ComfyArt 时自动导入,原文件会保留。
  • 每个画布动作会通过 ComfyUI 的 /prompt 运行 workflows/ 中的 API 工作流。
  • Comfy Cloud 模式通过 COMFY_API_KEY 将任务发送到 https://cloud.comfy.org/api/v2/jobs,结果下载到 output/comfyart/。
  • 局域网实例模式会将输入文件上传到目标机器的 input/comfyart/,结果下载到 output/comfyart/,并通过文件名匹配模型文件。
  • Agent 后端通过 /comfyart/bot/*、/comfyart/settings 和 /comfyart/mcp 提供服务,画布工具由打开的 ComfyArt 项目标签页执行。
  • 项目包含 ComfyArt Precise UNET Loader,用于以手动 cast ops 加载扩散模型,避免特定 fp8 检查点在 ComfyUI --fast fp8_matrix_mult 下产生噪声。
  • PDF 上传接口最多可将 30 页 PDF 渲染为 PNG,并返回每页文本。
  • OCR 接口使用 RapidOCR 在设备上读取图像文字行和位置框。
  • 许可证为 MIT;Agent 后端改编自 ComfyTV 的 bot。画布使用 tldraw SDK,README 说明其具有独立许可证。

限制与边界

  • 需要安装在 ComfyUI 的 custom_nodes 目录中并随 ComfyUI 运行。
  • 许多生成、编辑、音频、视频和 3D 功能需要对应模型文件或自定义节点;README 中列出了不同工作流的依赖。
  • 使用 Comfy Cloud 需要 COMFY_API_KEY,且 Cloud API key 需要付费 Comfy 计划。
  • Agent 默认关闭,需要在 Agent Settings 中开启 MCP 和 Agent。
  • 不同 Agent 需要额外条件,例如对应命令行工具在 PATH 中、已登录,或配置 OpenAI 兼容的本地 LLM 接口。
  • Agent 执行画布工具时需要保持对应 ComfyArt 项目标签页打开。
  • 局域网运行依赖其他 ComfyUI 机器在线,并且具备工作流所需节点和模型文件。
  • 某些功能会在首次使用时下载所需权重或依赖外部模型资源。
  • tldraw SDK 在 localhost 或普通 http 下以开发模式运行,README 提到会显示生产许可证提示徽标。

README

README 介绍 ComfyArt 是一个运行在用户 ComfyUI 上的开源本地 AI 设计画布,主打无需账号、无需点数、无需云端即可进行图像、视频、音频和 3D 创作。文档给出了三步安装方式、主要功能列表、Comfy Cloud 与局域网实例运行方式、Agent 和 MCP 使用方法,并详细列出各类工作流所需模型、节点、后端路由、开发命令和许可证信息。

关联 Wiki 词条

暂无已建立的词条关联。