ComfyScript

用 Python 代码操控 ComfyUI，告别繁琐节点拖拽

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 46 🐛 待处理 42 👀 关注 12

GitHub ↗

GitHub 星标 ★ 706

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

ComfyScript 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类图像生成

开发团队Chaoses-Ib

GitHubhttps://github.com/Chaoses-Ib/ComfyScript

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型comfy-script,comfyui,ipython,jupyter,jupyter-notebook,stable-diffusion

GitHub 星标★ 706

上线时间2023-08-04 00:00:00

代码更新2026-07-18

仓库体积6.3 MB

本站数据更新2026-11-08

维护状态低维护

收录时间2026-08-09

浏览次数9

项目介绍

ComfyScript 是一个面向 ComfyUI 的 Python 前端和库，旨在让用户通过 Python 代码来构建和操作 ComfyUI 工作流，替代传统的图形化节点拖拽方式。它解决了 ComfyUI 在复杂工作流管理、自动化批处理和版本控制方面的痛点，使得工作流可以像代码一样被编写、调试和复用。核心能力包括：提供 Python API 直接调用 ComfyUI 的节点和管线，支持在 Jupyter Notebook 中交互式执行，以及将工作流导出为可复现的脚本。通过 ComfyScript，用户可以更高效地实验 Stable Diffusion 模型，实现精细控制、批量生成和自动化集成，特别适合需要复杂逻辑或大规模实验的研究者和开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 706

技术标签

comfyui jupyter jupyter-notebook stable-diffusion

使用教程

难度：进阶约 40 分钟部署方式：本地安装 5 步

环境要求

Python 3.9+
可运行的 ComfyUI 实例

安装与启动步骤

1安装 ComfyScript

把 ComfyUI 的工作流写成 Python 代码再转回去，先装包。
```
python -m pip install -U "comfy-script[default]"
```
2可选：自带 ComfyUI

用 uv 装一份独立的 ComfyUI，避免和自己已有的环境冲突。
```
uv pip install --torch-backend=auto comfyui
```
3导出工作流 JSON

在 ComfyUI 界面里保存 API 格式的工作流，普通格式不能用。
4转译成 Python

指定运行中的 ComfyUI 地址，转译后会生成可直接执行的脚本。
```
python -m comfy_script.transpile "workflow.json" --api http://127.0.0.1:8188/
```
5装成自定义节点

想在 ComfyUI 里直接写脚本，把仓库放进 custom_nodes 再安装。
```
git clone https://github.com/Chaoses-Ib/ComfyScript.git ./custom_nodes/ComfyScript
```