ComfyUI Studio

A generic toolkit for driving a local ComfyUI server (default http://127.0.0.1:8188). It bundles four Skills and two transport layers that work together.

Two parts, one Plugin

The Plugin also ships a dependency-free stdio MCP server (see mcp.json + server.mjs) that exposes the same Part-A primitives (submit_prompt, check_queue, get_image) to any MCP-capable agent.

The 6 trigger scenarios (Part B)

This is the routing index. The number is the trigger scenario — read the user's intent, pick a number, and follow the pointer.

If the user's request does not map cleanly to one of these six, fall through to Part A (below) and use comfyui-workflow as a generic transport for any user-supplied workflow JSON.

Routing rules

1. Numbers 1–4 → read skills/comfyui-character/SKILL.md for the recipe (model stack, custom-node requirements, prompt structure, LoRA slots, knobs). Submit via Part A.
2. Numbers 5–6 → read skills/comfyui-drama/SKILL.md for the 7-stage pipeline and the per-shot rules. Submit each shot via Part A.
3. Anything else ("submit this workflow", "check the queue", "what models do I have", "use ComfyUI to ...", "run this JSON") → read skills/comfyui-workflow/SKILL.md directly. The basic control layer handles all of these without reading a preset.
4. Health probes ("is ComfyUI running?") → comfyui-workflow — its first step is always a GET /system_stats or submit_workflow.py --probe.

Do not duplicate behaviour: if you only need to submit a workflow, do not read this Skill, read comfyui-workflow/SKILL.md directly. This Skill is the entry point for routing, not the implementation.

Required environment

The Plugin assumes the user has:

• A running ComfyUI server (default http://127.0.0.1:8188). Override with the COMFYUI_URL environment variable or the --url flag on the Python scripts.
• The checkpoint / CLIP / VAE / ControlNet files referenced in each preset (see the Model boundary section in README.md). Edit loader fields if your install uses different filenames.
• For scenarios 1 and 2 (comfyui-character selfie workflows): a face LoRA and a style LoRA in models/loras/. The workflow JSONs reference them as your_face_lora.safetensors and your_style_lora.safetensors — replace these with your filenames before submitting. The Plugin does not bundle LoRAs.
• For scenario 2 (selfie-mimicry.json): the custom-node pack list in comfyui-character/SKILL.md (controlnet_aux, LLaMA-CPP, ModelPatchLoader, etc.).
• For scenarios 5 and 6 (comfyui-drama): two character LoRAs the user trained themselves (referenced as character_a_lora.safetensors / character_b_lora.safetensors / any_motion_lora.safetensors — replace with your filenames).

The Plugin does not download or bundle model checkpoints, LoRAs, or any other binary asset. Each Skill instructs the user to place their own files in the standard ComfyUI directory layout.

Data and network

• Network access is local-only by default. The MCP server and the Python scripts both target the address in COMFYUI_URL. No telemetry, no remote calls, no analytics.
• See docs/security-notes.md for the threat model and the data the Plugin handles.
• See docs/troubleshooting.md for common failures (ComfyUI offline, missing model, OOM).

Trying it out

End-to-end smoke test (about 5 minutes, see examples/minimal-run.md):

Use comfyui-studio to verify that my local ComfyUI is reachable, then submit scenario 3
(改图 / flux2-klein-image-edit) with the prompt "the same person sitting in an office
chair, the same outfit, professional lighting" and report the saved image path.

Expected outcome: the agent confirms ComfyUI is reachable, submits the bundled workflows/flux2-klein-image-edit.json, polls until done, downloads the image, and tells you where it was saved.

License

Apache-2.0. See LICENSE.