Comfy-Org/ComfyUI_frontend

ComfyUI_frontend – ComfyUI를 위한 공식 웹 기반 UI

ComfyUI는 AI 이미지 생성 파이프라인(Stable Diffusion, ControlNet 등)을 구축하고 실행하기 위한 오픈 소스 시각적 프로그래밍 환경입니다. ComfyUI_frontend는 브라우저(또는 Electron 기반 데스크톱 앱)에서 실행되는 동반 프론트엔드로, 사용자가 코드를 작성하지 않고도 이러한 파이프라인을 조립, 편집 및 실행할 수 있게 해줍니다.

What it does

Graph editor – 각 노드가 AI 모델, 전처리 단계 또는 후처리 작업을 나타내는 노드 기반 캔버스(Litegraph 기반)입니다. 사용자는 노드를 드래그 앤 드롭하고, 연결하고, 시각적으로 구성할 수 있습니다.
Real‑time preview – 그래프가 실행되는 동안 생성된 이미지가 즉시 나타나므로 실험을 빠르게 할 수 있습니다.
Built‑in tools – 마스크 에디터, 대기열/히스토리 사이드바, 퍼지 검색 기능이 있는 노드 라이브러리, 사용자 정의 가능한 상단 바.
Internationalisation – UI에서 선택 가능한 14개 언어에 대한 네이티브 i18n 지원.
Extensibility – JavaScript 확장 API를 통해 개발자가 핵심 코드를 수정하지 않고도 커스텀 패널, 명령, 키바인딩, 토스트 알림 및 설정을 추가할 수 있습니다.

Notable features (as of the latest release)

| Feature | What you get | |---|---|| | Native translation (v1.5) | Comfy > Locale > Language에서 언어를 선택하십시오. UI 문자열이 즉시 번역되며, 별도의 서드파티 플러그인이 필요하지 않습니다. | | Mask editor (v1.4) | UI에서 직접 마스크를 그리거나 가져와서 노드에 부착할 수 있습니다. | | Integrated server terminal (v1.3.22) | Ctrl+`를 눌러 ComfyUI 백엔드와 통신하는 터미널을 엽니다. | | Keybinding customization (v1.3.7) | 전용 UI를 통해 단축키를 다시 매핑하고, 노드 제목을 편집하고, 캔버스를 초기화하는 등의 작업을 수행할 수 있습니다. | | Node library sidebar (v1.2.4) | 노드를 드래그 앤 드롭하고, 유형별로 필터링하고, 퍼지 매칭으로 검색할 수 있습니다. | | Queue/History sidebar (v1.2.0) | 과거 실행 기록을 확인하고, 다시 실행하거나 중간 결과를 검사할 수 있습니다. | | Litegraph quality‑of‑life tweaks – 중첩된 그룹, 그룹 선택, 링크 가시성 토글, 자동 위젯-to-입력 변환, 팬 모드, Shift-드래그 링크 생성, 선택적 입력 “donuts”, 등. |

Extension API (quick cheat‑sheet)

// Register an extension
app.registerExtension({
  name: 'MyExtension',
  // add a custom sidebar tab
  sidebarTabs: [{
    id: 'myTab',
    title: 'My Tab',
    icon: 'pi pi-star',
    render: el => { el.innerHTML = '<div>Hello</div>'; }
  }],
// add a top‑bar menu command
  commands: [{ id: 'myCmd', label: 'Do it', function: () => alert('run') }],
  menuCommands: [{ path: ['ext', 'my'], commands: ['myCmd'] }],
  // custom keybinding
  keybindings: [{ combo: { key: 'k' }, commandId: 'myCmd' }],
  // toast notification
  onLoad: () => app.extensionManager.toast.add({ severity: 'info', summary: 'Loaded', detail: 'MyExtension ready' })
});

The API는 또한 Electron 데스크톱 빌드에서 사용할 수 없는 window.prompt/confirm/alert를 대체하는 기능과 현대적인 설정 시스템(app.registerExtension({ settings: [...] }))을 제공합니다.

Release cadence

Development phase – development 브러치에서 2주간의 기능 작업이 진행됩니다.
Feature freeze – 2주 동안 버그 수정 사항만 릴리스 브랜치로 체리 피킹됩니다.
Publication – 프리즈 단계가 끝나면 안정적인 버전이 태그됩니다.
Nightly builds – 매일 게시됩니다. --front-end-version Comfy-Org/ComfyUI_frontend@latest를 사용하여 ComfyUI를 실행하여 사용할 수 있습니다.

중첩되는 사이클은 이전 버전이 릴리스 프리즈 상태일 때 새로운 마전에 버전의 개발이 시작됨을 의미하며, 이는 머지(merge)부터 안정적인 릴리스까지 약 4주의 기간을 제공합니다.

Getting started / troubleshooting

Installation – 프론트엔드는 ComfyUI 데스크톱 앱에 포함되어 있거나 웹 전용 설정을 위해 별도로 제공될 수 있습니다. 공식 문서를 따르십시오: https://docs.comfy.org/installation/desktop/windows.
Common issues – 성능 팁, 커스텀 노드 충돌, 데스크톱 전용 특이 사항에 대한 트레이블슈팅 가이드를 참조하십시오: https://docs.comfy.org/troubleshooting/overview.
Development – 개발 환경 설정, Storybook 실행, 확장 기능 작성법에 대해서는 CONTRIBUTING.md를 참조하십시오.

Who might use it?

Artists & creators – 시각적 워크플로우를 선호하는 Stable Diffusion 파이프라인을 구축하는 아티스트 및 크리에이터.
Researchers – Python 글루 코드를 작성하지 않고 새로운 모델 조합을 프로토타입으로 제작하는 연구원.
Extension developers – ComfyUI에 커스텀 UI 패널널, 명령, 또는 통합 기능을 추가하고 싶은 개발자.

Bottom line

ComfyUI_frontend는 ComfyUI AI 워크플로우 엔진을 위한 기능이 풍부하고 활발히 유지 관리되는 UI 레이어입니다. 세련련된 노드-그래프 에디터, 다국어 지원, 풍부한 JavaScript 확장 시스템을 제공하며, 모든 것은 조기 도입자를 위한 나이트리 빌드(nightly builds)와 함께 예측 가능한 일정에 따라 출시됩니다.