菜单
Install ComfyUI Assistant as a ComfyUI custom node. Use when performing or troubleshooting installation (clone, Python deps, frontend build, restart).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
For complex user requests — evaluate, investigate, ask questions, propose a plan, accept modifications, then execute. Use when the request is multi-step, ambiguous, or high-impact.
Workflow execution and complete workflow generation tools (executeWorkflow, applyWorkflowJson). Use when the user wants to run a workflow or build a complete workflow from a description.
Python backend modules, chat request lifecycle, SSE format, and API endpoints
System prompt assembly from system_context, user_context, and environment sources
Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out.
When the user asks to create or design a skill, follow a clear process: clarify intent, draft name/description/instructions, then call createSkill. Optionally offer to create a skill when you automate a procedure they might want to reuse.
| name | installation |
| description | Install ComfyUI Assistant as a ComfyUI custom node. Use when performing or troubleshooting installation (clone, Python deps, frontend build, restart). |
| version | 0.0.1 |
| license | MIT |
Use this skill when you are asked to install or troubleshoot the installation of ComfyUI Assistant. It provides the full sequence and key paths so you can run the right commands in the right order.
| Requirement | Purpose |
|---|---|
| ComfyUI | Host; extension runs inside ComfyUI |
| Python 3.x | Same interpreter as ComfyUI; runs backend |
| Node.js v18+ | Build frontend (Vite) |
| npm | Install frontend deps |
All commands assume ComfyUI root is the starting point unless stated otherwise.
cd custom_nodes
git clone https://github.com/YOUR_ORG/ComfyUI_ComfyAssistant.git
cd ComfyUI_ComfyAssistant
Extension root = ComfyUI/custom_nodes/ComfyUI_ComfyAssistant/.
From the extension root (where pyproject.toml lives):
pip install -r requirements.txt
Installs: openai, python-dotenv, ddgs, beautifulsoup4. Required for backend (chat, tools, providers). If the user uses a venv for ComfyUI, use that venv’s pip.
cd ui
npm install
npm run build
Output goes to dist/ (e.g. dist/example_ext/). ComfyUI loads the extension from this folder. No build ⇒ no Assistant tab or broken UI.
Restart so ComfyUI loads the new node and the built assets.
| Path | Purpose |
|---|---|
pyproject.toml | Python dependencies (do not edit version bounds without reason) |
ui/ | Frontend source; run npm install and npm run build here |
dist/ | Built frontend; must exist for the tab to work |
doc/installation.md | User-facing installation guide |
| Symptom | Likely cause | Action |
|---|---|---|
| "Module not found" (Python) | Python deps not installed | From extension root: pip install -r requirements.txt (use ComfyUI’s venv if applicable) |
| No Assistant tab | Extension not in custom_nodes or frontend not built | Confirm path custom_nodes/ComfyUI_ComfyAssistant, run cd ui && npm run build, restart ComfyUI |
| Tab empty or JS errors | Build missing or stale | cd ui && npm install && npm run build, restart ComfyUI |
| Assistant does not answer | No provider configured | User must set up a provider in the Assistant tab (or .env); see doc/configuration.md |
doc/installation.mddoc/configuration.md