ComfyUI Plugin

Version every generation.
Keep the context.

Kumiho nodes automatically register prompt, model, and seed metadata + lineage — so your outputs stay searchable and reproducible.

No more "which prompt made this?" or "what seed was that?"

ComfyUI workflow with Kumiho Save Image node — metadata captured automatically

What you get

Zero workflow changes. Maximum context.

Auto-capture metadata

Prompt, negative prompt, model, sampler, seed, CFG — all captured automatically when you save through Kumiho nodes.

Automatic DERIVED_FROM edges

When you load an asset and save a new version, Kumiho automatically creates lineage edges. See exactly what led to what.

Search by prompt / model / seed

Find that perfect generation from 3 months ago by searching any combination of metadata. No more folder diving.

How it works

ComfyUI

Runs workflows & generates outputs locally

Your Storage

PNG / EXR / MP4 stay on your disk

Kumiho Cloud

Graph + metadata + access control

→ Outputs become revisions. Relationships become edges. Files stay local.

Install in 2 minutes

Three ways to get started — pick your favorite.

ComfyUI Manager (Recommended)
# In ComfyUI Manager
Manager → Install Custom Nodes
Search: "Kumiho"
pip
pip install kumiho-comfyui
Manual Clone
cd ComfyUI/custom_nodes
git clone github.com/kumihoclouds/kumiho-comfyui
Authenticate (one-time)
# Install CLI and login
pip install kumiho-cli
kumiho-cli login # Opens browser for OAuth

Credentials stored in ~/.kumiho/ — no API keys in your workflows.

You're ready when you see:

  • "Kumiho" nodes appear in ComfyUI node menu
  • kumiho-cli whoami shows your username
  • First save creates a revision in Kumiho Browser / Cloud

Example workflows

Common patterns that become repeatable with versioning.

Example 1

Basic: Load → Process → Save

  1. Kumiho Load Asset (optional input)
  2. Your processing nodes
  3. Kumiho Save Image
Outputs versioned and searchable immediately.
Example 2

Iteration: Derive from sources

  1. Load previous kref:// revision
  2. Iterate with new prompts / params
  3. Save → DERIVED_FROM edge auto-created
The graph becomes your creative history.
Example 3

Video: Generate + Preview

  1. Generate video frames
  2. Kumiho Save Video
  3. Preview inline + share kref
Videos get the same provenance as images.

Available nodes

A small set of focused nodes for load, save, search, and link.

Kumiho Load Asset

Load via kref:// URI or browse

Kumiho Save Image

Save revision with auto-lineage

Kumiho Save Video

Register video with preview

Kumiho Search Items

Search by name, kind, tags

Kumiho Create Edge

DEPENDS_ON, DERIVED_FROM

Kumiho Tag Revision

Apply approved, wip, published

Built for creators. Safe for teams.

Kumiho adds provenance and collaboration to ComfyUI — without cloud lock-in. Files stay local. Metadata stays searchable.

ComfyUI Integration — Track Lineage Automatically | Kumiho