workflow_templates

This repo hosts the official ComfyUI workflow templates and subgraph blueprints.

Overview

Content	Description	Location
Workflow Templates	Full standalone workflows for the template picker	templates/, packages/
Subgraph Blueprints	Reusable node components that appear in the node palette	blueprints/, packages/blueprints/
Template Site	Astro SSG that showcases templates at comfy.org/workflows	site/

The repository uses a package-per-media structure for Python distribution:

• packages/core – manifest + loader helpers shipped as comfyui-workflow-templates-core
• packages/media_* – workflow template JSON + preview assets for each media type
• packages/blueprints – subgraph blueprint JSON + preview assets as comfyui-subgraph-blueprints
• packages/meta and the root pyproject.toml – the comfyui-workflow-templates meta package

Template Site (site/)

The site/ directory contains an independent Astro static site that provides a browsable, searchable interface for all workflow templates. It includes AI-generated descriptions, i18n support (12 languages), SEO optimization, and automated content pipelines. See site/AGENTS.md for full documentation.

cd site
pnpm install
pnpm run dev       # Start dev server at localhost:4321
pnpm run build     # Production build (runs prebuild pipeline automatically)

Deployment Environments

The template site is deployed to four environments via GitHub Actions:

main merge (version bump)
  └─ PyPI publish ─► deploy-site.yml ─► Production (approved only)

Once per day (00:00 UTC)
  └─ cron-rebuild-site.yml         ─► Production         (prod API, approved only)

Once per day (00:00 UTC)
  └─ preview-cron.yml
       ├─ main (prod API)          ─► Preview Prod        (prod API, all workflows)
       └─ main (test API)          ─► Preview Test        (test API, all workflows)

PR opened/updated
  ├─ preview-site.yml              ─► PR Preview (one-off)
  └─ preview-cron.yml (label)      ─► PR Preview (daily, requires "preview-cron" label)

Environment	Workflow	API	Status Filter	Vercel Flag	Alias Secret	Trigger
Production	deploy-site.yml	Production	approved only	--prod	—	PyPI publish / manual
Production	cron-rebuild-site.yml	Production	approved only	--prod	—	Once per day (00:00 UTC)
Preview Prod	preview-cron.yml (main, prod)	Production	None (all)	preview	VERCEL_PREVIEW_ALIAS	Once per day (00:00 UTC)
Preview Test	preview-cron.yml (main, test)	Test	None (all)	preview	VERCEL_PREVIEW_TEST_ALIAS	Once per day (00:00 UTC)
PR Preview	preview-site.yml	Configurable	None (all)	preview	—	PR changes
PR Preview	preview-cron.yml (PR)	Test	None (all)	preview	—	Once per day (00:00 UTC)

Status filtering is controlled by the PUBLIC_APPROVED_ONLY environment variable at build time. When set to 'true', only workflows with status: 'approved' from the hub API index endpoint are included in the build. Preview environments omit this flag to show all workflows (pending, approved, rejected, deprecated) for internal review.

Quick Start

Task	Commands
Add a workflow template	Edit templates/ + bundles.json (assign a bundle). Manifest sync is optional on template-only PRs — required on version-bump/release
Add a subgraph blueprint	Edit blueprints/, blueprints_bundles.json, then python scripts/sync/sync_blueprints.py
Import external blueprints	Copy JSONs to blueprints/, then python scripts/blueprints/import_blueprints.py
Check node compatibility	npm run validate:comfyui-nodes (local ComfyUI) or see scripts/README.md

---

• workflow_templates
  • Overview
  • Quick Start
  • Adding New Templates
  • Adding New Blueprints
  • Validation

Adding New Templates

I will demonstrate how to add a new template by walking through the process of adding the Wan text to video template.

1 — Find Templates Folder

Set up ComfyUI_frontend dev environment. In the ComfyUI_frontend/.env file, add the line DISABLE_TEMPLATES_PROXY=true then start the dev server with npm run dev.

Copy the templates folder from this repository to the ComfyUI_frontend/public folder.

2 — Obtain Workflow

Either

• Create the workflow and export using Save => Export
• Use an existing workflow. To extract the workflow json from an image, you can use this tool: https://comfyui-embedded-workflow-editor.vercel.app/

I will get my workflow from the ComfyUI_examples Wan 2.1 page. To get the workflow from the video on that page, I'll drag the video into comfyui-embedded-workflow-editor. Then I'll copy and paste it into a new json file on my computer.

[!IMPORTANT]

Make sure you start ComfyUI with --disable-all-custom-nodes when creating the workflow file (to prevent custom extensions adding metadata into the saved workflow file)

3 — Obtain Thumbnails

Ideally, the thumbnail is simply the output produced by the workflow on first execution. As an example, see the output of the Mixing ControlNets template:

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗