Extensions/ComfyUI-Korean-Prompt-Engineer-with-LLM
ComfyUI Extension

ComfyUI-Korean-Prompt-Engineer-with-LLM

이 노드는 여러분이 한국어로 상상하는 모든 것을 멋진 이미지로 만들어 줄 수 있도록 도와주는 도구입니다. 코딩이나 복잡한 설정 없이도, 마치 전문가처럼 상세하고 멋진 영어 프롬프트를 자동으로 만들어줍니다.

By TheGarura·Created 10 months ago·Updated 10 months ago· 0
TheGarura/ComfyUI-Korean-Prompt-Engineer-with-LLM
Nodes—
On cloudLocal install
Stars0
Updated10 months ago
Readme

🌟 ComfyUI 한국어 프롬프트 엔지니어 (Korean Prompt Engineer with LLM)

안녕하세요! ComfyUI를 사용하시는 여러분을 위한 특별한 노드를 소개합니다. 이 노드는 여러분이 한국어로 상상하는 모든 것을 멋진 이미지로 만들어 줄 수 있도록 도와주는 도구입니다. 코딩이나 복잡한 설정 없이도, 마치 전문가처럼 상세하고 멋진 영어 프롬프트를 자동으로 만들어줍니다.

어떤 분들에게 좋을까요?

  • ComfyUI를 처음 사용하시거나, 프롬프트 작성이 어려우신 분
  • 한국어로 편하게 아이디어를 입력하고 싶으신 분
  • 전문적인 사진/영상 기법을 프롬프트에 쉽게 적용하고 싶으신 분
  • 다양한 AI 모델(Stable Diffusion 등)에 최적화된 프롬프트를 원하시는 분

이 노드는 여러분의 창의력을 최대한 발휘할 수 있도록 도와줄 것입니다!

버전 라이선스 개발자

🚀 주요 기능 (이 노드가 할 수 있는 일)

  • 한국어로 편하게 입력: 여러분이 생각하는 이미지 아이디어를 한국어로 자유롭게 입력하세요. 이 노드가 알아서 전문적인 영어 프롬프트로 번역하고 확장해줍니다.
  • 다양한 AI 언어 모델(LLM) 지원: OpenAI (GPT), Anthropic (Claude), Google (Gemini), Ollama 등 여러 인공지능 언어 모델 중에서 원하는 것을 선택하여 프롬프트를 만들 수 있습니다. 마치 여러 명의 똑똑한 비서 중에서 한 명을 고르는 것과 같아요!
  • 전문가처럼 상세한 옵션: 카메라 앵글, 렌즈, 조명, 색감, 구도 등 전문 사진작가나 영상 감독이 사용하는 기법들을 메뉴에서 쉽게 선택할 수 있습니다. 복잡한 용어를 몰라도 멋진 효과를 낼 수 있습니다.
  • 자동으로 나쁜 프롬프트 제거: 이미지 품질을 떨어뜨릴 수 있는 요소들(예: 흐릿함, 깨진 이미지)을 자동으로 걸러주는 '네거티브 프롬프트'를 만들어줍니다. 여러분은 좋은 이미지를 만드는 데만 집중하세요!
  • 나만의 스타일 추가: custom_instructions라는 곳에 여러분만의 특별한 지시사항(예: 특정 화풍, 분위기)을 영어로 추가하여 프롬프트 생성에 반영할 수 있습니다.

🛠 설치 방법 (노드를 ComfyUI에 추가하기)

이 노드를 여러분의 ComfyUI에서 사용하려면 두 가지 방법이 있습니다. 코딩을 몰라도 괜찮아요! 가장 쉬운 방법부터 확인해보세요.

📦 방법 1: ComfyUI Manager를 사용한 설치 (⭐ 가장 쉬운 방법)

ComfyUI Manager는 마치 스마트폰의 '앱 스토어'처럼, ComfyUI 노드들을 쉽게 설치하고 관리할 수 있는 도구입니다. 복잡한 명령어를 입력할 필요 없이 클릭만으로 설치할 수 있습니다!

1단계: ComfyUI Manager 설치하기

먼저 ComfyUI Manager가 설치되어 있는지 확인해야 합니다.

ComfyUI Manager가 이미 설치되어 있는지 확인하는 방법:

  • ComfyUI 웹 화면 오른쪽 상단을 보세요. 🔧 "Manager" 라는 버튼이 보이면 이미 설치되어 있습니다!
  • 만약 버튼이 없다면, 아래 단계를 따라 설치해주세요.

ComfyUI Manager를 설치하지 않았다면:

  1. ComfyUI 설치 폴더를 엽니다. (보통 C:\ComfyUI 또는 ~/ComfyUI)

  2. 그 안에 custom_nodes 폴더를 찾아 엽니다.

  3. custom_nodes 폴더 안의 빈 공간에서 마우스 오른쪽 버튼을 클릭합니다.

  4. "여기서 터미널 열기" 또는 "PowerShell 여기서 열기" (Windows) / "터미널에서 폴더 열기" (macOS)를 선택합니다.

  5. 터미널(검은색 창)이 열리면 다음 명령어를 복사해서 붙여넣고 Enter 키를 누르세요:

    git clone https://github.com/ltdrdata/ComfyUI-Manager.git

  6. 설치가 완료되면 ComfyUI를 완전히 종료했다가 다시 실행합니다.

  7. ComfyUI가 다시 열리면 오른쪽 상단에 🔧 "Manager" 버튼이 보일 것입니다!

2단계: Manager를 통해 한국어 프롬프트 엔지니어 설치하기

가장 간단한 방법입니다. 정말 쉬워요!

  1. ComfyUI 웹 화면 오른쪽 상단의 🔧 "Manager" 버튼을 클릭합니다.
  2. 팝업 창이 열리면 "Install via Git URL" (Git URL로 설치)를 찾아 클릭합니다.
    • 또는 위의 검색 아이콘(🔍)을 클릭하고 **"Korean Prompt Engineer"**를 검색할 수도 있습니다.
  3. 만약 검색으로 찾는 경우:
    • 검색창에 "Korean Prompt Engineer" 또는 **"korean"**을 입력합니다.
    • 결과에서 **"ComfyUI-Korean-Prompt-Engineer-with-LLM"**을 찾아 클릭합니다.
    • "Install" (설치) 버튼을 클릭합니다.
  4. "Git URL로 설치" 방법을 선택했다면:
    • 다음 주소를 복사하여 입력 창에 붙여넣습니다: 
      https://github.com/TheGarura/ComfyUI-Korean-Prompt-Engineer-with-LLM.git
    • "Install" 버튼을 클릭합니다.
  5. 설치가 진행되고 완료 메시지가 나타나면 "Restart" (재시작) 버튼을 클릭합니다.
  6. 완료! 이제 노드를 사용할 수 있습니다. 🎉

3단계: 한국어 프롬프트 엔지니어 업데이트하기

새로운 기능이나 버그 수정이 있으면 업데이트할 수 있습니다.

  1. ComfyUI 웹 화면 오른쪽 상단의 🔧 "Manager" 버튼을 클릭합니다.
  2. "Update All" (모두 업데이트) 버튼을 클릭하면 설치된 모든 노드가 최신 버전으로 업데이트됩니다.
  3. 또는 "Installed Custom Nodes" (설치된 커스텀 노드)를 선택하여 **"ComfyUI-Korean-Prompt-Engineer-with-LLM"**을 찾은 후, 그 옆의 "Update" (업데이트) 버튼을 클릭합니다.
  4. 업데이트가 완료되면 ComfyUI를 재시작합니다.

💻 방법 2: 터미널 명령어를 사용한 수동 설치 (기술자용)

코딩에 이미 익숙하신 분이라면 이 방법도 좋습니다.

설치 단계

  1. ComfyUI 설치 폴더 찾기:

    • 먼저, 여러분의 컴퓨터에 ComfyUI가 어디에 설치되어 있는지 알아야 합니다.
    • 보통 C:\ComfyUI (Windows) 또는 ~/ComfyUI (macOS/Linux)와 같은 곳에 있습니다.
    • 이 폴더 안에 custom_nodes라는 이름의 폴더가 있을 거예요. 이 폴더가 우리가 노드를 설치할 곳입니다.

  2. 터미널(명령 프롬프트) 열기:

    • Windows: 시작 메뉴에서 cmd 또는 PowerShell을 검색하여 실행합니다.
    • macOS/Linux: 터미널 앱을 실행합니다.
    • 터미널은 컴퓨터에 명령을 내리는 검은색(또는 흰색) 창입니다.

  3. custom_nodes 폴더로 이동하기:

    • 터미널에 다음 명령어를 입력하고 Enter 키를 누르세요.
    • 주의: /path/to/ComfyUI 부분은 여러분의 실제 ComfyUI 설치 경로로 바꿔야 합니다.
    cd /path/to/ComfyUI/custom_nodes
    • 예시: 만약 ComfyUI가 C:\Users\YourName\ComfyUI에 있다면, cd C:\Users\YourName\ComfyUI\custom_nodes라고 입력합니다.

  4. 노드 파일 다운로드 (복제):

    • 이제 custom_nodes 폴더 안에서 다음 명령어를 입력하고 Enter 키를 누르세요.
    git clone https://github.com/TheGarura/ComfyUI-Korean-Prompt-Engineer-with-LLM.git
    • 이 명령어는 인터넷에서 이 노드의 모든 파일을 여러분의 컴퓨터로 가져와 ComfyUI-Korean-Prompt-Engineer-with-LLM이라는 새 폴더를 만듭니다.

  5. 새로 생긴 노드 폴더로 이동:

    • 다운로드한 노드 폴더 안으로 들어가야 합니다. 다음 명령어를 입력하고 Enter 키를 누르세요.
    cd ComfyUI-Korean-Prompt-Engineer-with-LLM

  6. 필요한 도구들 설치:

    • 이 노드가 작동하려면 몇 가지 추가적인 프로그램(Python 패키지)이 필요합니다. 다음 명령어를 입력하고 Enter 키를 누르세요.
    pip install -r requirements.txt
    • 이 과정은 인터넷 연결이 필요하며, 잠시 시간이 걸릴 수 있습니다. 화면에 여러 메시지가 나타나도 걱정하지 마세요.

  7. ComfyUI 재시작:

    • 모든 설치가 끝났습니다! 이제 ComfyUI 프로그램을 완전히 껐다가 다시 실행해주세요. 그래야 새로 설치된 노드를 ComfyUI가 인식하고 사용할 수 있습니다.

수동 설치의 업데이트 방법

  1. ComfyUI 종료: 먼저 ComfyUI 프로그램을 완전히 종료해주세요.

  2. 노드 디렉토리로 이동: 터미널(명령 프롬프트)을 열고, 이 노드가 설치된 디렉토리로 이동합니다.

    cd /path/to/ComfyUI/custom_nodes/ComfyUI-Korean-Prompt-Engineer-with-LLM

  3. 최신 버전 다운로드: 다음 명령어를 입력하여 최신 변경사항을 다운로드합니다.

    git pull

    이 명령어는 인터넷에서 최신 코드를 가져와 현재 설치된 노드를 업데이트해줍니다.

  4. ComfyUI 재시작: 업데이트가 완료되면 ComfyUI를 다시 시작하여 변경사항을 적용합니다.

📁 프로젝트 구조

프로젝트의 주요 디렉토리 및 파일 구조는 다음과 같습니다.

ComfyUI-Korean-Prompt-Engineer-with-LLM/
├── __init__.py             # ComfyUI 노드 등록 및 초기화
├── .env.example            # 환경 변수 설정 예시 파일
├── .gitignore              # Git 버전 관리 제외 파일
├── cache_manager.py        # 캐시 관리 로직
├── exceptions.py           # 사용자 정의 예외 처리
├── LICENSE                 # MIT 라이선스 정보
├── llm_manager.py          # LLM 프로바이더 관리 및 호출
├── logger.py               # 로깅 설정
├── nodes.py                # ComfyUI 커스텀 노드 정의
├── presets.py              # 프롬프트 생성에 사용되는 사전 설정 데이터
├── prompt_engineer.py      # 핵심 프롬프트 생성 로직
├── README.md               # 프로젝트 설명 (현재 파일)
├── requirements.txt        # Python 의존성 목록
├── templates.py            # 프롬프트 템플릿 정의
├── utils.py                # 유틸리티 함수 모음
└── llm_providers/          # LLM 프로바이더 모듈
    ├── __init__.py         # 프로바이더 패키지 초기화
    ├── base.py             # 기본 프로바이더 인터페이스
    ├── claude_provider.py  # Anthropic Claude 프로바이더 구현
    ├── gemini_provider.py  # Google Gemini 프로바이더 구현
    ├── ollama_provider.py  # Ollama 프로바이더 구현
    └── openai_provider.py  # OpenAI 프로바이더 구현

⚙️ 초기 설정: AI 언어 모델(LLM) 연결하기 (API 키 설정)

이 노드는 여러분이 입력한 한국어 프롬프트를 영어로 번역하고 확장하기 위해 인공지능 언어 모델(LLM)의 도움을 받습니다. 따라서, 여러분이 사용하고 싶은 LLM 서비스(예: OpenAI, Google Gemini 등)의 API 키를 설정해주어야 합니다. API 키는 해당 서비스에 접근할 수 있는 비밀번호와 같습니다.

1단계: .env 파일 만들기

이 노드 폴더 안에 .env.example이라는 파일이 있습니다. 이 파일을 복사해서 **.env**라는 이름으로 바꿔주세요. (파일 확장자가 없는 파일입니다.)

Windows 사용자:

  • 파일 탐색기를 열고 노드가 설치된 폴더(ComfyUI-Korean-Prompt-Engineer-with-LLM)를 찾습니다.
  • .env.example 파일을 마우스 오른쪽 버튼으로 클릭하고 **"복사"**를 선택합니다.
  • 같은 폴더의 빈 공간에서 마우스 오른쪽 버튼을 클릭하고 **"붙여넣기"**를 선택합니다.
  • 생성된 파일 이름을 .env.example - 복사본에서 .env로 바꿉니다.

macOS/Linux 사용자:

  • 터미널을 열고 노드가 설치된 폴더로 이동합니다.
  • 다음 명령어를 입력하고 Enter 키를 누르세요: 
    cp .env.example .env

.env 파일은 여러분의 API 키와 같은 중요한 정보를 안전하게 보관하는 역할을 합니다.

2단계: API 키와 모델 이름 입력하기

이제 방금 만든 .env 파일을 메모장(Windows)이나 텍스트 편집기(macOS) 등으로 열어주세요.

파일 안에는 다음과 같은 내용이 보일 것입니다.

# OpenAI (ChatGPT 개발사)
# OPENAI_API_KEY=""
# OPENAI_MODEL_NAME="gpt-4-turbo"

# Anthropic (Claude 개발사)
# ANTHROPIC_API_KEY=""
# ANTHROPIC_MODEL_NAME="claude-3-opus-20240229"

# Google (Gemini 개발사)
# GEMINI_API_KEY=""
# GEMINI_MODEL_NAME="gemini-1.5-flash"

# Ollama (로컬에서 AI 모델 실행)
# OLLAMA_BASE_URL="http://localhost:11434"
# OLLAMA_MODEL_NAME="llama3"

여러분은 이 중에서 사용하고 싶은 LLM 서비스의 줄에 있는 # (주석)을 지우고, "" 안에 여러분의 API 키와 모델 이름을 입력해야 합니다.

예시: OpenAI를 사용하고 싶다면

  • OpenAI 웹사이트(https://platform.openai.com)에 가입하고 API 키를 발급받으세요. (보통 sk-...로 시작합니다.)
  • .env 파일을 다음과 같이 수정합니다: 
    OPENAI_API_KEY="sk-여러분의_OPENAI_API_키를_여기에_붙여넣으세요"
OPENAI_MODEL_NAME="gpt-4-turbo" # 또는 gpt-3.5-turbo 등, 사용하고 싶은 모델 이름

다른 LLM 서비스도 마찬가지입니다:

  • Anthropic (Claude): https://console.anthropic.com
  • Google (Gemini): https://makersuite.google.com/app/apikey
  • Ollama: 로컬에 설치한 후 사용 (별도의 API 키 불필요)

중요한 주의사항:

  • 사용하지 않는 서비스는 #을 그대로 두거나 줄을 지워도 됩니다.
  • 최소한 하나 이상의 서비스 API 키를 정확히 입력해야 노드가 작동합니다.
  • API 키는 절대 공개하지 마세요! 깃허브에 올리거나 다른 사람에게 보여주면 안 됩니다.

3단계: 파일 저장

.env 파일을 수정한 후 반드시 저장해주세요!

🚀 ComfyUI에서 노드 사용하기 (워크플로우에 추가하고 설정하기)

이제 ComfyUI에서 이 노드를 실제로 사용하는 방법을 알아볼까요? 아주 쉽습니다!

1단계: 노드 추가하기

  • ComfyUI 작업 화면의 빈 공간에서 마우스 오른쪽 버튼을 클릭하세요.
  • 메뉴가 나타나면 Add Node (노드 추가)를 선택합니다.
  • 그다음 conditioning → prompt를 선택하고, 마지막으로 Korean Prompt Engineer 🇰🇷를 클릭하여 노드를 추가합니다.
  • (화면에 새로운 노드 상자가 나타날 거예요!)

2단계: 입력값 설정하기 (노드에 정보 주기)

추가된 Korean Prompt Engineer 🇰🇷 노드를 보면 여러 가지 설정할 수 있는 부분이 있습니다.

주요 입력 항목들:

  • 한국어 프롬프트: 여기에 여러분이 만들고 싶은 이미지에 대한 아이디어를 한국어로 자유롭게 적어주세요. 예: 미래 도시의 밤거리를 걷는 사이버펑크 고양이
  • LLM 프로바이더: 드롭다운 메뉴를 클릭하여 .env 파일에 설정했던 AI 언어 모델(예: openai, anthropic, gemini, ollama) 중 하나를 선택합니다.
  • 각종 옵션 (카메라 앵글, 조명 설정 등): 원하는 이미지의 스타일과 분위기에 맞춰 드롭다운 메뉴에서 다양한 사진/영상 기법을 선택하세요. 어떤 옵션을 선택하느냐에 따라 이미지가 크게 달라질 수 있습니다!
  • 사용자 정의 지침 (영문): 만약 프롬프트에 꼭 포함하고 싶은 특별한 지시사항이 있다면, 여기에 영어로 작성합니다. 예: in the style of Blade Runner 2049
  • 사용자 정의 부정 프롬프트 (한국어 또는 영어): 이미지에서 피하고 싶은 요소들을 직접 입력할 수 있습니다. 한국어로 입력하면 LLM이 영어로 번역해주고, 영어로 입력하면 그대로 사용됩니다. 이 필드를 비워두면 네거티브 프롬프트 스타일에 따라 자동으로 부정 프롬프트가 생성됩니다.

3단계: 출력 연결하기 (다른 노드와 연결)

이 노드는 두 가지 중요한 결과(positive_text와 negative_text)를 만들어냅니다. 이 결과들을 다른 노드에 연결해야 이미지를 생성할 수 있습니다.

  • positive_text: 이 노드의 positive_text 출력 부분을 마우스로 드래그하여, 보통 CLIP Text Encode 노드의 text 입력 부분에 연결합니다. (이것이 여러분이 원하는 이미지를 만드는 데 사용될 긍정적인 프롬프트입니다.)
  • negative_text: 이 노드의 negative_text 출력 부분도 마찬가지로 다른 CLIP Text Encode 노드의 text 입력 부분에 연결합니다. (이것은 이미지에서 피하고 싶은 요소들을 알려주는 부정적인 프롬프트입니다.)

🎨 노드 파라미터 상세 설명 (각 설정의 의미)

| 파라미터명 | 설명 (무엇을 설정하는 건가요?) | 선택 옵션 (예시) | | -------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 한국어 프롬프트 | 여러분이 만들고 싶은 이미지의 핵심 아이디어를 한국어로 입력하는 곳입니다. | (자유롭게 입력) | | LLM 프로바이더 | 프롬프트 번역 및 확장에 사용할 인공지능 언어 모델을 선택합니다. .env 파일에 설정한 이름과 같아야 해요. | openai, anthropic, gemini, ollama (드롭다운 메뉴에서 선택) | | 카메라 앵글 | 이미지를 어떤 각도에서 찍을지 결정합니다. | 정면 (front-facing), 3/4 각도 (three-quarter view), 측면 (side profile), 오버헤드 (top-down), 로우 앵글 (looking upward), 더치 앵글 (diagonal horizon) | | 카메라 렌즈 | 어떤 종류의 카메라 렌즈로 찍은 듯한 효과를 낼지 선택합니다. | 24mm (초광각) (ultra-wide), 35mm (광각) (standard-wide), 50mm (표준) (standard prime), 85mm (망원) (telephoto prime), 135mm (장망원) (telephoto), 매크로 (접사) (extreme close-up) | | 조명 설정 | 이미지의 전체적인 조명 분위기를 결정합니다. | 스튜디오 조명 (professional studio lighting), 시네마틱 조명 (dramatic shadows), 자연광 (soft diffused daylight), 골든 아워 (sunset/sunrise), 역광 (silhouette effect), 림 라이팅 (edge highlighting), 키아로스쿠로 (strong contrast), 네온 조명 (cyberpunk atmosphere) | | 무드/분위기 | 이미지의 전체적인 감성이나 분위기를 설정합니다. | 극적인 (strong emotions), 음울한 (dark, mysterious), 밝고 쾌활한 (hopeful, vibrant), 멜랑콜리한 (sentimental, bittersweet), 신비로운 (enigmatic, unexplained), 낭만적인 (love, warm feelings), 디스토피아적인 (bleak, futuristic pessimism), 영묘한 (otherworldly, dreamlike) | | 색감 보정 | 이미지의 색상 스타일을 조절합니다. | 생생한 (saturated hues), 채도 낮은 (reduced color intensity), 따뜻한 톤 (golden, orange tint), 차가운 톤 (blueish hue), 흑백 (black and white), 듀오톤 (two color grading), 시네마틱 색감 (film-like appearance) | | 구도 | 이미지의 구성 방식을 결정합니다. | 중앙 구도 (focal point in middle), 삼분할 구도 (balanced proportions), 리딩 라인 (guiding the eye), 깊이 레이어 (foreground/background separation), 대칭 구도 (balanced elements), 대각선 구도 (dynamic movement) | | 화질 설정 | 이미지의 품질과 관련된 키워드를 추가합니다. | 초고화질 (highest resolution), 고품질 (optimized performance), 전문적인 (commercial finish), 시네마틱 품질 (film aesthetics) | | 네거티브 프롬프트 스타일 | 이미지에서 피하고 싶은 요소들을 어떤 방식으로 제거할지 선택합니다. | 표준 (저품질, 아티팩트 제거), 엄격한 (자연스러운 외관 강조), 최소한의 (주요 결함에만 집중) | | 창의성 (Temperature) | LLM이 프롬프트를 얼마나 자유롭고 다양하게 만들지 조절합니다. 숫자가 높을수록 더 창의적입니다. | 0.0 ~ 2.0 사이의 숫자 | | 최대 토큰 수 | 생성될 영어 프롬프트의 최대 길이를 제한합니다. | 100 ~ 2000 사이의 숫자 | | 사용자 정의 지침 (영문) | 여러분이 LLM에게 주고 싶은 특별한 추가 지시사항을 영어로 작성합니다. | (자유롭게 입력) | | 사용자 정의 부정 프롬프트 (한국어 또는 영어) | 이미지에서 피하고 싶은 요소들을 직접 입력할 수 있습니다. 한국어로 입력하면 LLM이 영어로 번역해주고, 영어로 입력하면 그대로 사용됩니다. 이 필드를 비워두면 네거티브 프롬프트 스타일에 따라 자동으로 부정 프롬프트가 생성됩니다. | (자유롭게 입력) |

❓ 문의하기 (궁금한 점이 있다면)

노드를 사용하시다가 궁금한 점이나 문제가 발생하면 언제든지 개발자에게 문의해주세요! 여러분의 피드백은 이 노드를 더 좋게 만드는 데 큰 도움이 됩니다.

문의하실 때 다음 정보를 함께 알려주시면 더 빠르게 도와드릴 수 있습니다:

  • 사용 중인 ComfyUI 버전: (예: ComfyUI 2024-01-01 버전)
  • 운영체제: (예: Windows 10, macOS Sonoma, Ubuntu 22.04)
  • 문제 발생 시점: (예: 노드 설치 중, .env 파일 설정 후, 노드 실행 시)
  • 발생한 오류 메시지: (터미널이나 ComfyUI 화면에 나타난 오류 메시지를 그대로 복사해서 붙여넣어 주세요. 스크린샷도 좋습니다!)
  • 시도해본 해결 방법: (문제를 해결하기 위해 어떤 시도를 해보셨는지 알려주세요.)
  • 기타 관련 정보: (문제를 재현할 수 있는 워크플로우 파일, 사용 중인 LLM 프로바이더 등)

📜 라이선스

이 프로젝트는 MIT 라이선스에 따라 배포됩니다.

English Version

🌟 ComfyUI Korean Prompt Engineer (Korean Prompt Engineer with LLM)

Welcome! Here's a special node for those using ComfyUI. This node is a tool that helps you create beautiful images with whatever you can imagine in Korean. Without coding or complex settings, you can automatically create detailed and impressive English prompts like a professional.

Who is this for?

  • Those new to ComfyUI or struggling with prompt writing
  • Those who want to comfortably input ideas in Korean
  • Those who want to easily apply professional photography/video techniques to prompts
  • Those seeking optimized prompts for various AI models like Stable Diffusion

This node will help you unleash your creativity to the fullest!

Version License Developer

🚀 Key Features

  • Easy Korean Input: Freely input your image ideas in Korean. This node automatically translates and expands them into professional English prompts.
  • Diverse LLM Support: Choose from various AI language models like OpenAI (GPT), Anthropic (Claude), Google (Gemini), and Ollama to generate prompts. It's like choosing one of several intelligent assistants!
  • Expert-Level Options: Easily select professional photography and videography techniques from menus, such as camera angles, lenses, lighting, and color grading. You can create impressive effects without knowing complex terminology.
  • Automatic Negative Prompt Generation: Automatically creates negative prompts that filter out elements that might degrade image quality (e.g., blurriness, broken images). You focus on creating great images!
  • Custom Style Addition: Add your special instructions or desired styles in English to custom_instructions to control prompt generation.

🛠 Installation Methods

There are two ways to install this node. You don't need to know coding! Check the easiest method first.

📦 Method 1: Using ComfyUI Manager (⭐ Easiest Method)

ComfyUI Manager works like an 'App Store' for your smartphone, allowing you to easily install and manage ComfyUI nodes. You can install just by clicking, without entering complex commands!

Step 1: Install ComfyUI Manager

First, check if ComfyUI Manager is already installed.

To check if ComfyUI Manager is already installed:

  • Look at the top right of the ComfyUI web screen. If you see a 🔧 "Manager" button, it's already installed!
  • If you don't see the button, follow the steps below to install it.

If you haven't installed ComfyUI Manager yet:

  1. Open your ComfyUI installation folder. (Usually C:\ComfyUI or ~/ComfyUI)

  2. Find and open the custom_nodes folder inside.

  3. Right-click in an empty space within the custom_nodes folder.

  4. Select "Open Terminal Here" or "Open PowerShell Here" (Windows) / "Open Terminal Folder" (macOS).

  5. When the terminal (black window) opens, copy and paste this command and press Enter:

    git clone https://github.com/ltdrdata/ComfyUI-Manager.git

  6. After installation completes, completely close and restart ComfyUI.

  7. When ComfyUI reopens, you'll see the 🔧 "Manager" button in the top right corner!

Step 2: Install Korean Prompt Engineer via Manager

This is the simplest method. Really easy!

  1. Click the 🔧 "Manager" button in the top right corner of the ComfyUI web screen.
  2. When the popup opens, find and click "Install via Git URL".
    • Or click the search icon (🔍) and search for "Korean Prompt Engineer".
  3. If searching:
    • Type "Korean Prompt Engineer" or "korean" in the search box.
    • Find "ComfyUI-Korean-Prompt-Engineer-with-LLM" in the results and click it.
    • Click the "Install" button.
  4. If you selected "Install via Git URL":
    • Copy and paste this address into the input field: 
      https://github.com/TheGarura/ComfyUI-Korean-Prompt-Engineer-with-LLM.git
    • Click the "Install" button.
  5. Installation will proceed, and when the completion message appears, click the "Restart" button.
  6. Done! You can now use the node. 🎉

Step 3: Update Korean Prompt Engineer

When new features or bug fixes are available, you can update the node.

  1. Click the 🔧 "Manager" button in the top right corner of the ComfyUI web screen.
  2. Click the "Update All" button to update all installed nodes to the latest version.
  3. Or select "Installed Custom Nodes", find "ComfyUI-Korean-Prompt-Engineer-with-LLM", and click the "Update" button next to it.
  4. After the update completes, restart ComfyUI.

💻 Method 2: Manual Installation Using Terminal Commands (For Technical Users)

If you're already familiar with coding, this method works well too.

Installation Steps

  1. Find ComfyUI Installation Folder:

    • First, locate where ComfyUI is installed on your computer.
    • Usually at C:\ComfyUI (Windows) or ~/ComfyUI (macOS/Linux).
    • Inside this folder, you'll find a custom_nodes folder. This is where we'll install the node.

  2. Open Terminal (Command Prompt):

    • Windows: Search for cmd or PowerShell in the Start menu and run it.
    • macOS/Linux: Open the Terminal app.
    • Terminal is the black (or white) window where you give commands to your computer.

  3. Navigate to custom_nodes Folder:

    • Type this command in the terminal and press Enter.
    • Note: Replace /path/to/ComfyUI with your actual ComfyUI installation path.
    cd /path/to/ComfyUI/custom_nodes
    • Example: If ComfyUI is at C:\Users\YourName\ComfyUI, type cd C:\Users\YourName\ComfyUI\custom_nodes.

  4. Download Node Files (Clone):

    • Type this command in the custom_nodes folder and press Enter.
    git clone https://github.com/TheGarura/ComfyUI-Korean-Prompt-Engineer-with-LLM.git
    • This command downloads all node files from the internet to your computer and creates a new folder named ComfyUI-Korean-Prompt-Engineer-with-LLM.

  5. Navigate to the New Node Folder:

    • Enter the downloaded node folder. Type this command and press Enter:
    cd ComfyUI-Korean-Prompt-Engineer-with-LLM

  6. Install Required Tools:

    • This node needs some additional programs (Python packages). Type this command and press Enter:
    pip install -r requirements.txt
    • This process requires an internet connection and may take a moment. Don't worry if multiple messages appear on screen.

  7. Restart ComfyUI:

    • Installation is complete! Now completely close and restart the ComfyUI program. This allows ComfyUI to recognize and use the newly installed node.

Update Method for Manual Installation

  1. Close ComfyUI: First, completely close the ComfyUI program.

  2. Navigate to Node Directory: Open terminal and navigate to where this node is installed.

    cd /path/to/ComfyUI/custom_nodes/ComfyUI-Korean-Prompt-Engineer-with-LLM

  3. Download Latest Version: Type this command to download the latest changes.

    git pull

    This command fetches the latest code from the internet and updates your installed node.

  4. Restart ComfyUI: After the update completes, restart ComfyUI to apply changes.

📁 Project Structure

The main directory and file structure of the project is as follows:

ComfyUI-Korean-Prompt-Engineer-with-LLM/
├── __init__.py             # ComfyUI node registration and initialization
├── .env.example            # Example environment variable settings file
├── .gitignore              # Git version control exclusion file
├── cache_manager.py        # Cache management logic
├── exceptions.py           # Custom exception handling
├── LICENSE                 # MIT License information
├── llm_manager.py          # LLM provider management and calls
├── logger.py               # Logging configuration
├── nodes.py                # ComfyUI custom node definitions
├── presets.py              # Preset data used for prompt generation
├── prompt_engineer.py      # Core prompt generation logic
├── README.md               # Project description (this file)
├── requirements.txt        # Python dependency list
├── templates.py            # Prompt template definitions
├── utils.py                # Collection of utility functions
└── llm_providers/          # LLM provider modules
    ├── __init__.py         # Provider package initialization
    ├── base.py             # Base provider interface
    ├── claude_provider.py  # Anthropic Claude provider implementation
    ├── gemini_provider.py  # Google Gemini provider implementation
    ├── ollama_provider.py  # Ollama provider implementation
    └── openai_provider.py  # OpenAI provider implementation

⚙️ Initial Setup: Connecting AI Language Model (LLM) - API Key Configuration

This node uses AI language models (LLMs) to translate and expand your Korean input into English. Therefore, you need to configure the API key for the LLM service you want to use (e.g., OpenAI, Google Gemini). An API key is like a password to access that service.

Step 1: Create .env File

In this node's folder, there's a file called .env.example. Copy this file and rename the copy to .env. (A file with no extension.)

For Windows users:

  • Open File Explorer and find the folder where the node is installed (ComfyUI-Korean-Prompt-Engineer-with-LLM).
  • Right-click the .env.example file and select "Copy".
  • Right-click in an empty space in the same folder and select "Paste".
  • Rename the created file from .env.example - Copy to .env.

For macOS/Linux users:

  • Open Terminal and navigate to the node's installation folder.
  • Type this command and press Enter: 
    cp .env.example .env

The .env file safely stores important information like your API keys.

Step 2: Enter API Keys and Model Names

Open the .env file you just created with Notepad (Windows) or a text editor (macOS).

You'll see content like this:

# OpenAI (ChatGPT developer)
# OPENAI_API_KEY=""
# OPENAI_MODEL_NAME="gpt-4-turbo"

# Anthropic (Claude developer)
# ANTHROPIC_API_KEY=""
# ANTHROPIC_MODEL_NAME="claude-3-opus-20240229"

# Google (Gemini developer)
# GEMINI_API_KEY=""
# GEMINI_MODEL_NAME="gemini-1.5-flash"

# Ollama (Run AI models locally)
# OLLAMA_BASE_URL="http://localhost:11434"
# OLLAMA_MODEL_NAME="llama3"

Choose the LLM service you want to use, remove the # (comment) from those lines, and enter your API key and model name inside the "".

Example: If you want to use OpenAI

  • Visit OpenAI's website (https://platform.openai.com), sign up, and generate an API key. (Usually starts with sk-...)
  • Modify your .env file like this: 
    OPENAI_API_KEY="sk-paste_your_OPENAI_API_key_here"
OPENAI_MODEL_NAME="gpt-4-turbo" # or gpt-3.5-turbo, etc.

Same for other LLM services:

  • Anthropic (Claude): https://console.anthropic.com
  • Google (Gemini): https://makersuite.google.com/app/apikey
  • Ollama: Install locally and use (no separate API key needed)

Important Notes:

  • Services you don't use can be left with # or deleted.
  • You must correctly enter at least one service's API key for the node to work.
  • Never share your API key! Don't post it on GitHub or show it to others.

Step 3: Save the File

Make sure to save the .env file after editing!

🚀 Using the Node in ComfyUI

Now let's learn how to actually use this node in ComfyUI! It's very simple!

Step 1: Add Node

  • Right-click on an empty space in the ComfyUI work area.
  • Select Add Node from the menu that appears.
  • Select conditioning → prompt, then click Korean Prompt Engineer 🇰🇷 to add the node.
  • (A new node box will appear on screen!)

Step 2: Set Input Values

The added Korean Prompt Engineer 🇰🇷 node has various settings.

Main Input Items:

  • korean_prompt: Freely write your desired image idea in Korean here. Example: A cyberpunk cat walking through a night city street
  • provider_name: Click the dropdown menu and select the AI language model you configured in the .env file (e.g., openai, anthropic, gemini, ollama).
  • Various Options (Camera Angle, Lighting, etc.): Select various photography/videography techniques from dropdown menus to match your desired style and atmosphere. Your choices significantly affect the resulting image!
  • custom_instructions: If you have special instructions you want included in the prompt, write them here in English. Example: in the style of Blade Runner 2049
  • custom_negative_prompt: You can directly input elements you want to avoid in the image. If you input in Korean, the LLM will translate it to English; if in English, it uses as-is. If left empty, negative prompts are automatically generated based on the negative_prompt_style.

Step 3: Connect Outputs

This node produces two important results (positive_text and negative_text). You must connect these to other nodes to generate images.

  • positive_text: Drag the positive_text output from this node to the text input of a CLIP Text Encode node. (This is the positive prompt that creates your desired image.)
  • negative_text: Similarly, connect the negative_text output to another CLIP Text Encode node's text input. (This is the negative prompt that tells the AI what to avoid.)

🎨 Node Parameter Details

| Parameter Name | Description | Selection Options | | ----------------------- | ----------- | --------- | | korean_prompt | Your desired image idea in Korean | (Free input) | | provider_name | AI language model to use for prompt generation. Must match the name in your .env file. | openai, anthropic, gemini, ollama (dropdown) | | Camera Angle | From which angle to shoot the image | front, 3/4_angle, profile, overhead, low_angle, dutch_angle | | Camera Lens | What type of camera lens effect | 24mm, 35mm, 50mm, 85mm, 135mm, macro | | Lighting Setup | Overall lighting atmosphere | studio, cinematic, natural, golden_hour, backlit, rim_lighting, chiaroscuro, neon | | Mood/Atmosphere | Overall mood and feeling | dramatic, moody, bright_cheerful, melancholic, mysterious, romantic, dystopian, ethereal | | Color Grade | Color grading style | vibrant, desaturated, warm_tones, cool_tones, monochrome, duotone, cinematic_color | | Composition | Composition technique | centered, rule_of_thirds, leading_lines, depth_layers, symmetrical, diagonal | | Quality Settings | Image quality keywords | ultra_detailed, high_quality, professional, cinematic_quality | | Negative Prompt Style | Intensity/style of negative prompt | standard, strict, minimal | | temperature | LLM creativity level (higher = more diverse) | 0.0 ~ 2.0 | | max_tokens | Maximum length of generated prompt | 100 ~ 2000 | | custom_instructions | Your special additional instructions in English | (Free input) | | custom_negative_prompt | Elements to avoid (Korean or English). LLM translates Korean to English; English used as-is. Auto-generated if empty. | (Free input) |

❓ Questions? (If you have any inquiries)

If you encounter any questions or issues while using the node, please contact the developer anytime! Your feedback helps make this node better.

Including the following information when contacting will help us assist you faster:

  • ComfyUI Version You're Using: (e.g., ComfyUI 2024-01-01 version)
  • Operating System: (e.g., Windows 10, macOS Sonoma, Ubuntu 22.04)
  • When the Problem Occurred: (e.g., During node installation, after .env configuration, during node execution)
  • Error Message: (Copy and paste the exact error message from terminal or ComfyUI screen. Screenshots are also helpful!)
  • What You've Tried: (Tell us what troubleshooting steps you've attempted)
  • Other Relevant Info: (Workflow files to reproduce the issue, LLM provider you're using, etc.)

📜 License

This project is distributed under the MIT License.