comfyui-lora-hook-trigger
A clean and simple ComfyUI custom node that creates a LoRA Hook and automatically finds and loads trigger TXT files placed in a folder named after the LoRA file.
살펴보기 · 시작하기 · 사용하기 · 확인된 범위 · 문서와 지원 · 이용 조건
살펴보기
| 항목 | 설명 | 안내 |
| :--- | :--- | :--- |
| 입력 자료 | ComfyUI에 등록한 LoRA와 같은 이름의 폴더에 둔 .txt 파일 | 트리거 파일 준비 |
| 노드 | advanced/hooks의 LoRA Hook + Trigger Text | 노드 연결 |
| 출력 | LoRA 훅 HOOKS와 선택 문구 STRING | 노드 입출력 |
실제 실행 화면과 워크플로 이미지는 현재 저장소에 없습니다. 아래 폴더 구성은 설명용 예시입니다.
<a id="설치"></a>
시작하기
ComfyUI Manager
ComfyUI Manager에서 URL로 커스텀 노드를 설치하는 기능을 열고 다음 저장소 주소를 입력합니다.
https://github.com/akaugun/comfyui-lora-hook-trigger
설치 후 ComfyUI를 다시 시작합니다. 메뉴 이름과 위치는 사용하는 Manager 버전에 따라 다를 수 있습니다.
직접 설치
ComfyUI의 custom_nodes 폴더에서 다음 명령을 실행합니다.
git clone https://github.com/akaugun/comfyui-lora-hook-trigger.git
설치 위치는 다음과 같아야 합니다.
ComfyUI/custom_nodes/comfyui-lora-hook-trigger/
├── __init__.py
└── js/
└── lora_trigger_ui.js
별도의 추가 패키지 목록은 없으며, ComfyUI의 Python 환경과 comfy_extras.nodes_hooks API를 사용합니다. 이 저장소에는 시험한 ComfyUI 버전이나 호환 최소 버전이 기록되어 있지 않습니다.
사용하기
트리거 파일 준비
LoRA 파일 옆에 확장자를 뺀 LoRA 파일명과 같은 폴더를 만들고, 그 안에 소문자 .txt 확장자의 트리거 파일을 저장합니다. 아래 이름과 문구는 설명용 예시입니다.
models/loras/
├── my_lora.safetensors
└── my_lora/
├── portrait.txt
└── style.txt
예를 들어 portrait.txt에는 사용할 프롬프트 문구를 적습니다. 실제 LoRA 위치는 ComfyUI에 등록한 LoRA 경로를 따릅니다.
노드 연결
advanced/hooks에서 LoRA Hook + Trigger Text 노드를 추가합니다.lora_name에서 LoRA를 고르고,trigger에서 텍스트 파일명을 고릅니다. 목록에는 확장자를 뺀 이름이 표시됩니다.strength_model과strength_clip을 정합니다.hook을HOOKS입력을 받는 노드에,trigger_text를 프롬프트 문자열 입력에 연결합니다. 훅 적용과 프롬프트 조합은 사용하는 워크플로에서 정합니다.
NONE을 고르면 트리거 문구는 빈 문자열입니다. 파일이 없거나 읽을 수 없는 경우에도 빈 문자열을 반환합니다. 텍스트는 UTF-8-SIG, UTF-8, CP949 순서로 읽고, 모두 실패하면 UTF-8 대체 문자 읽기를 시도합니다.
노드 입출력
| 입력 | 형식 | 역할 |
|---|---|---|
| lora_name | 목록 | ComfyUI에 등록된 LoRA 선택 |
| trigger | 문자열 | 선택한 파일명 또는 NONE |
| strength_model | 실수 | 모델에 적용할 LoRA 강도 |
| strength_clip | 실수 | CLIP에 적용할 LoRA 강도 |
| prev_hooks | HOOKS, 선택 | 앞에서 만든 훅 그룹 |
| 출력 | 형식 | 내용 |
|---|---|---|
| hook | HOOKS | 생성하거나 결합한 LoRA 훅 |
| trigger_text | STRING | 선택한 텍스트 파일의 내용 |
확인된 범위
| 확인 항목 | 상태 | 근거 | | :--- | :--- | :--- | | 버전·등록 정보 | 소스 v1.0.3 | 패키지 메타데이터 | | 트리거 읽기·훅 생성 | 현재 소스에서 입출력·폴더명·인코딩 순서 확인 | Python 노드 | | 선택 목록 갱신 | 현재 소스에서 조회·표시·직렬화 경계 확인 | 브라우저 확장 | | 실제 ComfyUI 실행·호환판 | 시험한 버전과 최소 호환 버전 미기록 | 현재 메타데이터 |
소스 확인은 실제 워크플로 실행이나 호환성 통과를 뜻하지 않습니다. 설치 후 사용하는 ComfyUI 버전에서 노드와 훅 결과를 확인하세요.
문서와 지원
문서 둘러보기에서 설치, 사용과 구현 경로를 찾습니다. 릴리스에서 게시 기록을 확인합니다.
문제 확인
- 노드가 보이지 않음: 설치 폴더와 ComfyUI 시작 로그를 확인하고 ComfyUI를 다시 시작합니다
- 트리거가
NONE만 표시됨: 선택한 LoRA 옆의 폴더명과.txt파일을 확인합니다. LoRA를 다시 선택하면 목록을 조회합니다 - 문구가 비어 있음:
NONE선택 여부, 파일명·확장자·내용과 읽기 권한을 확인합니다 - 브라우저의 선택 목록이 갱신되지 않음: ComfyUI 재시작 후 브라우저를 강력 새로고침합니다. Windows/Linux는
Ctrl+F5, macOS는Cmd+Shift+R입니다 - 훅 결과가 예상과 다름: ComfyUI 버전과 훅 API를 확인합니다. 이 구현은 API를 가져오거나 호출하지 못하면 기존 훅 또는 빈 결과를 반환할 수 있습니다
문제는 이슈에 ComfyUI 버전, 재현 순서와 오류를 남깁니다. 개인 경로·프롬프트·모델 파일은 공유 전에 확인하세요.
구현
- Python 노드: LoRA 경로 조회,
/lora_trigger_list목록 API, 텍스트 읽기와 훅 생성 - 브라우저 확장: 선택 목록 조회와 표시. UI용 목록은 따로 직렬화하지 않고 기존
trigger값을 갱신합니다 - 패키지 메타데이터: 버전과 Comfy Registry 등록 정보
English summary
ComfyUI custom node that returns a LoRA hook and trigger text from a folder named after the selected LoRA. The current repository has no LICENSE file or documented tested ComfyUI version.
</details><a id="라이선스-상태"></a>
이용 조건
현재 기본 브랜치에는 LICENSE 파일이 없습니다. 기존 README와 pyproject.toml의 라이선스 파일 표기는 실제 저장소 파일과 일치하지 않습니다.