weilin9999/WeiLin-Comfyui-Tools

WeiLin‑ComfyUI‑Tools – a tag‑manager extension for ComfyUI

What it does

• Adds a 120 × 120 thumbnail preview to every tag card in ComfyUI’s Tag Manager.
• Uses ComfyUI’s internal queue API to generate those preview images on‑demand (single tag, re‑generate, or batch‑generate an entire group).
• Shows a larger version of the thumbnail in a floating window when you hover over it, and lets you cancel all pending jobs.
• All generation parameters (model, size, sampler, steps, CFG, seed, positive/negative prompts) are saved locally so you don’t have to re‑enter them each time.

How it works

1. Frontend – Vue components (GenerateImageDialog.vue, BatchGenerateDialog.vue) let you configure generation settings and launch jobs.
2. Backend – New API routes (/tag_image/*) accept generation requests, place them in an async queue (tag_image_queue.py), and drive a ComfyUI workflow (comfyui_workflow.py).
3. Queue – A single‑worker queue processes jobs sequentially, polling ComfyUI for results, downloading the output image, and storing both the full‑size image and a 120 × 120 WebP thumbnail under user_data/tag_images/ and user_data/tag_thumbs/.
4. Database – The tag_tags table now includes image_path and image_status columns so the UI can show the current thumbnail state.
5. Recovery – If you refresh the page, the UI queries /tag_image/status/{t_uuid} to restore the queue state.

Key features

• Single‑tag generation – Click a tag’s empty thumbnail, set parameters, and generate.
• Regeneration – Hover an existing thumbnail, click the refresh icon, adjust settings, and replace the image.
• Batch generation – One‑click generation for all tags in a group with a live progress bar.
• Cancel all – Abort every queued or running task.
• Persistent settings – Generation options are auto‑saved locally.
• Floating preview – Hover for 200 ms to see the full‑size image.

Who might use it Artists and prompt engineers who organise large collections of tags in ComfyUI and want a quick visual cue for each tag without leaving the UI.

Installation notes

• The plugin is still in internal testing; the author recommends joining the official QQ group (ID 905656521) for support and updates.
• It works with the standard ComfyUI directory layout (models in models/checkpoints).
• A companion panel repository (WeiLin‑Comfyui‑Tools‑panel) helps migrate prompts from older versions.

Roadmap / community

• Ongoing bug fixes (typically 2‑5 releases per month).
• Open‑source prompt and Danbooru tag databases are hosted in a separate repo (WeiLin‑Comfyui‑Tools‑Prompt).
• Users can submit issues or feature requests directly on GitHub.

---

All details above are taken directly from the repository’s README; no additional speculation is added.