# Comfy Agent

> Local-first desktop studio for ComfyUI, built for AI short-drama production - zero-dependency 10MB exe: creation, gallery, 600+ templates, model hub, character assets (LoRA binding), episodic pipeline, MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-ivenkoolab-comfy-agent`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [IvenKooLab](https://agentstack.voostack.com/s/ivenkoolab)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [IvenKooLab](https://github.com/IvenKooLab)
- **Source:** https://github.com/IvenKooLab/comfy-agent
- **Website:** https://github.com/IvenKooLab/comfy-agent/releases/latest

## Install

```sh
agentstack add mcp-ivenkoolab-comfy-agent
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ComfyAgent

**A local-first desktop studio for ComfyUI — pure-stdlib Python, vanilla JS, zero dependencies, one 10 MB exe**

[](https://gitee.com/IvenKooLab/comfy-agent)

[](https://github.com/IvenKooLab/comfy-agent/releases)
[](LICENSE)
[](#quick-start)
[](https://github.com/light-and-ray/awesome-alternative-uis-for-comfyui#-comfyagent)

English | [简体中文](README_zh-CN.md)

One native window that runs your local ComfyUI end to end: prompt-to-image/video creation, a gallery, a visual workflow editor, 600+ official templates, a model manager with resumable downloads, batch pipelines for episodic video, and an MCP server so external agents can drive it too.

## Highlights

- 🖥️ **Real desktop app** — double-click the exe: native window + system tray. Closing the window minimizes it; single instance; no console box
- 🔒 **Local-first** — generation runs on your GPU, data never leaves your machine
- 🪶 **Zero dependencies** — pure Python standard library backend + vanilla JS frontend, ~10 MB installed
- 🌐 **Bilingual** — full UI and built-in help in English & Chinese

## Features

- 🎨 **Create** — prompt-to-image (Flux) and prompt-to-video (MiniMax H3, native audio); Chinese prompts are auto-enhanced into English (LLM-powered, dictionary fallback); 12 style presets, character lock strings, image & video modes
- 👤 **Characters** — lock strings, reference images and **character LoRA binding** (auto-injected into image workflows, strength adjustable); ControlNet plan notes per character
- 🖼️ **Gallery** — live masonry, hover video preview, batch archive/delete, PNG parameter parsing, folder filters
- 📚 **Templates** — 600+ official ComfyUI templates with real previews, one-click load into the editor; **new subgraph-based templates (e.g. SCAIL-2 character animation) are auto-flattened** and load like any other
- 🔧 **Workflows** — SVG node editor (drag/link/snap/validation); built-in Flux + H3 workflows; import UI/API JSON or extract from PNG
- 📋 **Runs** — queue, progress, ETA, one-click retry, GPU time ledger
- 🎬 **Pipeline** — episodic script → shot list → batch queue → concat with BGM; shot-to-shot chaining (seamless long takes via last-frame continuation), priority queue, scene library, audio assets, subtitle burn-in, per-episode stats
- ⬢ **Models** — preset suites (SCAIL-2, MiniMax H3) with **one-click resumable downloads** and live progress; browse local model dirs by category with search; opening a template that needs missing models offers a one-jump download
- 🚀 **Launcher** — start/stop/update ComfyUI, model inventory, custom nodes, environment diagnostics (torch/triton/sage), logs
- 🗂️ **Knowledge** — Obsidian archiving, stats, graph view, full-text search
- 🤖 **Assistant** — natural-language control with multi-step actions
- 🔌 **MCP Server** — expose ComfyAgent to any MCP host (see below)
- 📖 **Built-in help** — 50+ searchable Q&A, bilingual
- 📊 **Hardware bar** — GPU util/temp/VRAM/RAM/queue, 2s refresh

## Quick Start

1. Grab `ComfyAgent-win64.zip` from the [latest release](https://github.com/IvenKooLab/comfy-agent/releases/latest) and unzip
2. Double-click `ComfyAgent.exe` — a native window opens (30-second setup wizard on first run)
3. Close to tray; right-click the tray icon to quit

**Requirements:** a local ComfyUI (default `127.0.0.1:8188`); `ffmpeg` on PATH (video poster frames); WebView2 runtime.

To develop against a source checkout: `python server.py --open` (browser mode), `python app.py` (desktop shell), `bash build_exe.sh` (build). See [CHANGELOG.md](CHANGELOG.md) for the design and iteration history.

## Screenshots

**Setup Wizard**

**Create**

**Templates**

**Pipeline**

**Launcher**

**Models**

**Knowledge (Obsidian)**

**Assistant**

**Help**

**Settings**

**About**

## MCP Server

A built-in zero-dependency MCP server (stdio + JSON-RPC 2.0) exposes ComfyAgent to any MCP host (ZCode / Claude Desktop / Cursor, ...):

| Tool | What it does |
|---|---|
| `query_status` | ComfyUI online state, running/queued jobs, VRAM |
| `submit_generation` | Submit image/video generation (auto prompt enhancement, count ≤ 4) |
| `list_workflows` | Workflow library (draft/final tiers with real timings) |
| `search_gallery` | Search local gallery outputs |

```json
"comfyagent": {
  "command": "python",
  "args": ["/mcp_server.py"],
  "env": { "COMFYAGENT_URL": "http://127.0.0.1:8190" }
}
```

(Requires ComfyAgent to be running.)

## Contributing

Issues and PRs welcome (English or Chinese):

1. Fork → branch → commit → PR
2. Describe the problem you solve and how to verify it
3. Backend changes must stay on the zero-third-party-dependency principle (Python stdlib only)

## License

[MIT](LICENSE) © 2026 IvenKooLab

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [IvenKooLab](https://github.com/IvenKooLab)
- **Source:** [IvenKooLab/comfy-agent](https://github.com/IvenKooLab/comfy-agent)
- **License:** MIT
- **Homepage:** https://github.com/IvenKooLab/comfy-agent/releases/latest

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ivenkoolab-comfy-agent
- Seller: https://agentstack.voostack.com/s/ivenkoolab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.