ComfyUI-to-Python-Extension

把 ComfyUI 工作流一键转成 Python 代码,直接部署上线

ComfyUI-to-Python-Extension 是一个将 ComfyUI 工作流自动转换为可执行 Python 代码的扩展工具。它解决了 ComfyUI 用户从可视化节点编辑到实际部署之间存在的鸿沟:手动重写工作流为代码既繁琐又易错。该工具能解析 ComfyUI 的 JSON 工作流文件,生成结构清晰、可直接运行的 Python 脚本,并自动处理节点依赖、模型加载和推理流程。核心能力包括:支持自定义节点、提供命令行界面和 API 接口、生成代码包含完整注释、可无缝集成到现有 Python 项目中。它让创作者无需深入编程细节即可将工作流产品化,也方便开发者快速将原型转化为生产级代码。

开源 free 图像生成
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2383
维护状态 低维护
是否开源 是
定价模式 free

项目数据

分类图像生成
开发团队pydn
所属国家
官网地址
定价模式free
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-art,comfyui,generative-art,image-generation,pytorch,stable-diffusion
GitHub 星标★ 2383
30天Star增速
HF 下载量
上线时间2023-07-30 00:00:00
最近更新2026-09-22 00:00:00
维护状态低维护
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 5 步

环境要求

  • Python 3.12 或更高版本
  • 已安装并可正常运行 ComfyUI
  • 对 ComfyUI/custom_nodes 目录有读写权限
  • 与启动 ComfyUI 相同的 Python 环境

安装与启动步骤

  1. 1克隆到 custom_nodes

    方案A:直接克隆进 ComfyUI 的 custom_nodes 目录,ComfyUI 才能把它识别为扩展。

    cd /your/path/to/ComfyUI/custom_nodes
    git clone https://github.com/pydn/ComfyUI-to-Python-Extension.git
  2. 2或用软链接接入

    方案B:仓库可放在别处,克隆后用软链接把它挂进 ComfyUI/custom_nodes。

    git clone https://github.com/pydn/ComfyUI-to-Python-Extension.git
    cd /your/path/to/ComfyUI/custom_nodes
    ln -s /your/path/to/ComfyUI-to-Python-Extension ComfyUI-to-Python-Extension
  3. 3安装依赖到运行环境

    把扩展依赖装进启动 ComfyUI 的那个 Python 环境;pyproject.toml 只声明依赖,并不会自动安装。

  4. 4在界面导出脚本

    重启 ComfyUI 后,在菜单选择 File -> Save As Script,即可把当前工作流导出为 Python 脚本。

  5. 5用 CLI 批量转换

    另一种用法是通过命令行把已保存的 API 格式工作流转成可执行 Python 脚本,便于自动化。

关键配置

配置项必填说明示例
extra_model_paths.yaml否当仓库未放在 custom_nodes 内时,通过它把仓库父目录加入 ComfyUI 的 custom_nodes 搜索路径。extra_model_paths.yaml

如何确认成功

重启 ComfyUI 后菜单中出现 File -> Save As Script,并能成功导出 Python 脚本。

常见问题

Q:支持哪个 Python 版本?

A:README 明确说明本项目支持 Python 3.12 及更高版本,低于该版本可能无法使用。

Q:ComfyUI 没识别到扩展怎么办?

A:检查仓库是否位于 ComfyUI 的 custom_nodes 搜索路径中:可直接克隆进 ComfyUI/custom_nodes,或用软链接、extra_model_paths.yaml 添加路径。

Q:依赖装在哪个环境?

A:必须装进启动 ComfyUI 的同一个 Python 环境,否则界面里看不到该扩展;pyproject.toml 只声明依赖,不会自动安装。

Q:CLI 和界面导出有什么区别?

A:界面导出是通过 File -> Save As Script 直接生成脚本;CLI 用于转换已保存的 API 格式工作流,适合批量处理。

注意事项

  • README 未给出具体的依赖安装命令,请按自己的 ComfyUI 运行环境安装 pyproject.toml 中声明的依赖。
  • 仓库也可放在 custom_nodes 之外,但必须通过软链接或 extra_model_paths.yaml 让 ComfyUI 能搜索到。
  • 安装后需重启 ComfyUI 才能在菜单中看到 Save As Script。

核心亮点

  • 自动生成完整可运行的 Python 脚本,省去手动重写工作流的繁琐
  • 支持自定义节点,能适配多数 ComfyUI 生态扩展
  • 提供 CLI 和 API 接口,方便集成到自动化流程或 CI/CD 中

不足之处

  • 对复杂工作流(如嵌套循环、动态输入)的转换支持有限
  • 文档和社区资源相对较少,遇到问题排查依赖官方示例

适用场景

  • 将 ComfyUI 原型工作流快速转化为生产级 Python 服务
  • 在无图形界面的服务器上批量运行稳定的图像生成任务
  • 将 ComfyUI 工作流集成到现有的 Python 应用或自动化管道中

替代项目

ComfyUI-SaveImageWithMetaData、ComfyUI-Custom-Scripts、ComfyUI-to-API

项目介绍

ComfyUI-to-Python-Extension 是开发框架领域的开源项目,由 pydn 开发,2023 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,383)位列前 30%,在开发框架分类中处于中上游。

项目已超过三个月没有代码更新,维护节奏明显放缓,最近一次代码更新于 2026-09-22。MIT许可证,完全免费,无付费版本。

它主要面向的使用场景是:将ComfyUI原型工作流快速转化为生产级Python服务。同类可对比的替代方案包括 ComfyUI-SaveImageWithMetaData、ComfyUI-Custom-Scripts、ComfyUI-to-API。

上一篇:perchance

下一篇:comfyui-client

同类项目推荐

langchain 开源

组装 AI 应用的乐高积木,从想法到上线不换工具

The agent engineering platform.

★ 146874 2026-08-09
transformers 开源

全球最大的模型仓库全家桶,想用的模型一把抓

Transformers: the model-definition framework for state-of-the-art machine learning m···

★ 166529 2026-08-09
pi 开源

一套 TypeScript 工具包,快速搭出能写代码的 AI agent

AI agent toolkit: unified LLM API, agent loop, TUI, coding agent CLI

★ 108504 2026-09-12