Skip to main content

​
LoRA Manager

Curated catalog of local LoRA files with metadata agents and users need to apply them correctly.

​
Storage

Per ComfyUI instance (slug from getInstanceSlug()): Overrides for tests: COMFYUI_MCP_LORA_CATALOG, COMFYUI_MCP_LORA_PREVIEWS.

​
Catalog entry fields

  • relPath — ComfyUI-relative path under models/ (e.g. loras/style/foo.safetensors)
  • displayName, description, setupInstructions
  • keywords, negativeKeywords — trigger / avoid tokens
  • baseModels, strengthMin / strengthMax / strengthDefault
  • previewFile — filename under lora-previews/
  • sourceUrl, CivitAI ids, tags, notes
  • missing — set by sync when file no longer on disk

​
ComfyUI LoRA Manager integration (willmiao)

ComfyUI LoRA Manager stores rich Civitai metadata in .metadata.json sidecars beside each LoRA (trigger words, usage_tips strength/clip_skip, previews, tags). It also provides a /loras web UI and a Civitai browser extension for one-click downloads when a Civitai API key is set in LoRA Manager settings. comfyui-mcp does not replace LoRA Manager — it imports sidecar data into the agent catalog so orchestrator/panel tools share the same trigger words and strength hints. Recommended flow when LoRA Manager is installed:
  1. lora_catalog_sync — ensure every on-disk LoRA has a catalog stub
  2. lora_catalog_import_sidecars — pull Civitai + usage_tips from sidecars (fast, no API calls)
  3. lora_catalog_enrich_civitai — only for LoRAs missing sidecars or hash-only matches

​
MCP tools (headless comfyui server)

​
Panel bridge commands

Panel tools: panel_open_lora_manager, panel_pick_lora. If the panel does not implement pick_lora, the orchestrator falls back to ask_user with text options (no previews).

​
Panel UI follow-up (comfyui-mcp-panel)

  1. Handle open_lora_manager — modal/sidebar with grid (preview, name, keywords, setup blurb).
  2. Handle pick_lora — same UI in selection mode; return { picked: summary | summaries[] }.
  3. Optional: let users edit metadata in UI → call lora_catalog_upsert via agent or direct API later.