openstory

OpenStory는 작성된 스크립트를 스타일화된 영상 제작물로 바꾸는 오픈소스 플랫폼입니다. 스크립트를 카메라 앵글, 분위기 처리, 연속성 추적이 포함된 장면 분석으로 나눈 뒤, AI 프레임 시퀀스 — 이미지, 모션 비디오, 오디오 — 를 생성하면서 캐릭터, 장소, 색상 팔레트, 조명을 장면 전반에 걸쳐 일관되게 유지합니다. 이 프로젝트는 프롬프트 엔지니어링, 생성, 합성을 처리하여 팀이 창작 작업에 집중할 수 있게 한다고 설명합니다. README에 설명된 주요 기능: - 스크립트 분석: 스크립트를 붙여넣으면 카메라 앵글, 분위기 처리, 연속성 추적이 포함된 자동 장면 분석을 받습니다. - Fal.ai를 통한 AI 이미지 생성, 다양한 모델 옵션 제공. - 이미지-투-비디오 모션: 정지 프레임을 모션 비디오 클립으로 변환합니다. - 스타일 일관성: 캐릭터, 장소, 색상 팔레트, 조명이 장면 전반에 자동으로 이어집니다. - 팀 워크스페이스는 스타일, 캐릭터, VFX, 오디오의 공유 라이브러리를 포함하여 출시 예정으로 나열되어 있습니다. - Better Auth를 통한 패스키 인증으로 비밀번호 없는 로그인. - 글로벌 CDN을 갖춘 Cloudflare Workers의 엣지 배포. 아키텍처 및 스택: 앱은 TanStack Start, TanStack Router, Vite로 구축되었으며 Bun(>= 1.3.9)에서 실행됩니다. 데이터는 Drizzle ORM을 통해 Cloudflare D1(SQLite)에 저장됩니다. AI 기능은 TanStack AI, Fal.ai, OpenRouter를 사용하며, LLM 관측성에는 PostHog를 사용합니다. 장시간 실행되는 생성은 내구성 있는 실행을 위해 Cloudflare Workflows가 처리하고, Cloudflare Durable Objects가 실시간 SSE 진행 상황 업데이트를 제공합니다. 자산은 Cloudflare R2(S3 호환)에 저장됩니다. UI는 Tailwind v4와 shadcn/ui를 사용합니다. 품질 도구로는 oxlint, oxfmt, tsgo, Lefthook, Knip이 있으며, 테스트는 Vitest와 Playwright를 사용합니다. 시작하기 위해서는 Bun만 필요합니다. 로컬 개발은 D1, R2, Workflows, Durable Objects, 이메일을 포함한 전체 스택을 Miniflare를 통해 Workerd 내부에서 실행하므로 Docker, 외부 데이터베이스, Cloudflare 계정이 필요하지 않습니다. 클론 후 bun install을 실행하면 bun dev가 인증 및 암호화 시크릿으로 .env.local을 부트스트랩하고, 로컬 데이터베이스를 마이그레이션 및 시드하며, 포트 3000에서 개발 서버를 시작합니다. AI 생성에는 두 개의 키가 필요합니다: 이미지, 비디오, 오디오 생성용 FAL_KEY와 LLM 스크립트 분석용 OPENROUTER_KEY이며, bun setup이 대화식으로 추가합니다. 선택적 구성으로는 Google OAuth, Stripe, PostHog, 원격 R2가 있습니다. 저장소에는 개발, 품질 검사, 테스트, 데이터베이스 마이그레이션, 배포를 위한 광범위한 스크립트가 문서화되어 있습니다. 배포는 Cloudflare Workers를 대상으로 하며, 저장소를 클론하고 wrangler.jsonc에 선언된 리소스를 프로비저닝하며 CI를 설정하는 원클릭 배포 버튼이 있습니다. Cloudflare Workers Builds는 main에 푸시할 때 자동 배포하며, 풀 리퀘스트는 전용 D1 데이터베이스와 함께 GitHub Actions 프리뷰 배포를 받습니다. 이 프로젝트는 MIT 라이선스이며 기여를 환영하며, 새로운 기여자에게 good first issue 라벨과 CONTRIBUTING 가이드를 안내합니다.