anymouschina/TapCanvas

TapCanvas – 커뮤니티 에디션

개요

• TapCanvas는 멀티모달 스토리텔링 프로젝트(영화, 애니메이션, 코믹 등)를 만들기 위한 오픈소스 웹 기반 "무한 캔버스"입니다.
• 캔버스는 스크립트, 캐릭터, 장면 자산, 스토리보드, 오디오, 자막 및 전체 제작 워크플로를 타입화된 노드와 연결로 저장합니다.
• AI 에이전트는 현재 캔버스 상태를 읽고, 수행할 작업을 계획하고, 전문 스킬(텍스트 생성, 이미지/비디오 합성, 편집 등)을 호출하고, 각 단계를 기록하여 검증 가능한 결과물을 생성합니다.

핵심 기능

기능	설명
무한 타입 캔버스	노드, 포트, 엣지를 사용하여 내러티브 요소, 미디어 자산, 워크플로 단계를 단일 버전 관리 그래프로 구성할 수 있습니다.
에이전트 네이티브 실행	통합 POST /public/agents/chat 엔드포인트가 DeepSeek Harness 브리지를 통해 요청을 라우팅합니다. 에이전트는 의미 이해, 계획, 스킬 호출, 하위 에이전트 생성, 결과 자체 검증을 수행합니다.
제작 백본	챕터 수준 컨텍스트, 구조화된 스토리보드, 연속 샷, 프레임 간 핸드오프, 비디오 생성/합성(원클릭 "영화 만들기" 워크플로 진행 중)을 지원합니다.
멀티 모델 게이트웨이	Lu-Ban API(apps/new-api)는 여러 제공업체(HeyRoute, Factory/Droid 등)의 텍스트, 이미지, 비디오, 오디오 모델을 추상화하고 계량, 가격 책정, 동적 모델 선택을 처리합니다.
프로젝트 수준 자산 관리	자산 라이브러리, 버전 관리, 생성 기록, 작업 상태, 전달 증거가 영구 저장됩니다. 성공한 자산은 폐기되지 않습니다.
워크플로 및 협업	재사용 가능한 DAG 정의, 비동기 워커, 장애 복구, 공유/게시, 팀 범위, 실시간 캔버스 동기화.

일반적인 사용 사례 흐름

1. 프로젝트 생성 – 캔버스에 스크립트, 캐릭터, 장면 자산, 스토리보드를 추가합니다.
2. 제작 DAG 정의 – 텍스트 생성, 이미지 생성, 비디오 스티칭, 자막 생성 등을 나타내는 노드를 연결합니다.
3. 에이전트 실행 – 에이전트가 캔버스를 읽고, 호출할 스킬을 결정하고, Lu-Ban을 통해 적절한 모델을 호출하고, 생성된 미디어를 캔버스에 저장합니다.
4. 반복 및 협업 – 팀원은 그래프를 편집하고, 실행 로그를 보고, 이전 작업을 잃지 않고 실패한 단계를 다시 실행할 수 있습니다.
5. 내보내기 – 최종 비디오(또는 기타 미디어)를 다운로드할 수 있습니다. 전체 출처 그래프는 재현 가능한 기록으로 사용됩니다.

아키텍처 개요

• apps/web – Mantine 및 React-Flow로 구축된 React UI. 무한 캔버스와 편집기를 렌더링합니다.
• apps/hono-api – REST/GraphQL API, 인증, 작업 원장, 전달 증거를 제공하는 Hono 서버.
• apps/agents-cli – HTTP 채팅 요청을 에이전트 루프로 변환하는 DeepSeek Harness 브리지.
• apps/new-api – Lu-Ban 모델 게이트웨이(HeyRoute, Factory/Droid 등 채널)로 계량 및 모델 선택을 처리합니다.
• packages/schemas – 프론트엔드와 백엔드 간의 공유 TypeScript 계약.
• Docker-compose – 모든 서비스(웹, API, 게이트웨이, 워커, PostgreSQL)가 함께 실행됩니다. 단일 ./scripts/dev.sh docker 명령으로 전체 스택을 부팅할 수 있습니다.

시작하기(Docker)

git clone https://github.com/anymouschina/TapCanvas.git
cd TapCanvas
./scripts/dev.sh docker   # 모든 컨테이너 빌드 및 시작

• 스크립트는 JWT/워커 토큰용 일회성 OpenSSL 시크릿을 생성하고 apps/hono-api/.env(git 무시)에 기록합니다.
• 완료 후 다음을 엽니다:
  • UI: http://localhost:5175
  • API: http://localhost:8788
  • 모델 게이트웨이 관리: http://localhost:4455
• Lu-Ban 관리 UI에서 모델 제공업체 키를 구성합니다(HeyRoute, Factory/Droid 등).
• Docker 없이 로컬 개발을 하려면 Node 22+ 및 pnpm 10.8.1을 설치한 후 pnpm -w install && pnpm dev:web을 실행합니다.

라이선스

• TapCanvas 핵심 코드는 MIT 라이선스로 배포됩니다.
• apps/new-api(모델 게이트웨이)는 업스트림 AGPL-3.0 라이선스를 유지합니다.
• 다른 모든 타사 종속성은 원래 라이선스를 유지합니다.

누가 유용하게 사용할 수 있나요?

• 인디 영화 제작자, 코믹 창작자, 게임 작가, 또는 재현 가능한 AI 증강 멀티모달 스토리텔링 파이프라인을 원하는 팀.
• 긴 체인 AI 워크플로, 출처 추적 또는 에이전트 기반 콘텐츠 생성을 탐구하는 연구자.
• AI 에이전트 중심 제작 스택의 참조 구현을 찾는 개발자.

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.