SamurAIGPT/Vibe-Workflow

Vibe Workflow – 오픈소스, 자체 호스팅 가능한 노드 기반 AI 워크플로우 빌더

무엇인가요

• 무료로 사용할 수 있으며 MIT 라이선스를 따르는 웹 애플리케이션. 생성형 이미지 및 비디오를 위한 파이프라인을 시각적으로 조합할 수 있습니다. Weavy AI, Krea Nodes, Freepik Spaces, FloraFauna AI와 같은 상용 도구의 노드 에디터 경험을 모방하지만, 자신만의 하드웨어에서 실행할 수 있습니다.

핵심 구성 요소

• 프론트엔드 – 드래그 앤 드롭 캔버스를 제공하는 Next.js 앱 (client/)
• 워크플로우 빌더 라이브러리 – 노드 시스템을 구현하는 재사용 가능한 UI 패키지 (packages/workflow-builder/)
• 백엔드 – 노드 요청을 생성 모델 제공자(MuAPI/Vadoo AI)로 전달하고 결과를 반환하는 FastAPI 서비스 (server/)

주요 기능

기능	세부 사항
노드 기반 시각 에디터	코드를 작성하지 않고 모듈(예: 프롬프트, 모델, 포스트프로세스)을 구성하고 연결하며 순서를 변경할 수 있습니다.
생성형 이미지 및 비디오	MuAPI의 확산 및 비디오 모델을 사용하며, 사용자는 자체 API 키를 제공합니다.
자체 호스팅 가능	Docker Compose 또는 수동 설정; 데이터는 인프라 외부로 유출되지 않습니다.
확장 가능	외부 API나 LoRA/사용자 정의 확산 모델을 호출하는 사용자 정의 노드를 추가할 수 있습니다.
API 및 임베드 지원	호스팅된 버전(muapi.ai/workflow)은 REST API와 임베드 가능한 위젯을 제공하며, 오픈소스 리포지토리는 유사하게 확장할 수 있습니다.
MIT 라이선스	수정, 재배포, 다른 제품에 통합하는 데 자유롭게 사용 가능합니다.

일반적인 사용 사례

• 크리에이티브 스튜디오 – 브랜드 가이드라인을 내부에 유지하면서 대규모 자산 생성을 자동화합니다.
• 개발자 – SaaS 제품이나 내부 도구에 미리 준비된 시각적 워크플로우 위젯을 통합합니다.
• 연구자 – 벤더 종속성 없이 새로운 확산 모델이나 비디오 생성기를 실험합니다.
• 노코드 크리에이터 – 스크립팅 대신 UI를 통해 복잡한 생성 파이프라인을 설계합니다.

시작하기 (빠른 시작)

1. 클론 및 설치

   git clone https://github.com/samuraigpt/vibe-workflow.git
   cd vibe-workflow
   npm install   # workspaces를 통해 client + library 설치
   

2. MuAPI 키 추가

   cd server
   cp .env.example .env
   # .env 편집 → MU_API_KEY=your_key
   

3. 로컬에서 실행
   • 프론트엔드: npm run dev:app → http://localhost:3000
   • 백엔드:

     python -m venv venv && source venv/bin/activate
     pip install -r requirements.txt
     uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
     

4. 또는 Docker Compose 사용

   cp .env.example .env   # MU_API_KEY 설정
   docker compose up --build
   

   프론트엔드는 3000번, API는 8000번.

플랫폼 확장하기

• packages/workflow-builder/에 새로운 노드를 생성하여 입력/출력 포트와 요청을 정의합니다.
• 백엔드에서 노드를 등록하여 FastAPI 서버가 페이로드를 처리할 수 있도록 합니다.
• 라이브러리 재빌드 (npm run build:lib) 후 클라이언트를 재시작합니다.

상용 대안 대비 Vibe Workflow를 선택하는 이유

• 오픈소스 및 무료 – 구독료 없음.
• 데이터 완전 제어 – 모든 작업이 자체 서버에서 실행됨.
• 모델 교체 가능 – MuAPI를 다른 제공자로 교체하거나 자체 확산 모델을 호스팅할 수 있음.
• 재사용 가능한 라이브러리 – 노드 에디터는 다른 프로젝트에 가져와 사용 가능.

자료

• 전체 스토리 및 동기: [Medium 기사]
• 호스팅된 SaaS 버전 (즉시 UI를 원하는 경우): https://muapi.ai/workflow
• 기여 가이드: CONTRIBUTING.md
• 라이선스: MIT

---

Vibe Workflow 는 유료 SaaS 플랫폼에 종속되지 않고 노드 기반 에디터의 힘을 활용하고자 하는 크리에이터를 위한 시각적 "파이프라인 빌더"입니다.