ganbo-gab/open-storyboard-canvas

开源的 AI 分镜与导演台画布，支持全景图、摄像机控制、提示词预设和自定义供应商调用。

Open Storyboard Canvas – 무엇인가요

Open Storyboard Canvas 는 로컬에서 실행되는 데스크톱 앱으로, 창작자들이 시각적인 "노드 캔버스" 위에서 AI 기반 이미지 및 비디오 생성 파이프라인을 구축하고 조직하며 실행할 수 있도록 합니다. Tauri 기반 GUI(React + TypeScript 프론트엔드, Rust 백엔드)와 여러 텍스트에서 이미지/비디오를 생성하는 프로바이더(OpenAI 호환 API, Claude, Dreamina CLI 등)에 대한 플러그인 지원을 결합했습니다. 캔버스에는 참조 미디어, 프롬프트, 생성된 자산, 3D "디렉터 스튜디오"(장면 레이아웃용), 그리고 노드를 조작하고 생성 작업을 제출하며 상태를 보고할 수 있는 대화형 Canvas Agent 가 포함됩니다.

핵심 기능 (README에 설명됨)

영역	앱이 하는 일
Canvas Agent (베타)	오른쪽에 위치한 채팅 기반 보조자로 현재 프로젝트를 읽고, 노드 생성/이동/편집, 생성 작업 제출, 상태 추적, 간결한 추론 요약 표시가 가능합니다. 수동 및 자동 확인 모드 모두 지원합니다.
AI 이미지/비디오 워크플로우	스케치에서 이미지 생성, 참조 이미지로 편집, 비디오 생성, 스토리보드 프레임 추출이 가능합니다. 모든 프로바이더 수준 설정(모델, 해상도, 종횡비, 출력 수, 추가 파라미터)은 중앙에서 관리됩니다. 사용자 정의 OpenAI 호환 프로바이더, Agnes, 로컬 Dreamina CLI를 지원합니다.
노드 캔버스 및 태그 그룹	미디어, AI 생성 자산, 스토리보드, 파노라마, 디렉터 스튜디오 장면을 노드로 업로드할 수 있습니다. 태그 그룹을 통해 프롬프트 텍스트를 길게 하지 않고도 참조를 그룹화할 수 있습니다. 무제한 캔버스 크기와 기하학적 인덱싱 및 캐싱으로 성능을 보장합니다.
디렉터 스튜디오 및 파노라마	3D 장면 편집기에서 캐릭터, 소품, 조명, 카메라를 배치할 수 있습니다. 캔버스로 스크린샷 내보내기, 파노라마 생성 또는 가져오기, 카메라 이동 기록이 가능합니다.
생산성 및 진단	스프레드시트에서 일괄 프롬프트 가져오기, 프리셋이 있는 프롬프트 라이브러리, 되돌리기/다시하기, 프로젝트 지속성, 익명화된 세부 정보를 포함한 검색 가능한 로그, API 키 및 비용 관련 작업의 명시적 처리가 가능합니다.
크로스플랫폼 데스크톱	macOS(유니버설 dmg) 및 Windows(exe)용으로 패키징되었습니다. Tauri 2로 구축되어 UI는 가벼운 WebView에서 실행되고, 네트워크 호출 및 파일 I/O와 같은 무거운 작업은 Rust에서 처리됩니다.

시작하기

다운로드 GitHub Releases 페이지에서 최신 설치 파일을 다운로드하세요 (macOS와 Windows용 별도 바이너리). macOS 사용자는 앱이 아직 노트라이즈되지 않았기 때문에 Gatekeeper를 우회해야 할 수 있습니다.
프로바이더 설정 설정 → My Config 에서 OpenAI 호환 API 키, Claude 자격 증명, 또는 로컬 Dreamina CLI 설치 경로를 추가하세요.
프로젝트 생성 (또는 기존 프로젝트 열기) 후 왼쪽 패널에서 노드를 추가하세요 – 미디어 업로드, AI 이미지/비디오 노드 추가, 또는 디렉터 스튜디오 장면 드래그 앤 드롭.
생성 노드의 생성 버튼을 클릭하거나 Canvas Agent(채팅 창)를 호출하여 "해질 무렵 배경 생성"과 같은 요청을 하세요. Agent는 노드를 생성하고 요청을 제출하며 결과가 도착하면 캔버스를 업데이트합니다.
로그 확인 오류가 발생하면 왼쪽에 있는 로그를 확인하세요. 로그는 자동으로 익명화되지만 디버깅을 위해 확장할 수 있습니다.

프로젝트 구조 (개요)

src/                     # TypeScript 프론트엔드
  commands/              # Tauri(Rust) 명령어 브리지
  components/            # 재사용 가능한 UI 조각
  features/canvas/       # 캔버스 UI, Agent, 디렉터 스튜디오, 노드 로직
  features/promptLibrary # 프롬프트 라이브러리 UI 및 저장소
  stores/                # Zustand 상태 관리
  i18n/                  # 중국어/영어 번역
src‑tauri/               # Rust 백엔드 (Tauri)
  src/commands/          # 시스템 수준 명령어, 네트워크 프록시
  src/ai/                # 프로바이더 어댑터 (OpenAI, Claude, Dreamina…)
  tauri.conf.json        # Tauri 설정
docs/                    # 사용자 및 개발자 문서

개발 빠른 시작

# 복제 및 종속성 설치
git clone https://github.com/ganbo-gab/open-storyboard-canvas.git
cd open-storyboard-canvas
npm install

# 개발 모드에서 UI 실행
npm run dev            # 핫리로드 프론트엔드
npm run tauri dev      # 개발 서버와 함께 데스크톱 앱 실행

이 리포지토리는 Lint, 타입 체크, 빌드, Rust 측 테스트(cargo test)를 위한 스크립트도 제공합니다.

라이선스 및 출처

코드는 MIT 라이선스 하에 배포됩니다. Storyboard‑Copilot (원작자 henjicc)의 포크이며, 파생 작업의 개발 및 오픈소스화를 명시적으로 허용받았습니다. 원작자 및 상류 리포지토리는 NOTICE 파일에 명시되어 있습니다.

누구에게 적합한가요?

프롬프트, 생성된 자산, 장면 레이아웃을 한 곳에서 관리하고 싶은 스토리보드 아티스트 및 애니메이터.
게임, 마케팅, 영상 제작용 AI 생성 비주얼을 만드는 콘텐츠 크리에이터.
Tauri 기반 AI 데스크톱 앱을 확장하고 싶은 개발자 (리포지토리는 명확한 Rust/TS 경계와 프로바이더 어댑터를 포함).

요약

Open Storyboard Canvas는 AI 이미지/비디오 생성, 시각적 노드 기반 워크플로우, 대화형 보조자를 통합한 진정한 기능 풍부한 데스크톱 도구입니다. 완전히 오픈소스이며 크로스플랫폼 지원하며, 단순한 "프롬프트 → 이미지" 웹 UI보다 더 많은 제어를 필요로 하는 창작자를 위한 것입니다.