anymouschina/TapCanvas

TapCanvas Pro – AI 기반 시각 콘텐츠 생성 캔버스

무엇인가요 – TapCanvas Pro는 오픈소스이며, 모노레포 구조의 웹 애플리케이션으로, 단일 무한 캔버스에서 장편 AI 생성 미디어(텍스트, 이미지, 비디오, 스토리보드)를 만들 수 있습니다. 프론트엔드 캔버스, 백엔드 API, 그리고 Agents 실행 계층을 결합하여 자산, 프롬프트, 모델 호출을 프로젝트로 지속적으로 저장하고, 단계 간에 재사용할 수 있습니다.

핵심 구성 요소

구성 요소	기술 스택	역할
apps/web	Vite + React 18 + Mantine + React‑Flow	노드가 텍스트, 이미지, 비디오, 스크립트 등을 나타내는 인터랙티브 캔버스 UI. 드래그 앤 드롭으로 자산을 연결하고 워크플로우를 정의합니다.
apps/hono-api	NestJS + Hono + Node.js + Prisma + PostgreSQL + Redis	프로젝트, 자산, 인증을 저장하고 AI 도구 스키마를 노출하는 HTTP API.
apps/agents‑cli	TypeScript	"에이전트 브리지" – 최소한의 자율 에이전트 루프(plan → tool → report). 의미 이해, 기술 선택, 메모리, 서브에이전트를 처리하고 설정된 LLM 엔드포인트로 호출을 전달합니다.
apps/new‑api	수정된 new‑api 게이트웨이	여러 모델 제공업체(텍스트, 이미지, 비디오)를 위한 유니파이드 게이트웨이. 라우팅, 할당량, 청구를 처리합니다.
packages/*	공유 TypeScript 패키지	프론트엔드와 백엔드 양쪽에서 사용되는 스키마, SDK, 재사용 가능한 유틸리티.

주요 기능

• 무한 캔버스 워크플로우 – 문서, 캐릭터, 스토리보드, 생성된 이미지/비디오, 실행 링크의 노드를 무제한으로 반복 가능합니다.
• 에이전트 기반 실행 – POST /public/agents/chat 엔드포인트는 사용자 프롬프트를 에이전트 브리지로 라우팅하며, 어떤 도구(예: 텍스트 생성, 이미지 합성)를 호출할지 결정하고 결과를 캔버스에 기록합니다.
• 다중 모델 통합 – new‑api 게이트웨이는 공통 스키마를 통해 어떤 지원되는 LLM, 확산 모델, 비디오 모델도 연결할 수 있습니다.
• 프로젝트 수준 자산 지속성 – 역할 카드, 참조 이미지, 스크립트 조각, 실행 로그는 프로젝트별로 저장되어 세션 간 연속성을 보장합니다.
• 장편 콘텐츠 생성 – 소설에서 스토리보드로, 에피소드 기반 비디오 제작 등 긴 체인 시나리오에 최적화되어 있으며, 컨텍스트 인젝션은 챕터 단위로 제한됩니다.
• Docker 우선 배포 – 하나의 명령어로 docker‑compose.yml을 사용해 PostgreSQL, Redis, 에이전트 브리지, API, 모델 게이트웨이를 즉시 시작할 수 있습니다.

일반적인 사용 사례

• 소설이나 스크립트를 스토리보드로 변환한 후 짧은 비디오로 제작.
• 프롬프트, 생성된 자산, 실행 기록을 한 곳에서 관리해야 하는 협업 팀.
• 결과 추적 가능하게 여러 AI 단계(예: 장면 설명 생성 → 컨셉 아트 제작 → 비디오 클립 합성)를 필요로 하는 워크플로우.

시작하기

1. 시작 방법 선택 – 1클릭 Docker Compose 흐름(빠른 시도용 추천) 또는 로컬 소스코드 설정(개발용).
2. 의존성 설치 – 리포지토리는 pnpm 워크스페이스를 사용합니다(pnpm -w install).
3. 설정 – API, 웹 프론트엔드, agents‑cli용 .env.example 파일을 복사한 후 DATABASE_URL, JWT_SECRET, AGENTS_BRIDGE_BASE_URL를 적어도 설정합니다.
4. 실행 –
   • Docker: cd apps/hono-api && docker compose up -d 후 pnpm dev:web.
   • 소스: 세 개의 터미널을 열고 각각 pnpm --filter agents dev -- serve --port 8799, pnpm dev:api, pnpm dev:web를 실행합니다.
5. 브라우저에서 http://localhost:5173을 열면 캔버스 UI가 로드되며 API 및 에이전트 브리지와 통신 가능합니다.

라이선스 – TapCanvas의 커뮤니티 에디션은 MIT 라이선스로 배포됩니다. 상용 버전과 명확히 분리되어 있으며, MIT 조건은 이 리포지토리 내 코드에만 적용됩니다.

---

위 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추정되지 않았습니다.