Extensions/Comfyui_Prompt_Tag_Editor
ComfyUI Extension

Comfyui_Prompt_Tag_Editor

Comfyui提示词工具编辑和翻译节点

By kkmlimingfeng·Created about 21 hours ago·Updated about 20 hours ago· 1
kkmlimingfeng/Comfyui_Prompt_Tag_Editor
Nodes1
On cloudLocal install
CategoryPrompt Tools
Stars1
Updatedabout 20 hours ago

Nodes (1)

Prompt Tag Editor
Prompt Tools
Readme

ComfyUI Prompt Tag Editor

English | 中文

Interactive prompt/tag editor node for ComfyUI, with optional local translation powered by Tencent Hy-MT2-1.8B (GGUF via llama.cpp).

Built on the modern comfy_api.latest / ComfyExtension (V3) node API — requires a recent ComfyUI.

Features

  • Prompt textarea kept in sync with tag chips (comma-separated)
  • Tag chips with hover popup: adjust weight and delete without retyping
  • Double-click a chip to edit its text
  • Long-press drag (350 ms) to reorder tags
  • Translated tag chips with per-language cache; untranslated chips shown dashed
  • Auto-translate toggle: missing translations are filled automatically after edits
  • 8 target languages: Chinese / Japanese / Korean / English / French / German / Spanish / Russian
  • Lazy-loaded Hy-MT2-1.8B-Q4_K_M GGUF, full GPU offload (n_gpu_layers=-1), batched request with per-item fallback and translation cache

Outputs

| Output | Content | |---|---| | Prompt | Serialized prompt with weights, e.g. (white dress:1.2), long hair | | Translated Prompt | Comma-separated translations | | Tags JSON | Full tag list (text / translation / weight) as JSON |

Install

Via ComfyUI-Manager (recommended)

Custom Nodes Manager → search Prompt Tag Editor → Install.

Manual

cd ComfyUI/custom_nodes
git clone https://github.com/kkmlimingfeng/Comfyui_Prompt_Tag_Editor

Restart ComfyUI.

Translation model

The node works without the model; only the translate button needs it.

On first use, Hy-MT2-1.8B-Q4_K_M.gguf (~1.1 GB) is downloaded automatically to ComfyUI/models/text_translation/Hy-MT2-1.8B-GGUF/ — from Hugging Face, with hf-mirror.com as a fallback. The editor status line shows download progress while it runs.

Manual placement also works — put the GGUF here (any *.gguf in that folder is accepted, Q4_K_M preferred):

ComfyUI/
  models/
    text_translation/
      Hy-MT2-1.8B-GGUF/
        Hy-MT2-1.8B-Q4_K_M.gguf

requirements.txt intentionally lists no hard dependency: llama-cpp-python is imported lazily so the editor works even without it.

GPU offload needs a CUDA-enabled llama-cpp-python build. Recommended: grab a prebuilt wheel matching your CUDA toolkit (cu124 / cu128 / ...) and Python version (cp310 / cp311 / cp312 / ...) from https://github.com/JamePeng/llama-cpp-python/releases, then:

pip install llama_cpp_python-<version>+cu128-cp312-cp312-win_amd64.whl

Alternatives:

# CUDA build via the official wheel index
pip install llama-cpp-python --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cu128

# CPU-only build (works everywhere, slower)
pip install llama-cpp-python

Usage

  1. Add the node from Prompt Tools → Prompt Tag Editor (or type prompt directly).
  2. Edit tags as chips; type in the textarea to add tags.
  3. Hover a chip → popup with title / weight / delete.
  4. Toggle 自动 (auto) to translate automatically after edits, or press the ↻ button.
  5. Connect the outputs to downstream nodes.

License

MIT