ComfyUI-KSTR-Nodes

ComfyUI-KSTR-Nodes

ComfyUI에서 쓰는 간단한 유틸 노드 모음입니다.

설치

custom_nodes/ComfyUI-KSTR-Nodes에 넣고 ComfyUI를 재시작하면 됩니다.

로컬 프롬프트 모델 사용

Korean Image Prompt (Local LLM) 노드는 별도 LLM 의존성이 필요합니다.

cd custom_nodes/ComfyUI-KSTR-Nodes
pip install -r requirements-llm.txt

기본 모델은 Apache-2.0 라이선스의 Qwen/Qwen3-1.7B입니다. 환경변수를 지정하지 않으면 최초 실행 시 Hugging Face에서 이 모델을 내려받습니다.

모델은 KSTR_PROMPT_MODEL 환경변수로 바꿀 수 있습니다. Hugging Face 모델 ID와 로컬 디렉터리를 모두 사용할 수 있습니다.

export KSTR_PROMPT_MODEL=/models/your-prompt-model

EXAONE을 사용하려면 사용자가 직접 지정할 수 있습니다.

export KSTR_PROMPT_MODEL=LGAI-EXAONE/EXAONE-3.5-2.4B-Instruct

EXAONE은 코드와 별개의 비상업용 모델 라이선스를 사용하며 출력물 사용에도 제한이 있으므로, 사용 전에 해당 모델 라이선스를 직접 확인해야 합니다.

노드 목록

| Node | 용도 | 핵심 입력 | 출력 | | --- | --- | --- | --- | | Normalize Comma Prompt | 쉼표 기준 프롬프트 공백 정리 | prompt | 정리된 STRING | | Text Concatenate (Dynamic) | 연결한 문자열 슬롯을 순서대로 결합 | text_1..., separator, 공백/빈 값 옵션 | 결합된 STRING | | CLIP Text Encode (Advanced, KSTR) | A1111 계열 토큰 정규화와 가중치 해석 | text, clip, token_normalization, weight_interpretation | CONDITIONING | | Korean Image Prompt (Local LLM) | 한국어 자연어를 로컬 소형 LLM으로 이미지 프롬프트화 | description, prompt_format, creativity | positive / negative STRING | | LoRA Ratio Stacker | LORA_STACK 비율을 지정 합계 강도로 재분배 | lora_stack, total_strength, ratio_source | 재계산된 LORA_STACK, applied_ratios | | Image to WEBP | IMAGE 배치를 WEBP로 변환 | image, quality, method, lossless, 메타데이터 옵션 | WEBP | | Send WEBP to Telegram | WEBP를 Telegram Bot API로 전송 | webp, bot_token, chat_id, caption, send_as_document | 원본 WEBP, 응답 문자열 | | POST WEBP to Immich | WEBP를 Immich /api/assets로 업로드 | webp, api_url, api_key, device_id | 원본 WEBP, 응답 문자열 | | KR 카메라 컨트롤 | 3D 카메라 방위·높이·거리·롤을 시각적으로 조절해 프롬프트 생성 | pos_x, pos_y, pos_z, roll, preset_index | 카메라 프롬프트 STRING |

사용 예시

Normalize Comma Prompt

입력:

masterpiece, 1girl , blue hair,  smile

출력:

masterpiece, 1girl, blue hair, smile

Text Concatenate (Dynamic)

처음에는 text_1, text_2 두 입력 슬롯이 표시됩니다. 마지막 슬롯에 문자열을 연결하면 다음 슬롯이 자동으로 추가되고, 뒤쪽 연결을 제거하면 사용하지 않는 슬롯이 정리됩니다. 최대 64개까지 연결할 수 있습니다.

예:

text_1 = masterpiece
text_2 = 1girl
text_3 = blue hair
separator = , 
strip_inputs = true
skip_empty = true

출력:

masterpiece, 1girl, blue hair

• separator: 각 문자열 사이에 넣을 문자
• strip_inputs: 각 입력의 앞뒤 공백 제거
• skip_empty: 빈 입력을 결과에서 제외

CLIP Text Encode (Advanced, KSTR)

CLIP Text Encode (Advanced)와 같은 형태로 사용합니다.

token_normalization = none / mean / length / length+mean
weight_interpretation = comfy / A1111 / compel / comfy++ / down_weight

Anima의 qwen3_06b / t5xxl 토큰 구조를 감지해 l 키를 강제하지 않으며, t5xxl_ids와 t5xxl_weights가 포함된 네이티브 conditioning을 유지합니다.

Korean Image Prompt (Local LLM)

입력:

비 오는 밤 골목에서 검은 교복을 입은 여학생이 우산을 들고 뒤돌아본다.
네온사인이 젖은 바닥에 반사되고 약간 불안한 분위기다.

주요 옵션:

• prompt_format: anime_tags, natural_language, hybrid
• creativity: strict, balanced, creative
• keep_model_loaded: 다음 실행을 위해 모델을 VRAM에 유지할지 선택
• style_prefix: 반드시 반영할 스타일 또는 접두 프롬프트
• negative_hint: 사용자가 직접 지정할 네거티브 힌트

출력 예:

positive_prompt:
1girl, black school uniform, holding umbrella, looking back, rainy night,
narrow alley, neon signs, wet pavement, neon reflections, uneasy atmosphere

negative_prompt:
low detail, visual artifacts, text, watermark

<lora:name:0.8>, (tag:1.2), [tag:0.8], __wildcard__, {red|blue} 형식은 변환 중 보호한 뒤 원문 그대로 복원합니다.

LoRA Ratio Stacker

입력:

Lora Stacker (LoraManager)
- A strength = 5
- B strength = 3
- C strength = 2

LoRA Ratio Stacker
- total_strength = 1.2
- ratio_source = model strength

출력:

A = 0.60
B = 0.36
C = 0.24
합계 = 1.20

연결:

Lora Stacker (LoraManager)
        ↓
LoRA Ratio Stacker
        ↓
Lora Loader (LoraManager)

KR 카메라 컨트롤

KR Tools/카메라 > KR 카메라 컨트롤에서 추가합니다. 좌드래그로 방위/높이, 우드래그로 3D 미리보기 시점, 휠로 거리, Shift+휠로 롤을 조절할 수 있습니다. preset_index에 Random Int를 연결하면 저장된 프리셋 목록에서 실행마다 선택할 수 있습니다.

이 노드는 ComfyUI_bsk_UI의 카메라 프롬프트 알고리즘과 인터랙션 디자인을 바탕으로 한 ComfyUI-KR-Camera-Control 파생 코드이며, 해당 파일(camera_control.py, web/camera_control.js)은 원 저작자 표기를 유지하고 AGPL-3.0-or-later 조건을 따릅니다.

Image to WEBP

예:

VAE Decode / Load Image
        ↓
Image to WEBP

- quality = 95
- method = 6
- lossless = false
- embed_metadata = true
- filename_prefix = comfyui

출력된 WEBP는 아래 Telegram / Immich 노드에 바로 연결하면 됩니다.

embed_metadata가 켜져 있으면 prompt / workflow / 커스텀 메타데이터를 ComfyUI가 PNG에 쓰는 것과 동일한 방식(EXIF)으로 WEBP에 심습니다. Immich에 업로드한 뒤 원본을 다시 받아 ComfyUI에 드래그해도 워크플로우가 복원됩니다.

Send WEBP to Telegram

연결:

Image to WEBP
        ↓
Send WEBP to Telegram

예시 입력:

bot_token = YOUR_TELEGRAM_BOT_TOKEN
chat_id = YOUR_CHAT_ID
caption = render sample
send_as_document = true

POST WEBP to Immich

연결:

Image to WEBP
        ↓
POST WEBP to Immich

예시 입력:

api_url = http://127.0.0.1:2283/api/assets
api_key = YOUR_IMMICH_API_KEY
device_id = comfyui-kstr
filename_prefix_override = render
is_favorite = false

각 WEBP는 Immich assetData로 업로드되고, deviceAssetId, fileCreatedAt, fileModifiedAt는 노드가 자동으로 채웁니다.