nodes/MajoorWaldi-ComfyUI-Majoor-AssetsManager
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Files
34aebea35bb28cd93e6c1947c090567becc71087
MajoorWaldi-ComfyUI-Majoor-…/docs/WORKFLOWS.md
T

7.3 KiB
Raw Blame History

Workflows Tab Guide

Last Updated: June 11, 2026

Overview

The Workflow tab turns saved ComfyUI workflow JSON files into a browsable library inside Majoor Assets Manager.

It is separate from the normal output/input asset tabs:

  • output and input tabs browse media files
  • the Workflow tab browses workflow .json files
  • workflow cards can be loaded back into ComfyUI, inspected in Graph Map, organized, tagged, and assigned thumbnails

This feature follows ComfyUI's server model: the frontend reads and writes workflow data through Majoor HTTP routes, while actual workflow loading is handed back to ComfyUI frontend import APIs when available.

Where Workflows Come From

Majoor scans these workflow roots when the Workflow tab is opened or refreshed:

  • roots configured in Settings -> Majoor Assets Manager -> Advanced -> Paths / Workflows
  • MJR_AM_WORKFLOW_DIRECTORIES, when set with multiple roots separated by the OS path separator
  • MJR_AM_WORKFLOW_DIRECTORY, when set
  • <ComfyUI>/user/default/workflows
  • <ComfyUI>/workflows
  • <custom_nodes>/majoor-assetsmanager/workflows
  • <custom_nodes>/majoor-assetsmanager/example_workflows

When you save or import a workflow from the tab, Majoor writes it to the managed workflow root:

  • the first configured workflow root, when workflow roots are set in Settings
  • MJR_AM_WORKFLOW_DIRECTORY, when set
  • otherwise <ComfyUI>/user/default/workflows
  • otherwise the extension-local workflows/ folder

Workflow categories are stored as safe subfolders under the managed root.

Opening The Tab

  1. Open Majoor Assets Manager.
  2. Click the Workflow tab in the top scope tabs.
  3. Use the search box, sort menu, filters, and card actions just like the rest of the grid.

The Workflow tab adds two toolbar buttons that only appear in this scope:

  • Save current workflow: serializes the current ComfyUI canvas and stores it as a managed workflow JSON.
  • Pick saved workflow root: chooses the folder used as the saved workflow root and refreshes the Workflow tab.
  • Import workflow: imports one or more local .json workflow files into the managed workflow library.

Workflow Cards

Each workflow card summarizes the JSON file and its detected purpose.

Cards can show:

  • workflow name and filename
  • thumbnail or generated Graph Map preview
  • task, model family, provider, and runtime classification
  • node count, link count, and subgraph count
  • missing node or missing model counts
  • category/folder
  • favorite state, usage count, tags, and notes

The library parser includes native subgraphs when counting and summarizing workflows.

Loading A Workflow

Double-click a workflow card, or use Load workflow from the context menu.

Majoor will:

  1. read the workflow JSON from /mjr/am/workflows/content
  2. warn if the current ComfyUI canvas appears dirty
  3. pass the workflow to the ComfyUI frontend import path when available
  4. mark the workflow as loaded so usage sorting can prioritize recently used workflows

If the current ComfyUI frontend does not expose a direct import path, Majoor falls back gracefully and shows a message instead of silently failing.

Inspecting A Workflow

Use Inspect or Open in Graph Map to view a workflow without replacing the current canvas.

This opens the Majoor Floating Viewer in Graph Map mode with the workflow attached as the current asset. Use it to:

  • pan and zoom the saved workflow
  • inspect node labels and simple parameters
  • review subgraph structure
  • copy node values
  • import the full workflow only when you are ready

See GRAPH_MAP.md for the full Graph Map walkthrough.

Organizing Workflows

Workflow organization is stored in the workflow library database and, when applicable, in the managed filesystem layout.

Available actions include:

  • Favorite: pin useful workflows ahead of normal sorting.
  • Rename workflow: rename the managed JSON file safely.
  • Set workflow category: move the workflow JSON into a managed category subfolder.
  • Edit infos: override task, model family, provider, runtime, and notes.
  • Tags: attach searchable tags to workflow cards.
  • Duplicate workflow: create a copy in the managed root.
  • Delete workflow: delete the JSON and adjacent thumbnail files, subject to write/delete guards.

Write actions use Majoor's normal CSRF/auth checks, write-access guard, audit logging, and workflow write rate limit.

Thumbnails

A workflow can use:

  • an adjacent image thumbnail such as workflow.png, workflow.jpg, or workflow.webp
  • an adjacent animated thumbnail such as workflow.gif, workflow.webp, or workflow.mp4
  • a generated Graph Map SVG preview when no thumbnail exists
  • a linked output asset selected through Set workflow thumbnail

Linked thumbnail candidates are discovered from indexed assets with the same workflow_id or workflow hash. Video thumbnails are converted to a short animated WebP preview when supported.

You can also right-click a normal media asset and choose Use as workflow thumbnail to assign that asset to an existing workflow.

Search, Sort, And Grouping

The Workflow tab uses the standard grid search flow with workflow-specific metadata.

Search matches common workflow fields:

  • filename
  • display name
  • description
  • task
  • model family
  • provider
  • runtime
  • category/subfolder

Workflow-specific sort modes include:

  • default workflow order: favorites, recently loaded, usage, modified date, name
  • name
  • task
  • model family
  • usage count
  • last loaded

The grid can also group workflow cards by task, model family, or category depending on the configured workflow grouping setting.

Backend API Summary

The tab is powered by these Majoor routes:

Route Purpose
GET /mjr/am/list?scope=workflow List workflow cards
GET /mjr/am/workflows/content Read workflow JSON and prompt metadata
POST /mjr/am/workflows/save Save current/imported workflow JSON
POST /mjr/am/workflows/duplicate Duplicate a managed workflow
POST /mjr/am/workflows/move Rename or categorize a managed workflow
POST /mjr/am/workflows/delete Delete a managed workflow
POST /mjr/am/workflows/mark-loaded Update usage metadata after loading
POST /mjr/am/workflows/favorite Toggle favorite state
POST /mjr/am/workflows/tags Save workflow tags
POST /mjr/am/workflows/info Save manual workflow info and notes
GET /mjr/am/workflows/thumbnail-candidates Find linked output assets for thumbnails
POST /mjr/am/workflows/thumbnail/set Set or convert a workflow thumbnail
GET /mjr/am/workflows/thumbnail Serve a workflow thumbnail
GET /mjr/am/workflows/graph-map-thumbnail Serve generated Graph Map SVG preview

See API_REFERENCE.md for endpoint-level details.

Limitations

  • Only readable JSON workflows are listed.
  • Very large workflow files are skipped for safety.
  • Write actions are restricted to managed workflow paths.
  • Missing nodes and models depend on metadata present in the workflow JSON.
  • Loading relies on the ComfyUI frontend import capability available in the current host build.

Related Docs

Reference in New Issue View Git Blame Copy Permalink