GitHub - BennyKok/comfyui-deploy: Comfy UI를 위한 오픈 소스 `vercel` 스타일의 배포 플랫폼

ko생성일: 2025. 7. 4.

Comfy UI 워크플로우 배포를 위한 오픈 소스 서버리스 플랫폼, 설치/사용법 및 개발 방법 안내.

ComfyUI Deploy

오픈 소스 comfyui 배포 플랫폼, 즉 생성형 워크플로우 인프라를 위한 vercel 스타일의 솔루션입니다. (서버리스로 호스팅되는 GPU 및 comfyui와의 수직 통합)

참고 사항

ComfyDeploy의 핵심 팀에 합류할 창의적인 해커를 찾고 있습니다! 트위터로 DM 주세요.

더 많은 이야기는 Discord에서 나누거나 Comfy Deploy에서 시작해보세요!

Comfy Deploy와 함께 하는 최신 nextjs 스타터 키트도 확인해 보세요.

ComfyDeploy 대시보드 예시 이미지


작동 방식

  1. Comfy Deploy 대시보드(https://comfydeploy.com) 혹은 셀프 호스팅 버전
  2. 머신 등록 (지속 실행형, 온프레미스 ComfyUI 머신 및 서버리스)
  3. runpods, modal, 호스팅된 ComfyDeploy 머신(modal 기반) 지원

기본 sd txt2img API 설정

(관련 영상: comfydeploy_base-sd-setup.mp4)


Comfy Deploy 플러그인 설치

플러그인을 이용하면 머신을 타겟 머신으로 지정하고, 워크플로우를 직접 업로드할 수 있습니다.

  1. cd custom_nodes
  2. git clone https://github.com/BennyKok/comfyui-deploy.git
  3. https://comfydeploy.com 혹은 셀프 호스팅 버전 접속
    • Machines -> Add Machines 이동
      • 머신 이름과 URL을 입력합니다. (공개 URL을 위해 Ngrok을 이용할 수 있습니다)
      • 새 ComfyDeploy 머신을 생성합니다 (원하는 커스텀 노드 선택).

활용 사례

  1. 버전 관리 시스템과 함께 복잡한 comfy 워크플로우를 배포
  2. 다양한 생성 버전의 출력을 쉽게 미리보고 관리
  3. 프로덕션 및 스테이징 환경용으로 생성된 API를 영구적으로 관리
  4. 여러 원격 머신에서 동일한 comfyui 워크플로우 실행 가능

워크플로우 활용 예시 이미지


개발 현황 및 계획

작업 진행 중(WIP)이며, 기여자를 환영합니다! 디스코드 참여: https://discord.gg/EEYcQmdYZw

주요 목표: Comfy Deploy의 안정적인 v0.1.0 릴리즈

주요 작업 영역

  • 보안 강화
  • 에러 핸들링
  • 워크플로우 QOL(사용성) 개선
  • API 사용 예제 추가
  • 로드 밸런싱
  • 워크플로우 의존성 체크(커스텀 노드)
  • 원격 머신 지원
  • 서버리스 머신 지원(예: Salad, Modal 등으로 클린 환경 구성)
  • LCM 실시간 웹소켓 이미지 생성

기술 스택

  • Shadcn UI
  • NextJS
  • Clerk (인증)
  • Neon / Vercel Postgres (DB)
  • Drizzle (ORM)
  • R2 / S3 (오브젝트 스토리지)

개발 방법

  1. git clone https://github.com/BennyKok/comfyui-deploy
  2. cd web
  3. bun i
  4. 도커 실행
  5. cp .env.example .env.local
  6. JWT_SECRET 값을 openssl rand -hex 32로 생성한 값으로 교체
  7. NEXT_PUBLIC_CLERK_PUBLISHABLE_KEYCLERK_SECRET_KEY에 Clerk Dev 키 입력
  8. 터미널에서 bun run db-dev 실행 유지
  9. 초기 데이터 생성을 위해 마이그레이션 실행: bun run migrate-local
  10. Next 서버 실행: bun dev

스키마 변경 시

  1. bun run generate
  2. bun run migrate-local

Special Thanks

  • comfyui
  • oss/acc

Vercel을 이용한 셀프 호스팅

빌드 커맨드

next build && bun run migrate-production

설치 커맨드

npx bun@1.0.16 install

환경 변수 설정 예시

POSTGRES_URL=

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

SPACES_ENDPOINT="http://localhost:4566"
SPACES_ENDPOINT_CDN="http://localhost:4566"
SPACES_BUCKET="comfyui-deploy"
SPACES_KEY="xyz"
SPACES_SECRET="aaa"

# openssl rand -hex 32 로 생성
JWT_SECRET=

# r2 설정
SPACES_REGION="auto"
SPACES_CDN_FORCE_PATH_STYLE="true"
SPACES_CDN_DONT_INCLUDE_BUCKET="true"

# digital ocean 설정
SPACES_REGION="nyc3"
SPACES_CDN_FORCE_PATH_STYLE="false"

# s3 설정
SPACES_REGION="nyc3"
SPACES_CDN_DONT_INCLUDE_BUCKET="false"
SPACES_CDN_FORCE_PATH_STYLE="true"

소개

Comfy UI를 위한 오픈 소스 vercel 스타일의 배포 플랫폼입니다.

라이선스

기타 정보

  • 스타 : 1.4k+
  • 감시자 : 17
  • 포크 : 189

기여자

주요 언어 비중

  • TypeScript 58.1%
  • Python 28.9%
  • JavaScript 11.7%
  • MDX 0.6%
  • Dockerfile 0.4%
  • CSS 0.3%

프로젝트 스폰서 및 참여 방법 등은 깃허브 페이지를 참고하세요.