[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-runpod-workers--worker-comfyui":3,"tool-runpod-workers--worker-comfyui":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":80,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":105,"forks":106,"last_commit_at":107,"license":108,"difficulty_score":10,"env_os":109,"env_gpu":110,"env_ram":111,"env_deps":112,"category_tags":119,"github_topics":120,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":130,"updated_at":131,"faqs":132,"releases":160},3822,"runpod-workers\u002Fworker-comfyui","worker-comfyui","ComfyUI as a serverless API on RunPod","worker-comfyui 是一个将强大的 ComfyUI 可视化工作流引擎转化为无服务器（Serverless）API 的开源项目，专为 RunPod 云平台设计。它解决了传统部署 ComfyUI 时面临的配置复杂、资源管理困难以及难以集成到现有应用后端等痛点。通过该项目，用户无需手动维护 GPU 服务器或处理繁琐的环境依赖，只需调用 API 即可提交工作流并获取生成的图像结果。\n\n该工具特别适合开发者、AI 研究人员以及希望将生成式 AI 能力嵌入自身产品的设计团队。对于需要批量处理图像或构建自动化内容生产管线的用户而言，它提供了极佳的扩展性。其核心技术亮点在于提供了多种预构建的 Docker 镜像，内置了包括 FLUX.1、Stable Diffusion XL 及 SD3 在内的主流模型环境，实现了“开箱即用”。此外，它支持同步与异步两种请求模式，输出结果既可以直接返回 Base64 编码字符串，也能配置为自动上传至 S3 存储桶，灵活适应不同的业务架构需求。这让专注于算法逻辑或应用开发的用户，能够从基础设施运维中解放出来，高效地利用云端算力进行创意生产。","# worker-comfyui\n\n> [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI) as a serverless API on [RunPod](https:\u002F\u002Fwww.runpod.io\u002F)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Frunpod-workers_worker-comfyui_readme_9cc4657f9fab.jpg\" title=\"Worker sitting in comfy chair\" \u002F>\n\u003C\u002Fp>\n\n[![RunPod](https:\u002F\u002Fapi.runpod.io\u002Fbadge\u002Frunpod-workers\u002Fworker-comfyui)](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fhub\u002Frunpod-workers\u002Fworker-comfyui)\n\n---\n\nThis project allows you to run ComfyUI workflows as a serverless API endpoint on the RunPod platform. Submit workflows via API calls and receive generated images as base64 strings or S3 URLs.\n\n## Table of Contents\n\n- [Quickstart](#quickstart)\n- [Available Docker Images](#available-docker-images)\n- [API Specification](#api-specification)\n- [Usage](#usage)\n- [Getting the Workflow JSON](#getting-the-workflow-json)\n- [Further Documentation](#further-documentation)\n\n---\n\n## Quickstart\n\n1.  🐳 Choose one of the [available Docker images](#available-docker-images) for your serverless endpoint (e.g., `runpod\u002Fworker-comfyui:\u003Cversion>-sd3`).\n2.  📄 Follow the [Deployment Guide](docs\u002Fdeployment.md) to set up your RunPod template and endpoint.\n3.  ⚙️ Optionally configure the worker (e.g., for S3 upload) using environment variables - see the full [Configuration Guide](docs\u002Fconfiguration.md).\n4.  🧪 Pick an example workflow from [`test_resources\u002Fworkflows\u002F`](.\u002Ftest_resources\u002Fworkflows\u002F) or [get your own](#getting-the-workflow-json).\n5.  🚀 Follow the [Usage](#usage) steps below to interact with your deployed endpoint.\n\n## Available Docker Images\n\nThese images are available on Docker Hub under `runpod\u002Fworker-comfyui`:\n\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-base`**: Clean ComfyUI install with no models.\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-flux1-schnell`**: Includes checkpoint, text encoders, and VAE for [FLUX.1 schnell](https:\u002F\u002Fhuggingface.co\u002Fblack-forest-labs\u002FFLUX.1-schnell).\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-flux1-dev`**: Includes checkpoint, text encoders, and VAE for [FLUX.1 dev](https:\u002F\u002Fhuggingface.co\u002Fblack-forest-labs\u002FFLUX.1-dev).\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-sdxl`**: Includes checkpoint and VAEs for [Stable Diffusion XL](https:\u002F\u002Fhuggingface.co\u002Fstabilityai\u002Fstable-diffusion-xl-base-1.0).\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-sd3`**: Includes checkpoint for [Stable Diffusion 3 medium](https:\u002F\u002Fhuggingface.co\u002Fstabilityai\u002Fstable-diffusion-3-medium).\n\nReplace `\u003Cversion>` with the current release tag, check the [releases page](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Freleases) for the latest version.\n\n## API Specification\n\nThe worker exposes standard RunPod serverless endpoints (`\u002Frun`, `\u002Frunsync`, `\u002Fhealth`). By default, images are returned as base64 strings. You can configure the worker to upload images to an S3 bucket instead by setting specific environment variables (see [Configuration Guide](docs\u002Fconfiguration.md)).\n\nUse the `\u002Frunsync` endpoint for synchronous requests that wait for the job to complete and return the result directly. Use the `\u002Frun` endpoint for asynchronous requests that return immediately with a job ID; you'll need to poll the `\u002Fstatus` endpoint separately to get the result.\n\n### Input\n\n```json\n{\n  \"input\": {\n    \"workflow\": {\n      \"6\": {\n        \"inputs\": {\n          \"text\": \"a ball on the table\",\n          \"clip\": [\"30\", 1]\n        },\n        \"class_type\": \"CLIPTextEncode\",\n        \"_meta\": {\n          \"title\": \"CLIP Text Encode (Positive Prompt)\"\n        }\n      }\n    },\n    \"images\": [\n      {\n        \"name\": \"input_image_1.png\",\n        \"image\": \"data:image\u002Fpng;base64,iVBOR...\"\n      }\n    ]\n  }\n}\n```\n\nThe following tables describe the fields within the `input` object:\n\n| Field Path                | Type   | Required | Description                                                                                                                                |\n| ------------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |\n| `input`                   | Object | Yes      | Top-level object containing request data.                                                                                                  |\n| `input.workflow`          | Object | Yes      | The ComfyUI workflow exported in the [required format](#getting-the-workflow-json).                                                        |\n| `input.images`            | Array  | No       | Optional array of input images. Each image is uploaded to ComfyUI's `input` directory and can be referenced by its `name` in the workflow. |\n| `input.comfy_org_api_key` | String | No       | Optional per-request Comfy.org API key for API Nodes. Overrides the `COMFY_ORG_API_KEY` environment variable if both are set.              |\n\n#### `input.images` Object\n\nEach object within the `input.images` array must contain:\n\n| Field Name | Type   | Required | Description                                                                                                                       |\n| ---------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------- |\n| `name`     | String | Yes      | Filename used to reference the image in the workflow (e.g., via a \"Load Image\" node). Must be unique within the array.            |\n| `image`    | String | Yes      | Base64 encoded string of the image. A data URI prefix (e.g., `data:image\u002Fpng;base64,`) is optional and will be handled correctly. |\n\n> [!NOTE]\n>\n> **Size Limits:** RunPod endpoints have request size limits (e.g., 10MB for `\u002Frun`, 20MB for `\u002Frunsync`). Large base64 input images can exceed these limits. See [RunPod Docs](https:\u002F\u002Fdocs.runpod.io\u002Fdocs\u002Fserverless-endpoint-urls).\n\n### Output\n\n> [!WARNING]\n>\n> **Breaking Change in Output Format (5.0.0+)**\n>\n> Versions `\u003C 5.0.0` returned the primary image data (S3 URL or base64 string) directly within an `output.message` field.\n> Starting with `5.0.0`, the output format has changed significantly, see below\n\n```json\n{\n  \"id\": \"sync-uuid-string\",\n  \"status\": \"COMPLETED\",\n  \"output\": {\n    \"images\": [\n      {\n        \"filename\": \"ComfyUI_00001_.png\",\n        \"type\": \"base64\",\n        \"data\": \"iVBORw0KGgoAAAANSUhEUg...\"\n      }\n    ]\n  },\n  \"delayTime\": 123,\n  \"executionTime\": 4567\n}\n```\n\n| Field Path      | Type             | Required | Description                                                                                                 |\n| --------------- | ---------------- | -------- | ----------------------------------------------------------------------------------------------------------- |\n| `output`        | Object           | Yes      | Top-level object containing the results of the job execution.                                               |\n| `output.images` | Array of Objects | No       | Present if the workflow generated images. Contains a list of objects, each representing one output image.   |\n| `output.errors` | Array of Strings | No       | Present if non-fatal errors or warnings occurred during processing (e.g., S3 upload failure, missing data). |\n\n#### `output.images`\n\nEach object in the `output.images` array has the following structure:\n\n| Field Name | Type   | Description                                                                                     |\n| ---------- | ------ | ----------------------------------------------------------------------------------------------- |\n| `filename` | String | The original filename assigned by ComfyUI during generation.                                    |\n| `type`     | String | Indicates the format of the data. Either `\"base64\"` or `\"s3_url\"` (if S3 upload is configured). |\n| `data`     | String | Contains either the base64 encoded image string or the S3 URL for the uploaded image file.      |\n\n> [!NOTE]\n> The `output.images` field provides a list of all generated images (excluding temporary ones).\n>\n> - If S3 upload is **not** configured (default), `type` will be `\"base64\"` and `data` will contain the base64 encoded image string.\n> - If S3 upload **is** configured, `type` will be `\"s3_url\"` and `data` will contain the S3 URL. See the [Configuration Guide](docs\u002Fconfiguration.md#example-s3-response) for an S3 example response.\n> - Clients interacting with the API need to handle this list-based structure under `output.images`.\n\n## Usage\n\nTo interact with your deployed RunPod endpoint:\n\n1.  **Get API Key:** Generate a key in RunPod [User Settings](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fserverless\u002Fuser\u002Fsettings) (`API Keys` section).\n2.  **Get Endpoint ID:** Find your endpoint ID on the [Serverless Endpoints](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fserverless\u002Fuser\u002Fendpoints) page or on the `Overview` page of your endpoint.\n\n### Generate Image (Sync Example)\n\nSend a workflow to the `\u002Frunsync` endpoint (waits for completion). Replace `\u003Capi_key>` and `\u003Cendpoint_id>`. The `-d` value should contain the [JSON input described above](#input).\n\n```bash\ncurl -X POST \\\n  -H \"Authorization: Bearer \u003Capi_key>\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"input\":{\"workflow\":{... your workflow JSON ...}}}' \\\n  https:\u002F\u002Fapi.runpod.ai\u002Fv2\u002F\u003Cendpoint_id>\u002Frunsync\n```\n\nYou can also use the `\u002Frun` endpoint for asynchronous jobs and then poll the `\u002Fstatus` to see when the job is done. Or you [add a `webhook` into your request](https:\u002F\u002Fdocs.runpod.io\u002Fserverless\u002Fendpoints\u002Fsend-requests#webhook-notifications) to be notified when the job is done.\n\nRefer to [`test_input.json`](.\u002Ftest_input.json) for a complete input example.\n\n## Getting the Workflow JSON\n\nTo get the correct `workflow` JSON for the API:\n\n1.  Open ComfyUI in your browser.\n2.  In the top navigation, select `Workflow > Export (API)`\n3.  A `workflow.json` file will be downloaded. Use the content of this file as the value for the `input.workflow` field in your API requests.\n\n## SSH Access\n\nTo enable SSH access to the worker, set the `PUBLIC_KEY` environment variable to your SSH public key. The worker will start an SSH server automatically. Make sure to expose **port 22** in your RunPod template so you can connect.\n\n## Further Documentation\n\n- **[Deployment Guide](docs\u002Fdeployment.md):** Detailed steps for deploying on RunPod.\n- **[Configuration Guide](docs\u002Fconfiguration.md):** Full list of environment variables (including S3 setup).\n- **[Customization Guide](docs\u002Fcustomization.md):** Adding custom models and nodes (Network Volumes, Docker builds).\n- **[Development Guide](docs\u002Fdevelopment.md):** Setting up a local environment for development & testing\n- **[CI\u002FCD Guide](docs\u002Fci-cd.md):** Information about the automated Docker build and publish workflows.\n- **[Acknowledgments](docs\u002Facknowledgments.md):** Credits and thanks\n","# worker-comfyui\n\n> [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI) 作为无服务器 API，在 [RunPod](https:\u002F\u002Fwww.runpod.io\u002F) 上运行\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Frunpod-workers_worker-comfyui_readme_9cc4657f9fab.jpg\" title=\"Worker sitting in comfy chair\" \u002F>\n\u003C\u002Fp>\n\n[![RunPod](https:\u002F\u002Fapi.runpod.io\u002Fbadge\u002Frunpod-workers\u002Fworker-comfyui)](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fhub\u002Frunpod-workers\u002Fworker-comfyui)\n\n---\n\n本项目允许您在 RunPod 平台上将 ComfyUI 工作流作为无服务器 API 端点运行。通过 API 调用提交工作流，并以 base64 字符串或 S3 URL 的形式接收生成的图像。\n\n## 目录\n\n- [快速入门](#quickstart)\n- [可用的 Docker 镜像](#available-docker-images)\n- [API 规范](#api-specification)\n- [使用方法](#usage)\n- [获取工作流 JSON](#getting-the-workflow-json)\n- [更多文档](#further-documentation)\n\n---\n\n## 快速入门\n\n1.  🐳 为您的无服务器端点选择一个 [可用的 Docker 镜像](#available-docker-images)，例如 `runpod\u002Fworker-comfyui:\u003Cversion>-sd3`。\n2.  📄 按照 [部署指南](docs\u002Fdeployment.md) 设置您的 RunPod 模板和端点。\n3.  ⚙️ 您可以使用环境变量对工作器进行可选配置（例如用于 S3 上传），请参阅完整的 [配置指南](docs\u002Fconfiguration.md)。\n4.  🧪 从 [`test_resources\u002Fworkflows\u002F`](.\u002Ftest_resources\u002Fworkflows\u002F) 中选择一个示例工作流，或者 [获取您自己的工作流 JSON](#getting-the-workflow-json)。\n5.  🚀 按照下面的 [使用方法](#usage) 步骤与您部署的端点交互。\n\n## 可用的 Docker 镜像\n\n这些镜像可在 Docker Hub 上找到，仓库名为 `runpod\u002Fworker-comfyui`：\n\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-base`**：纯净的 ComfyUI 安装，不含任何模型。\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-flux1-schnell`**：包含 [FLUX.1 schnell](https:\u002F\u002Fhuggingface.co\u002Fblack-forest-labs\u002FFLUX.1-schnell) 所需的检查点、文本编码器和 VAE。\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-flux1-dev`**：包含 [FLUX.1 dev](https:\u002F\u002Fhuggingface.co\u002Fblack-forest-labs\u002FFLUX.1-dev) 所需的检查点、文本编码器和 VAE。\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-sdxl`**：包含 [Stable Diffusion XL](https:\u002F\u002Fhuggingface.co\u002Fstabilityai\u002Fstable-diffusion-xl-base-1.0) 所需的检查点和 VAE。\n- **`runpod\u002Fworker-comfyui:\u003Cversion>-sd3`**：包含 [Stable Diffusion 3 medium](https:\u002F\u002Fhuggingface.co\u002Fstabilityai\u002Fstable-diffusion-3-medium) 所需的检查点。\n\n请将 `\u003Cversion>` 替换为当前的发布标签，最新版本可在 [发行页面](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Freleases) 查看。\n\n## API 规范\n\n该工作器暴露了标准的 RunPod 无服务器端点（`\u002Frun`、`\u002Frunsync`、`\u002Fhealth`）。默认情况下，图像会以 base64 字符串的形式返回。您可以通过设置特定的环境变量来配置工作器，使其将图像上传到 S3 存储桶（详见 [配置指南](docs\u002Fconfiguration.md)）。\n\n对于需要等待任务完成并直接返回结果的同步请求，请使用 `\u002Frunsync` 端点。而对于异步请求，则应使用 `\u002Frun` 端点，它会立即返回一个作业 ID；您需要单独轮询 `\u002Fstatus` 端点来获取结果。\n\n### 输入\n\n```json\n{\n  \"input\": {\n    \"workflow\": {\n      \"6\": {\n        \"inputs\": {\n          \"text\": \"a ball on the table\",\n          \"clip\": [\"30\", 1]\n        },\n        \"class_type\": \"CLIPTextEncode\",\n        \"_meta\": {\n          \"title\": \"CLIP Text Encode (Positive Prompt)\"\n        }\n      }\n    },\n    \"images\": [\n      {\n        \"name\": \"input_image_1.png\",\n        \"image\": \"data:image\u002Fpng;base64,iVBOR...\"\n      }\n    ]\n  }\n}\n```\n\n下表描述了 `input` 对象中的字段：\n\n| 字段路径                | 类型   | 必填 | 描述                                                                                                                                |\n| ------------------------- | ------ | ---- | ---------------------------------------------------------------------------------------------------------------------------------- |\n| `input`                   | 对象 | 是   | 包含请求数据的顶层对象。                                                                                                          |\n| `input.workflow`          | 对象 | 是   | 以 [所需格式](#getting-the-workflow-json) 导出的 ComfyUI 工作流。                                                                |\n| `input.images`            | 数组 | 否   | 可选的输入图像数组。每张图像都会被上传到 ComfyUI 的 `input` 目录，并可以在工作流中通过其 `name` 引用。                     |\n| `input.comfy_org_api_key` | 字符串 | 否   | 可选的每请求 Comfy.org API 密钥，用于 API 节点。如果同时设置了此键和 `COMFY_ORG_API_KEY` 环境变量，则优先使用前者。 |\n\n#### `input.images` 对象\n\n`input.images` 数组中的每个对象必须包含以下字段：\n\n| 字段名     | 类型   | 必填 | 描述                                                                                                                       |\n| ---------- | ------ | ---- | -------------------------------------------------------------------------------------------------------------------------- |\n| `name`     | 字符串 | 是   | 用于在工作流中引用该图像的文件名（例如通过“加载图像”节点）。数组内必须唯一。                                            |\n| `image`    | 字符串 | 是   | 图像的 base64 编码字符串。数据 URI 前缀（如 `data:image\u002Fpng;base64,`）是可选的，系统会正确处理。                             |\n\n> [!NOTE]\n>\n> **大小限制：** RunPod 端点对请求大小有限制（例如 `\u002Frun` 为 10MB，`\u002Frunsync` 为 20MB）。较大的 base64 格式输入图像可能会超出这些限制。更多信息请参阅 [RunPod 文档](https:\u002F\u002Fdocs.runpod.io\u002Fdocs\u002Fserverless-endpoint-urls)。\n\n### 输出\n\n> [!WARNING]\n>\n> **输出格式的重大变更（5.0.0 及以上版本）**\n>\n> 版本 `\u003C 5.0.0` 会直接在 `output.message` 字段中返回主图像数据（S3 URL 或 base64 字符串）。\n> 自 `5.0.0` 起，输出格式发生了显著变化，详情如下所示。\n\n```json\n{\n  \"id\": \"sync-uuid-string\",\n  \"status\": \"COMPLETED\",\n  \"output\": {\n    \"images\": [\n      {\n        \"filename\": \"ComfyUI_00001_.png\",\n        \"type\": \"base64\",\n        \"data\": \"iVBORw0KGgoAAAANSUhEUg...\"\n      }\n    ]\n  },\n  \"delayTime\": 123,\n  \"executionTime\": 4567\n}\n```\n\n| 字段路径      | 类型             | 是否必填 | 描述                                                                                                 |\n| --------------- | ---------------- | -------- | ----------------------------------------------------------------------------------------------------------- |\n| `output`        | 对象           | 是      | 顶层对象，包含作业执行结果。                                               |\n| `output.images` | 对象数组       | 否      | 如果工作流生成了图像，则存在此字段。包含一个对象列表，每个对象代表一张输出图像。   |\n| `output.errors` | 字符串数组     | 否      | 如果处理过程中发生了非致命错误或警告（例如 S3 上传失败、数据缺失），则存在此字段。 |\n\n#### `output.images`\n\n`output.images` 数组中的每个对象具有以下结构：\n\n| 字段名称 | 类型   | 描述                                                                                     |\n| ---------- | ------ | ----------------------------------------------------------------------------------------------- |\n| `filename` | 字符串 | ComfyUI 在生成过程中分配的原始文件名。                                    |\n| `type`     | 字符串 | 表示数据的格式。可以是 `\"base64\"` 或 `\"s3_url\"`（如果已配置 S3 上传）。 |\n| `data`     | 字符串 | 包含 base64 编码的图像字符串，或者已上传图像文件的 S3 URL。      |\n\n> [!NOTE]\n> `output.images` 字段提供了所有生成图像的列表（不包括临时图像）。\n>\n> - 如果未配置 S3 上传（默认情况），`type` 将为 `\"base64\"`，`data` 将包含 base64 编码的图像字符串。\n> - 如果已配置 S3 上传，`type` 将为 `\"s3_url\"`，`data` 将包含 S3 URL。有关 S3 示例响应，请参阅[配置指南](docs\u002Fconfiguration.md#example-s3-response)。\n> - 与 API 交互的客户端需要处理 `output.images` 下的列表结构。\n\n## 使用方法\n\n要与您部署的 RunPod 端点进行交互：\n\n1.  **获取 API 密钥：** 在 RunPod 的[用户设置](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fserverless\u002Fuser\u002Fsettings)中生成密钥（“API 密钥”部分）。\n2.  **获取端点 ID：** 您可以在[无服务器端点](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fserverless\u002Fuser\u002Fendpoints)页面或您的端点“概览”页面上找到端点 ID。\n\n### 生成图像（同步示例）\n\n将工作流发送到 `\u002Frunsync` 端点（等待完成）。请替换 `\u003Capi_key>` 和 `\u003Cendpoint_id>`。`-d` 参数应包含[上述输入 JSON](#input)。\n\n```bash\ncurl -X POST \\\n  -H \"Authorization: Bearer \u003Capi_key>\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"input\":{\"workflow\":{... 您的工作流 JSON ...}}}' \\\n  https:\u002F\u002Fapi.runpod.ai\u002Fv2\u002F\u003Cendpoint_id>\u002Frunsync\n```\n\n您也可以使用 `\u002Frun` 端点提交异步任务，然后轮询 `\u002Fstatus` 来查看任务何时完成。或者您可以在请求中[添加 `webhook`](https:\u002F\u002Fdocs.runpod.io\u002Fserverless\u002Fendpoints\u002Fsend-requests#webhook-notifications)，以便在任务完成后收到通知。\n\n完整的输入示例请参考 [`test_input.json`](.\u002Ftest_input.json)。\n\n## 获取工作流 JSON\n\n要获取适用于 API 的正确 `workflow` JSON：\n\n1.  在浏览器中打开 ComfyUI。\n2.  在顶部导航栏中选择“工作流 > 导出（API）”。\n3.  将下载一个 `workflow.json` 文件。请将该文件的内容用作 API 请求中 `input.workflow` 字段的值。\n\n## SSH 访问\n\n要启用对工作器的 SSH 访问，请将 `PUBLIC_KEY` 环境变量设置为您自己的 SSH 公钥。工作器将自动启动 SSH 服务器。请确保在您的 RunPod 模板中开放 **端口 22**，以便您可以连接。\n\n## 更多文档\n\n- **[部署指南](docs\u002Fdeployment.md)：** 在 RunPod 上部署的详细步骤。\n- **[配置指南](docs\u002Fconfiguration.md)：** 环境变量的完整列表（包括 S3 设置）。\n- **[定制指南](docs\u002Fcustomization.md)：** 添加自定义模型和节点（网络卷、Docker 构建）。\n- **[开发指南](docs\u002Fdevelopment.md)：** 搭建本地开发与测试环境。\n- **[CI\u002FCD 指南](docs\u002Fci-cd.md)：** 关于自动化 Docker 构建和发布流程的信息。\n- **[致谢](docs\u002Facknowledgments.md)：** 致谢与感谢","# worker-comfyui 快速上手指南\n\n本指南帮助中国开发者在 RunPod 平台上快速部署并使用 ComfyUI 作为无服务器（Serverless）API。\n\n## 环境准备\n\n在开始之前，请确保满足以下要求：\n\n*   **RunPod 账号**：拥有有效的 RunPod 账户并已完成充值。\n*   **API 密钥**：在 RunPod 控制台的 [User Settings](https:\u002F\u002Fwww.runpod.io\u002Fconsole\u002Fserverless\u002Fuser\u002Fsettings) 中生成 API Key。\n*   **基础工具**：本地安装了 `curl` 或 Postman 等 API 测试工具，以及能够编辑 JSON 文件的编辑器。\n*   **网络环境**：由于模型下载和 Docker 拉取涉及海外资源，建议配置稳定的网络环境或使用代理加速。\n\n## 安装步骤\n\n本项目无需在本地安装复杂依赖，核心步骤是在 RunPod 云端配置 Serverless 端点。\n\n### 1. 选择 Docker 镜像\n登录 RunPod 控制台，创建新的 Serverless Endpoint 时，选择以下官方预构建镜像之一（将 `\u003Cversion>` 替换为 [Releases 页面](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Freleases) 上的最新版本号）：\n\n*   **基础版** (无预装模型): `runpod\u002Fworker-comfyui:\u003Cversion>-base`\n*   **FLUX.1 Schnell**: `runpod\u002Fworker-comfyui:\u003Cversion>-flux1-schnell`\n*   **FLUX.1 Dev**: `runpod\u002Fworker-comfyui:\u003Cversion>-flux1-dev`\n*   **Stable Diffusion XL**: `runpod\u002Fworker-comfyui:\u003Cversion>-sdxl`\n*   **Stable Diffusion 3 Medium**: `runpod\u002Fworker-comfyui:\u003Cversion>-sd3`\n\n### 2. 部署端点\n1.  进入 RunPod Console -> **Serverless** -> **New Endpoint**。\n2.  输入端点名称，选择上述 Docker 镜像。\n3.  选择 GPU 类型（推荐 A10G, A100 或 H100）。\n4.  （可选）配置环境变量：如需将生成的图片自动上传至 S3，请参考 [Configuration Guide](docs\u002Fconfiguration.md) 设置 `S3_BUCKET_NAME` 等相关变量。\n5.  点击 **Deploy** 启动端点。\n6.  部署完成后，复制 **Endpoint ID** 备用。\n\n## 基本使用\n\n### 第一步：获取工作流 JSON\nAPI 需要标准的 ComfyUI 工作流 JSON 格式：\n1.  在浏览器打开本地或在线 ComfyUI。\n2.  点击右上角菜单 `Workflow` > `Export (API)`。\n3.  下载 `workflow.json` 文件，其内容即为 API 请求中的 `workflow` 字段值。\n\n### 第二步：调用 API 生成图片\n使用 `curl` 命令向你的端点发送同步请求（`\u002Frunsync`），等待任务完成并直接返回结果。\n\n请替换以下占位符：\n*   `\u003Capi_key>`: 你的 RunPod API Key\n*   `\u003Cendpoint_id>`: 你的端点 ID\n*   `{... your workflow JSON ...}`: 第一步中获取的工作流内容\n\n```bash\ncurl -X POST \\\n  -H \"Authorization: Bearer \u003Capi_key>\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"input\": {\n      \"workflow\": {\n        \"6\": {\n          \"inputs\": {\n            \"text\": \"a ball on the table\",\n            \"clip\": [\"30\", 1]\n          },\n          \"class_type\": \"CLIPTextEncode\",\n          \"_meta\": {\n            \"title\": \"CLIP Text Encode (Positive Prompt)\"\n          }\n        }\n      }\n    }\n  }' \\\n  https:\u002F\u002Fapi.runpod.ai\u002Fv2\u002F\u003Cendpoint_id>\u002Frunsync\n```\n\n### 第三步：解析返回结果\n成功响应（Status 200）将返回如下 JSON 结构。生成的图片位于 `output.images` 数组中：\n\n```json\n{\n  \"id\": \"sync-uuid-string\",\n  \"status\": \"COMPLETED\",\n  \"output\": {\n    \"images\": [\n      {\n        \"filename\": \"ComfyUI_00001_.png\",\n        \"type\": \"base64\",\n        \"data\": \"iVBORw0KGgoAAAANSUhEUg...\" \n      }\n    ]\n  },\n  \"delayTime\": 123,\n  \"executionTime\": 4567\n}\n```\n\n*   **type**: `\"base64\"` 表示数据为 Base64 编码字符串（默认）；若配置了 S3，则为 `\"s3_url\"`。\n*   **data**: 包含具体的图片数据或下载链接。\n\n> **注意**：RunPod 对请求大小有限制（同步请求约 20MB）。如果需要传入大图作为底图，请确保 Base64 编码后的尺寸未超限，或考虑使用异步请求 (`\u002Frun`) 配合 Webhook。","一家电商初创公司的后端团队需要为商品详情页动态生成高质量的营销配图，以应对每日数千次的个性化图片请求。\n\n### 没有 worker-comfyui 时\n- **资源闲置浪费**：团队必须长期租用昂贵的 GPU 服务器来部署 ComfyUI，即使深夜无请求时也在空转计费，成本居高不下。\n- **运维负担沉重**：每次更新 Stable Diffusion 模型或调整工作流节点，都需要人工登录服务器重新配置环境、拉取镜像，极易出错且耗时。\n- **并发扩展困难**：遇到促销活动流量激增时，固定数量的服务器无法自动扩容，导致图片生成排队严重，前端页面加载超时。\n- **集成逻辑复杂**：后端代码需自行编写复杂的队列管理和状态轮询逻辑，以处理异步生成任务，增加了系统耦合度。\n\n### 使用 worker-comfyui 后\n- **按需付费降本**：基于 RunPod Serverless 架构，仅在 API 接收到生成请求时才启动实例并计费，无请求时费用为零，大幅降低运营成本。\n- **开箱即用部署**：直接选用预装了 FLUX.1 或 SDXL 模型的官方 Docker 镜像，通过环境变量即可配置 S3 存储，无需手动管理底层依赖。\n- **弹性自动伸缩**：面对流量高峰，平台自动并行启动数百个无状态实例处理请求，流量回落时自动释放，彻底消除排队瓶颈。\n- **标准化 API 集成**：后端只需调用标准的 `\u002Frun` 接口传入 JSON 工作流，即可同步或异步获取 Base64 图片或 S3 链接，开发效率显著提升。\n\nworker-comfyui 将复杂的 ComfyUI 工作流转化为弹性、低成本的云端 API，让开发者能专注于业务逻辑而非基础设施运维。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Frunpod-workers_worker-comfyui_5d60e0d6.png","runpod-workers","Runpod | Endpoints | Workers","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Frunpod-workers_87644c20.png","Offical collection of worker repositories for serverless endpoints on Runpod. ",null,"help@runpod.io","runpod_io","https:\u002F\u002Fwww.runpod.io\u002Fendpoints","https:\u002F\u002Fgithub.com\u002Frunpod-workers",[85,89,93,97,101],{"name":86,"color":87,"percentage":88},"Python","#3572A5",72.1,{"name":90,"color":91,"percentage":92},"Shell","#89e051",10.2,{"name":94,"color":95,"percentage":96},"Dockerfile","#384d54",10.1,{"name":98,"color":99,"percentage":100},"HCL","#844FBA",6.5,{"name":102,"color":103,"percentage":104},"JavaScript","#f1e05a",1.2,673,638,"2026-04-01T17:17:40","AGPL-3.0","Linux","必需 NVIDIA GPU (基于 RunPod 平台特性)，具体型号和显存取决于所选模型 (如 FLUX.1, SDXL, SD3)，CUDA 版本由 Docker 镜像预配置","未说明 (取决于所选模型和工作流复杂度，RunPod 实例通常建议 16GB+)",{"notes":113,"python":114,"dependencies":115},"该工具以 Docker 容器形式在 RunPod 无服务器平台上运行，无需本地安装环境。用户需选择预构建的 Docker 镜像（包含不同模型如 FLUX.1, SDXL, SD3 等）。输入输出通过 API 进行，支持同步和异步模式。大尺寸输入图片需注意 RunPod 的请求大小限制（同步 20MB，异步 10MB）。可通过环境变量配置 S3 存储上传结果。","未说明 (包含在 Docker 镜像中)",[29,116,117,118],"PyTorch (版本依镜像而定)","Transformers (隐含依赖)","Diffusers (隐含依赖)",[15,14,13],[121,122,123,124,125,126,127,128,129],"ai","comfyui","docker","runpod","stable-diffusion","sdxl","pod","serverless","worker","2026-03-27T02:49:30.150509","2026-04-06T09:43:33.493714",[133,138,143,148,152,156],{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},17497,"升级新版本后，快照（Snapshot）仍然无法恢复或自定义节点安装失败怎么办？","该问题已在版本 5.0.0 中解决。维护团队正在用极简 Dockerfile 替换旧的“恢复快照”功能，新的方案使用 comfy-cli 在正确位置安装自定义节点和下载模型。请升级到最新版本（v5.0.0 或更高）以解决此问题。","https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F116",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},17498,"遇到报错\"ComfyUI server (127.0.0.1:8188) not reachable after multiple retries\"导致任务间歇性失败，如何解决？","根本原因是处理程序（handler）之前有硬编码的 25 秒超时限制（500 次重试 × 50ms）。如果 ComfyUI 启动较慢（如加载大模型或多节点），首个任务会失败；若 ComfyUI 崩溃，每个任务都会浪费 25 秒轮询死进程。\n解决方案：已发布修复版本（参考 PR #197）。新版本的 `start.sh` 会将 ComfyUI 的进程 ID (PID) 写入文件，处理程序会检查进程是否存活：\n1. 若进程存活：无限轮询直到服务器响应（不再受 25 秒限制）。\n2. 若进程死亡：立即报错，不再浪费时间。\n请更新到包含此修复的最新镜像版本。","https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F186",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},17499,"工作流执行时出现超时（Timeout）或界面一直加载无反应，可能是什么原因？","这通常是因为等待工作流完成时触发了超时限制。该问题与网络卷（Network Volumes）的使用或长耗时工作流有关，已在版本 5.0.0 及相关 PR（#118）中修复。如果您仍遇到此问题，请确保使用的是最新版本的 Docker 镜像，并检查您的网络卷配置是否正确挂载。","https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F108",{"id":149,"question_zh":150,"answer_zh":151,"source_url":137},17500,"如何正确安装和导入自定义节点（Custom Nodes），避免导入失败？","在旧版本中，通过快照恢复自定义节点经常出错。在新版本（v5.0.0+）中，建议使用基于 `comfy-cli` 的新机制。您应该创建一个自定义 Dockerfile，继承自基础镜像（如 `FROM runpod\u002Fworker-comfyui:5.x.x-base`），并在其中使用 `comfy-cli` 命令来安装特定的自定义节点和下载模型，确保它们被放置在正确的目录结构中，而不是依赖旧的快照恢复功能。",{"id":153,"question_zh":154,"answer_zh":155,"source_url":142},17501,"遇到\"CUDA unknown error\"或 GPU 初始化失败的错误该如何排查？","此类错误（如 `RuntimeError: CUDA unknown error`）通常与 GPU 未正确初始化有关，可能发生在 Serverless 端点 GPU 资源可用性低时，或者环境变量 `CUDA_VISIBLE_DEVICES` 在程序启动后被错误修改。这与 ComfyUI 服务不可达的超时问题不同，单纯增加延迟无法解决。建议检查 RunPod 实例状态，确认是否有维护操作，或尝试重新部署实例以确保获取到健康的 GPU 资源。",{"id":157,"question_zh":158,"answer_zh":159,"source_url":147},17502,"该仓库现在是否由 RunPod 官方支持？遇到问题该去哪里反馈？","是的，该仓库已正式移交给 RunPod 团队进行官方支持和维护。维护者表示将致力于改进用户体验（如增加 Worker 预热机制、优化最大重试次数等）。如果您遇到具体问题或需要新功能，可以直接在此 GitHub 仓库提交 Issue，或在 RunPod 的 Discord 频道中联系团队进行测试和反馈。",[161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,240,245,250,255],{"id":162,"version":163,"summary_zh":164,"released_at":165},107717,"5.8.5","## 变更内容\n* 修复：禁用 .runpod 测试，以解决无服务器部署失败问题，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F214 中完成\n* 杂项：由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F215 中更新软件包版本\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.8.4...5.8.5","2026-03-20T22:28:40",{"id":167,"version":168,"summary_zh":169,"released_at":170},107718,"5.8.4","## 变更内容\n* 修复：在更改集 PR 上自动创建检查运行，以满足分支保护要求，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F211 中完成\n* 修复：将 Docker 镜像标签变量作为环境变量传递，而非构建参数，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F212 中完成\n* 杂项：更新软件包版本，由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F213 中完成\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.8.3...5.8.4","2026-03-20T17:09:53",{"id":172,"version":173,"summary_zh":174,"released_at":175},107719,"5.8.3","## 变更内容\n* 新特性(docker): 添加包含阿里巴巴通义模型的 z-image-turbo 镜像，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F189 中实现\n* 构建优化: 将 semantic-release 替换为 changesets，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F196 中完成\n* 新特性: 增加 SSH 支持以实现远程访问，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F199 中实现\n* 构建优化: 将 CLAUDE.md 替换为 AGENTS.md，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F200 中完成\n* 构建优化: 为 v5.8.0 小版本发布添加 changeset，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F202 中完成\n* 修复: 在进程存活期间无限轮询 ComfyUI 服务器，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F197 中修复\n* 修复: 当 GPU 不可用时快速失败并显示清晰错误信息，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F198 中修复\n* 修复: 在 package.json 中指定 pnpm 版本以用于 CI 流水线，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F203 中修复\n* 构建优化: 由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F204 中对包进行版本管理\n* 修复: 为 z-image-turbo 的下载添加 HuggingFace 身份验证，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F205 中修复\n* 构建优化: 由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F206 中对包进行版本管理\n* 修复: 将 HuggingFace Token 传递给 z-image-turbo 的构建目标，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F207 中修复\n* 构建优化: 由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F208 中对包进行版本管理\n* 修复: 将 Docker 构建拆分为独立作业，以避免磁盘空间耗尽，由 @TimPietruskyRunPod 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F209 中修复\n* 构建优化: 由 @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F210 中对包进行版本管理\n\n## 新贡献者\n* @github-actions[bot] 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F204 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.6.0...5.8.3","2026-03-17T17:00:56",{"id":177,"version":178,"summary_zh":179,"released_at":180},107720,"5.7.1","**完整更新日志**: https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.5.1...5.7.1","2025-12-24T11:24:20",{"id":182,"version":183,"summary_zh":184,"released_at":185},107721,"5.7.0","* 特性：调试“网络卷模型路径”\n* 维护：升级至 ComfyUI [0.6.0](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Freleases\u002Ftag\u002Fv0.6.0)","2025-12-24T10:43:44",{"id":187,"version":188,"summary_zh":189,"released_at":190},107722,"5.6.0","* 功能：调试“网络卷模型路径”","2025-12-03T11:02:23",{"id":192,"version":193,"summary_zh":194,"released_at":195},107723,"5.5.1","* 文档：添加“ComfyUI 到 API”","2025-11-10T14:57:40",{"id":197,"version":198,"summary_zh":199,"released_at":200},107724,"5.5.0","* 功能：添加 COMFY_ORG_API_KEY；更新了 hub 中的 logo","2025-10-08T15:27:50",{"id":202,"version":203,"summary_zh":204,"released_at":205},107725,"5.4.1","## 变更内容\n* 杂项：升级至 ComfyUI [0.3.57](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Freleases\u002Ftag\u002Fv0.3.57)\n* 文档：@server-stelland 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F147 中将 GitHub 链接更新为正确链接\n\n## 新贡献者\n* @server-stelland 在 https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fpull\u002F147 中完成了首次贡献","2025-09-04T10:05:21",{"id":207,"version":208,"summary_zh":209,"released_at":210},107726,"5.4.0","- 功能（hub）：默认版本为“latest”，以便在每次新发布时自动获取最新版本。","2025-08-14T21:06:55",{"id":212,"version":213,"summary_zh":214,"released_at":215},107727,"5.3.0","# [5.3.0](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.2.0...5.3.0) (2025-07-22)\n\n\n### Features\n\n* add support for 5090\u002FB200 ([#150](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F150)) ([7492513](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F7492513490bc1723503dded682ee2c313a1c8ea6))\n\n\n\n","2025-07-22T16:51:13",{"id":217,"version":218,"summary_zh":219,"released_at":220},107728,"5.2.0","# [5.2.0](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.1.1...5.2.0) (2025-07-02)\n\n\n### Features\n\n* update comfyui to 0.3.43 ([#145](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F145)) ([32c2395](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F32c23956a44dae4cd3800d6de9491539065a200a))\n\n\n\n","2025-07-02T09:26:41",{"id":222,"version":223,"summary_zh":224,"released_at":225},107729,"5.1.1","## [5.1.1](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.1.0...5.1.1) (2025-07-01)\n\n\n### Bug Fixes\n\n* update runpod to 1.7.12 ([#144](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fissues\u002F144)) ([c689eda](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002Fc689eda26b8d9505a0a63d6d4af6f8cab997e24f))\n\n\n\n","2025-07-01T12:48:57",{"id":227,"version":228,"summary_zh":229,"released_at":230},107730,"5.1.0","# [5.1.0](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F5.0.4...5.1.0) (2025-05-28)\n\n\n### Bug Fixes\n\n* add missing libs needed for \"opencv\" to work ([33cd5d3](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F33cd5d349f76e4a393a3a4f3e99f954989b2c683))\n* use proper example that actually can be copied & pasted ([506fac1](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F506fac10480ec238110ae0dcb59b0b6865879471))\n\n\n### Features\n\n* added COMFY_LOG_LEVEL to control the logs from ComfyUI ([183de1c](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F183de1cdececa217abcbec30545e24c5820eba97))\n* added script \"comfy-manager-set-mode\" to set the \"network mode\" ([4d5425f](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F4d5425f211b85b95e4953f6c0ddf27ed92e3cfa1))\n* added script \"comfy-node-install\" as a wrapper to \"comfy-cli\" to proivde a proper exit code when something is not corret ([6605506](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F660550637bceb72052ef7c1dec9d6f36035a2fd2))\n* improved logging & provide actual reason why the workflow validation might fail ([7582999](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F7582999209d9683c198aa1c6d3793a16fe059416))\n* updated to ubuntu 24.04 & python 3.12 to support ffmpeg 6 ([eb8dd26](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002Feb8dd265e0823b39974dc91bbb489b54ac92c8d3))\n\n\n\n","2025-05-28T10:42:03",{"id":232,"version":233,"summary_zh":234,"released_at":235},107731,"5.0.4","* trigger a new release on the hub","2025-05-19T16:54:17",{"id":237,"version":238,"summary_zh":234,"released_at":239},107732,"5.0.3","2025-05-19T13:21:45",{"id":241,"version":242,"summary_zh":243,"released_at":244},107733,"5.0.2","* ci: trigger tests","2025-05-16T16:19:01",{"id":246,"version":247,"summary_zh":248,"released_at":249},107734,"5.0.1","* test: simplified workflow & use it for both tests","2025-05-09T11:40:35",{"id":251,"version":252,"summary_zh":253,"released_at":254},107735,"5.0.0","## Breaking Change\r\n\r\n*   Versions `\u003C 5.0.0` returned the primary image data (S3 URL or base64 string) directly within an `output.message` field\r\n*   Starting with `v5.0.0`, the output format has changed significantly:\r\n    *   Image data is now returned within an `output.images` field\r\n    *   This field is a **list of dictionaries**. Each dictionary contains:\r\n        *   `filename`: The original filename from ComfyUI\r\n        *   `type`: Either `\"s3_url\"` or `\"base64\"`\r\n        *   `data`: The corresponding S3 URL or the base64 encoded image string\r\n*   **Clients need to be updated to handle this new structure as it's not compatible with previous versions.**\r\n\r\n## Features\r\n\r\n*   **Websocket Communication:** Replaced HTTP polling with websockets for job status monitoring and completion.\r\n    *   fixes #108\r\n    *   fixes #103\r\n*   **Multiple Output Images:** Processes and returns all non-`temp` images from the workflow history\r\n    *   fixes #95\r\n    *   fixes #45 \r\n*   **Simplified Customization Workflow:** Users no longer need to fork the repository & use the \"snapshot restoration\" workflow to add custom nodes or models. They can create their own `Dockerfile` that builds `FROM` an official base image, using `comfy-cli` for setup to install custom-nodes and download models\r\n    * fixes #116\r\n    * fixes #107\r\n    * fixes #109\r\n    * fixes #97\r\n* **ComfyUI update**: [0.3.30](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Freleases\u002Ftag\u002Fv0.3.30)\r\n*   **Direct Image Retrieval:** Fetches image data via ComfyUI `\u002Fview` API instead of filesystem access\r\n*   **Filename in Output:** Includes original `filename` in the output data for each image\r\n*   **Websocket Reconnection:** Added automatic reconnection attempts for dropped connections during monitoring\r\n*   **Unhandled Output Warnings:** Logs warnings for unrecognized node output types\r\n\r\n*   **Removed Redundant Output:** Removed the `refresh_worker` key from `handler.py` return values, as the behavior is solely controlled by the environment variable\r\n\r\n## Documentation\r\n\r\n*   **Major Restructure:** Refactored the main `README.md` into a concise overview and quickstart guide, moving detailed sections (deployment, configuration, customization, development, ci\u002Fcd, acknowledgments) into separate, focused files within the `docs\u002F` directory for improved readability and maintainability\r\n*   **Improved Customization Guide:** Rewrote `docs\u002Fcustomization.md` to feature the new, simpler method using a custom `Dockerfile` with `comfy-cli` commands (`comfy node install`, `comfy model download`). Removed the old method requiring repository forks and snapshots\r\n\r\n## Bug Fixes\r\n\r\n*   **Input Image Base64 Decoding:** Correctly handles optional `data:[...];base64,...` prefixes in input image strings.\r\n","2025-05-02T23:02:26",{"id":256,"version":257,"summary_zh":258,"released_at":259},107736,"4.1.0","# [4.1.0](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcompare\u002F4.0.1...4.1.0) (2025-05-02)\n\n\n### Bug Fixes\n\n* moved code back into stage 1 ([d9ed145](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002Fd9ed14571308ad27481ae2dda4762d32b73b5d20))\n\n\n### Features\n\n* move stuff around ([2b2bc12](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F2b2bc1238dec5715092fa4b3e1418b8a443a409b))\n* removed polling; added websocket; allow multiple output images; ([79a560f](https:\u002F\u002Fgithub.com\u002Frunpod-workers\u002Fworker-comfyui\u002Fcommit\u002F79a560f46fbd303828175d138098faebd4baa97e))\n\n\n\n","2025-05-02T11:04:31"]