保姆级教程PythonComfyUI 本地 AI 绘图全流程你好呀我是 lbb小魔仙 感谢陪伴 小白博主在线求友 跟着小白学Linux/Java/Python 专栏汇总《Linux》专栏 | 《Java》专栏 | 《Python》专栏保姆级教程PythonComfyUI 本地 AI 绘图全流程一、前置说明必看二、环境准备第一步重中之重2.1 安装 NVIDIA 显卡驱动仅 NVIDIA 显卡用户AMD/无显卡跳过2.2 安装 Python必装2.3 安装 Git必装三、ComfyUI 本地部署第二步核心操作3.1 下载 ComfyUI 源码3.2 下载 AI 绘图模型必装否则无法生成图像3.3 启动 ComfyUI验证部署成功四、Python 脚本调用 ComfyUI API 自动绘图第三步核心功能4.1 安装 API 依赖必装4.2 完整 Python 脚本可直接复制运行步骤1创建 Python 脚本文件步骤2完整代码带详细注释步骤3修改参数新手必做步骤4运行脚本生成图像五、完整数据流流程图清晰看懂绘图原理六、常见问题排查新手必看解决90%的问题6.1 问题1启动 ComfyUI 时黑窗口闪退/报错「No module named xxx」6.2 问题2运行 Python 脚本时报错「Connection refused」6.3 问题3生成图像时报错「Model not found」模型未找到6.4 问题4生成图像速度极慢每张图需要几分钟6.5 问题5报错「CUDA out of memory」显存不足6.6 问题6生成的图像不符合预期比如提示词是猫咪生成的是狗七、总结本文面向零基础读者全程手把手讲解 PythonComfyUI 本地部署 AI 绘图的完整流程从环境准备、软件部署到用 Python 脚本调用 API 自动绘图每一步都附详细操作截图文字描述清晰可替代、完整代码及注释遇到问题可直接查看文末常见排查方案无需担心看不懂、操作失败。核心目标让零基础读者也能独立完成本地 AI 绘图掌握用 Python 脚本批量/自动生成图像的方法无需复杂编程基础跟着步骤点鼠标、复制代码即可完成。一、前置说明必看适用人群完全零基础不懂 Python、不懂编程、不懂 AI 绘图仅需掌握基础电脑操作打开文件夹、复制粘贴、运行程序。硬件要求关键优先使用独立显卡NVIDIA 显卡最佳显存建议 6GB 及以上显存越小生成图像尺寸越小、速度越慢无独立显卡也可操作但速度极慢不推荐。核心工具Python运行脚本、Git下载 ComfyUI 源码、ComfyUIAI 绘图核心工具、显卡驱动确保显卡正常工作。注意事项全程不要随意修改文件夹名称、路径避免出现中文、空格、特殊符号所有操作按步骤执行复制代码时不要漏复制符号。二、环境准备第一步重中之重环境准备是基础只要这一步做好后续部署和绘图会非常顺利全程按步骤来不要跳步2.1 安装 NVIDIA 显卡驱动仅 NVIDIA 显卡用户AMD/无显卡跳过显卡驱动是 AI 绘图提速的关键没有正确安装驱动会导致绘图速度极慢甚至无法使用显卡加速。查看自己的 NVIDIA 显卡型号右键点击桌面 → 选择「NVIDIA 控制面板」→ 左上角「系统信息」→ 查看「显示适配器」中的显卡型号如RTX 3060、RTX 4070。下载对应驱动打开浏览器搜索「NVIDIA 驱动下载」进入官方下载页面https://www.nvidia.cn/geforce/drivers/。选择参数在下载页面依次选择「产品类型GeForce」→「产品系列如 RTX 30 系列」→「产品型号如 RTX 3060」→「操作系统如 Windows 10 64 位」点击「搜索」。安装驱动下载最新版本的驱动不要选测试版下载完成后双击运行全程点击「下一步」「同意」安装完成后重启电脑必须重启否则驱动不生效。提示AMD 显卡用户无需单独安装额外驱动系统自带即可但绘图速度会比 NVIDIA 显卡慢无显卡用户直接跳过此步骤。2.2 安装 Python必装Python 是运行脚本的核心工具本文使用 Python 3.10 版本经过测试兼容性最好不会出现版本过高/过低导致的报错。下载 Python 3.10打开浏览器搜索「Python 3.10 下载」进入官方下载页面https://www.python.org/downloads/release/python-3100/。选择对应版本下拉页面找到「Files」部分Windows 用户选择「Windows Installer (64-bit)」64位系统绝大多数电脑都是64位点击下载。安装 Python双击下载好的安装包务必勾选左下角「Add Python 3.10 to PATH」这一步至关重要否则后续无法在命令行运行 Python。点击「Install Now」全程默认下一步安装完成后点击「Close」。验证是否安装成功按下「WinR」输入「cmd」按下回车打开命令提示符黑窗口。在黑窗口中输入「python --version」按下回车如果显示「Python 3.10.x」x 为具体版本号说明安装成功如果提示「不是内部或外部命令」说明未勾选「Add Python 3.10 to PATH」需重新安装并勾选该选项。2.3 安装 Git必装Git 是用于下载 ComfyUI 源码的工具没有 Git无法快速获取最新的 ComfyUI 程序。下载 Git打开浏览器搜索「Git 下载」进入官方下载页面https://git-scm.com/download/win点击「64-bit Git for Windows Setup」下载。安装 Git双击下载好的安装包全程默认下一步无需修改任何设置安装完成后点击「Finish」。验证是否安装成功打开命令提示符WinR → cmd输入「git --version」按下回车显示「git version x.x.x.windows.1」x 为版本号说明安装成功。三、ComfyUI 本地部署第二步核心操作ComfyUI 是一款轻量、灵活的 AI 绘图工具比 Stable Diffusion WebUI 更简洁适合零基础用户部署全程通过命令行操作复制代码即可。3.1 下载 ComfyUI 源码创建一个文件夹用于存放 ComfyUI 相关文件建议在「D 盘」创建一个名为「ComfyUI」的文件夹路径D:\ComfyUI避免中文、空格。打开命令提示符WinR → cmd输入以下命令切换到 D 盘D:再输入以下命令进入创建的 ComfyUI 文件夹cd ComfyUI输入以下命令下载 ComfyUI 源码复制完整命令粘贴到黑窗口按下回车等待下载完成大约需要1-5分钟取决于网络速度git clone https://github.com/comfyanonymous/ComfyUI.git下载完成后打开 D:\ComfyUI 文件夹会看到一个名为「ComfyUI」的子文件夹路径D:\ComfyUI\ComfyUI里面就是 ComfyUI 的全部源码。3.2 下载 AI 绘图模型必装否则无法生成图像AI 绘图需要依赖「模型」相当于绘图的“画笔”本文推荐新手使用「SD 1.5 基础模型」兼容性好、生成效果稳定、体积适中。下载模型打开浏览器搜索「SD 1.5 模型 download」找到可靠的下载链接推荐 Hugging Face 官网https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors点击下载文件大小约 4GB。放置模型下载完成后将模型文件v1-5-pruned-emaonly.safetensors复制到「D:\ComfyUI\ComfyUI\models\checkpoints」文件夹中直接粘贴即可无需解压。提示如果下载速度慢可以更换网络或搜索「SD 1.5 模型 百度网盘」通过网盘下载确保模型文件完整不缺失、不损坏。3.3 启动 ComfyUI验证部署成功部署完成后启动 ComfyUI确认能够正常运行为后续调用 API 做准备。打开「D:\ComfyUI\ComfyUI」文件夹找到「run_nvidia_gpu.bat」文件NVIDIA 显卡用户、「run_amd_gpu.bat」AMD 显卡用户、「run_cpu.bat」无显卡用户双击对应文件启动。启动过程双击后会弹出黑窗口自动安装依赖首次启动会比较慢大约5-10分钟不要关闭黑窗口安装完成后黑窗口会显示「Running on local URL: http://127.0.0.1:8188」。验证启动成功打开浏览器输入「http://127.0.0.1:8188」按下回车会看到 ComfyUI 的网页界面说明部署成功注意启动后黑窗口不要关闭关闭黑窗口ComfyUI 就会停止运行后续调用 API 时必须保持黑窗口处于打开状态。四、Python 脚本调用 ComfyUI API 自动绘图第三步核心功能部署好 ComfyUI 后我们可以通过 Python 脚本调用其 API实现自动绘图无需手动在网页上输入提示词、点击生成脚本一键完成。全程分为 2 步安装 API 依赖 → 编写/运行 Python 脚本。4.1 安装 API 依赖必装Python 调用 ComfyUI API 需要用到「requests」库用于发送网络请求安装方法如下打开命令提示符WinR → cmd输入以下命令安装 requests 库复制命令粘贴后回车等待安装完成pip install requests安装完成后输入「pip list」查看是否有「requests」条目有则说明安装成功。4.2 完整 Python 脚本可直接复制运行创建一个 Python 脚本文件复制以下代码所有代码都有详细注释零基础也能看懂修改少量参数如提示词、模型路径即可运行生成图像。步骤1创建 Python 脚本文件打开「D:\ComfyUI」文件夹右键点击空白处 → 新建 → 文本文档命名为「ai_drawing.py」注意将「文本文档」改为「Python 文件」如果看不到文件后缀打开文件夹 → 顶部「查看」→ 勾选「文件扩展名」。右键点击「ai_drawing.py」→ 选择「编辑」打开记事本将以下代码复制粘贴进去。步骤2完整代码带详细注释# 导入需要的库requests 用于发送 API 请求json 用于处理 JSON 数据os 用于处理文件路径importrequestsimportjsonimportos# -------------------------- 关键参数设置新手可修改以下参数其余无需动--------------------------# 1. ComfyUI API 地址默认启动后就是这个地址无需修改除非你修改了 ComfyUI 的端口COMFY_API_URLhttp://127.0.0.1:8188/prompt# 2. 模型路径对应我们之前下载的 SD 1.5 模型路径不要改除非你放错了模型位置MODEL_PATHmodels/checkpoints/v1-5-pruned-emaonly.safetensors# 3. 提示词你想生成什么样的图像用中文描述即可越详细生成效果越贴近你的预期PROMPT一只可爱的猫咪白色毛发蓝色眼睛坐在草地上阳光明媚高清画质细节拉满# 4. 反向提示词不想生成的内容比如模糊、畸形、低画质直接复制即可无需修改NEGATIVE_PROMPT模糊畸形低画质模糊不清水印文字杂乱黑暗# 5. 生成图像的参数新手可参考以下默认值也可微调IMAGE_WIDTH512# 图像宽度像素显存小的话设为 512 即可显存大的话可设为 768、1024IMAGE_HEIGHT512# 图像高度像素与宽度保持一致生成正方形图像SAMPLING_STEPS20# 采样步数越大图像细节越丰富但速度越慢推荐 20-30CFG_SCALE7.0# CFG 系数越大越贴近提示词但可能过于僵硬越小越有随机性推荐 6.0-8.0BATCH_SIZE1# 批量生成数量一次生成几张图推荐 1多了占用显存# 6. 生成图像的保存路径默认保存在 D:\ComfyUI\output 文件夹无需修改OUTPUT_DIRD:/ComfyUI/output# ----------------------------------------------------------------------------------------------# 检查输出文件夹是否存在如果不存在自动创建避免保存图像时报错ifnotos.path.exists(OUTPUT_DIR):os.makedirs(OUTPUT_DIR)# 构造 ComfyUI API 请求的数据核心部分新手无需修改# 这里的结构是 ComfyUI API 要求的固定格式修改参数会导致请求失败prompt_data{3:{class_type:CheckpointLoaderSimple,# 加载模型的组件inputs:{ckpt_name:MODEL_PATH# 模型路径对应上面设置的 MODEL_PATH}},4:{class_type:CLIPTextEncode,# 处理提示词的组件inputs:{text:PROMPT,# 正向提示词clip:[3,0]# 关联模型无需修改}},5:{class_type:CLIPTextEncode,# 处理反向提示词的组件inputs:{text:NEGATIVE_PROMPT,# 反向提示词clip:[3,0]# 关联模型无需修改}},6:{class_type:EmptyLatentImage,# 生成空白图像用于后续填充内容inputs:{width:IMAGE_WIDTH,# 图像宽度height:IMAGE_HEIGHT,# 图像高度batch_size:BATCH_SIZE# 批量生成数量}},7:{class_type:KSampler,# 采样器核心绘图组件inputs:{seed:-1,# 随机种子-1 表示每次生成不同的图像固定数值则生成相同图像steps:SAMPLING_STEPS,# 采样步数cfg:CFG_SCALE,# CFG 系数sampler_name:euler,# 采样器类型新手默认 euler 即可速度快、效果稳scheduler:normal,# 调度器默认即可denoise:1.0,# 去噪强度1.0 表示完全生成新图像小于1.0表示在原有图像基础上修改model:[3,0],# 关联模型positive:[4,0],# 关联正向提示词negative:[5,0],# 关联反向提示词latent_image:[6,0]# 关联空白图像}},8:{class_type:VAEDecode,# 解码图像将采样后的 latent 图像转为可查看的图片inputs:{samples:[7,0],# 关联采样后的图像vae:[3,1]# 关联模型中的 VAE 组件用于解码无需修改}},9:{class_type:SaveImage,# 保存图像inputs:{filename_prefix:ai_drawing,# 图像文件名前缀生成的图像会以 ai_drawing_0001.png 命名images:[8,0],# 关联解码后的图像output_path:OUTPUT_DIR# 保存路径对应上面设置的 OUTPUT_DIR}}}# 发送请求到 ComfyUI API执行绘图操作try:# 发送 POST 请求携带构造好的请求数据responserequests.post(COMFY_API_URL,jsonprompt_data)# 检查请求是否成功状态码 200 表示成功response.raise_for_status()# 解析返回的 JSON 数据resultresponse.json()# 打印成功信息print(*50)print(绘图成功)print(f图像保存路径{OUTPUT_DIR})print(f生成的图像文件名ai_drawing_0001.png如果批量生成会依次递增)print(*50)exceptExceptionase:# 如果出现错误打印错误信息方便排查问题print(*50)print(f绘图失败错误原因{str(e)})print(请查看文末常见问题排查或检查以下内容)print(1. ComfyUI 是否正常启动黑窗口是否打开是否显示 http://127.0.0.1:8188)print(2. 模型路径是否正确是否放在 models/checkpoints 文件夹中)print(3. 网络是否正常是否有防火墙拦截请求)print(*50)步骤3修改参数新手必做无需修改代码核心部分只需修改「关键参数设置」部分的 3 个内容即可PROMPT提示词改为你想生成的图像描述比如「一只可爱的小狗棕色毛发在雪地里玩耍高清治愈系」。IMAGE_WIDTH / IMAGE_HEIGHT图像尺寸如果显存较小6GB保持 512x512如果显存较大8GB及以上可改为 768x768、1024x1024。SAMPLING_STEPS采样步数新手默认 20 即可想让细节更丰富可改为 25、30速度会变慢。步骤4运行脚本生成图像确保 ComfyUI 处于启动状态黑窗口打开显示 http://127.0.0.1:8188。打开命令提示符WinR → cmd输入以下命令切换到 D:\ComfyUI 文件夹D: cd ComfyUI输入以下命令运行 Python 脚本python ai_drawing.py运行过程黑窗口会显示请求信息同时 ComfyUI 的黑窗口会显示绘图进度采样步数递增等待 10-60 秒取决于显卡性能提示「绘图成功」即可。查看图像打开「D:\ComfyUI\output」文件夹里面会有生成的图像文件ai_drawing_0001.png双击即可查看。五、完整数据流流程图清晰看懂绘图原理以下是「用户输入提示词 → Python 脚本构造请求 → ComfyUI 接收并执行 → 生成图像 → 返回结果」的完整数据流用 Mermaid 语法绘制复制到 Mermaid 在线编辑器https://mermaid-js.github.io/mermaid-live-editor/即可查看清晰流程图。渲染错误:Mermaid 渲染失败: Parse error on line 3: ...、模型路径| C[ComfyUI 服务(本地启动地址127.0.0.1:8 -----------------------^ Expecting SQE, DOUBLECIRCLEEND, PE, -), STADIUMEND, SUBROUTINEEND, PIPE, CYLINDEREND, DIAMOND_STOP, TAGEND, TRAPEND, INVTRAPEND, UNICODE_TEXT, TEXT, TAGSTART, got PS流程图说明整个过程中Python 脚本负责「发送请求」ComfyUI 负责「执行绘图」用户只需设置参数、运行脚本无需参与中间的复杂计算。六、常见问题排查新手必看解决90%的问题操作过程中遇到报错不要慌对照以下问题逐一排查大部分问题都能快速解决。6.1 问题1启动 ComfyUI 时黑窗口闪退/报错「No module named ‘xxx’」原因依赖未安装成功或 Python 版本不兼容。解决方法确保安装的是 Python 3.10 版本不是 3.11、3.9 等其他版本。重新启动 ComfyUI双击对应 bat 文件等待依赖自动安装完成不要中途关闭黑窗口。如果还是报错打开命令提示符进入 D:\ComfyUI\ComfyUI 文件夹输入「pip install -r requirements.txt」手动安装依赖。6.2 问题2运行 Python 脚本时报错「Connection refused」原因ComfyUI 未启动或启动失败导致 Python 脚本无法连接到 API。解决方法检查 ComfyUI 的黑窗口是否打开是否显示「Running on local URL: http://127.0.0.1:8188」。如果黑窗口已关闭重新双击 bat 文件启动 ComfyUI等待启动完成后再运行 Python 脚本。如果启动 ComfyUI 报错先解决 ComfyUI 的启动问题参考问题1。6.3 问题3生成图像时报错「Model not found」模型未找到原因模型文件未放置在正确路径或模型文件名错误。解决方法检查模型文件v1-5-pruned-emaonly.safetensors是否放在「D:\ComfyUI\ComfyUI\models\checkpoints」文件夹中。检查模型文件名是否正确不要修改文件名比如不要加后缀、不要重命名。如果模型文件损坏重新下载模型确保文件大小约 4GB。6.4 问题4生成图像速度极慢每张图需要几分钟原因未使用显卡加速或显卡显存不足被迫使用 CPU 绘图。解决方法NVIDIA 显卡用户检查显卡驱动是否安装成功参考第二步 2.1确保启动的是「run_nvidia_gpu.bat」。降低图像尺寸改为 512x512减少采样步数改为 20降低批量生成数量改为 1。无显卡用户只能接受速度慢或升级显卡。6.5 问题5报错「CUDA out of memory」显存不足原因图像尺寸过大、批量生成数量过多导致显卡显存不够用。解决方法降低图像尺寸比如从 768x768 改为 512x512。将批量生成数量BATCH_SIZE改为 1。关闭其他占用显存的程序如游戏、视频编辑软件释放显存。6.6 问题6生成的图像不符合预期比如提示词是猫咪生成的是狗原因提示词不够详细或 CFG 系数过低导致随机性过大。解决方法优化提示词增加细节比如「一只白色的英短猫咪蓝色眼睛坐在绿色草地上阳光照射高清4K细节拉满毛发清晰」。提高 CFG 系数改为 7.0-8.0让生成的图像更贴近提示词。修改随机种子将 seed 从 -1 改为固定数值比如 12345生成相同风格的图像方便微调。七、总结本文全程手把手讲解了 PythonComfyUI 本地 AI 绘图的完整流程从环境准备、ComfyUI 部署到 Python 脚本调用 API每一步都有详细说明零基础读者只需跟着步骤操作就能成功生成 AI 图像。核心要点① 环境准备要到位Python、Git、显卡驱动② 模型要放在正确路径③ 运行脚本前必须启动 ComfyUI④ 遇到问题对照文末排查方案逐一解决。后续可以尝试修改提示词、调整参数生成不同风格的图像也可以优化 Python 脚本实现批量生成、自动保存到指定文件夹等功能慢慢探索 AI 绘图的乐趣个人领域Linux/C/java/AI个人主页有点流鼻涕 · CSDN座右铭“向光而行沐光而生。”