TanStack Start와 Cloudflare Workers 기반의 엣지 네이티브 SaaS 스타터로, 인증, Stripe 결제, 이메일, i18n, 관리자 콘솔을 제공합니다.
qianshuixia/shrimpreel
유행 키워드마다 사이트 하나씩, 사진 한 장으로 AI 동영상을 만드는 SaaS를 구축하는 오픈소스 Cloudflare 기반 템플릿입니다.
- 스타
- 386
- 포크
- 160
- 열린 이슈
- 1
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
ShrimpReel은 사용자가 사진 한 장을 업로드하면 바이럴 템플릿을 적용한 AI 생성 동영상을 제공하는 웹사이트용 스타터 템플릿입니다. 유행 키워드마다 템플릿을 복사해 사용하도록 설계되어 있습니다. 새 repository를 만들고 사이트 설정을 변경한 다음, 직접 만든 콘텐츠와 미디어를 넣어 배포하면 됩니다. 전체 스택은 Cloudflare Workers, D1, R2, KV, Queues, Rate Limiting, Cron Triggers에서 실행되며, 애플리케이션에는 TanStack Start와 Hono를 사용합니다.
유료 소비자용 사이트에 필요한 기능도 갖췄습니다. Google 로그인, Waffo Pancake·Dodo Payments·Stripe를 통한 크레딧 팩 및 선택형 구독, 실패 시 환불을 지원하는 생성 큐, 만료되는 지급분을 기록하는 크레딧 원장, 주문·사용자·환불·리딤 코드·런타임 설정을 관리하는 관리자 콘솔이 포함됩니다. 동영상 생성에는 기본적으로 fal.ai queue API를 사용하며, 선택적으로 yir.ai와 NanoAPI를 이용하거나 로컬 개발용 mock 모드로 실행할 수 있습니다.
AI 생성 콘텐츠 표시, 사진 및 동영상 예약 삭제, 게시 중단 요청 처리 워크플로, 트랜잭션 이메일, 영어·중국어 이중 언어 페이지, sitemap 및 구조화 데이터 생성 등 규정 준수와 SEO 기능도 포함합니다.
핵심 기능
- 01전체 백엔드 스택으로 Cloudflare Workers, D1, R2, KV, Queues 사용
- 02Google 로그인, 크레딧 팩, 월간 또는 연간 구독
- 03Waffo Pancake, Dodo Payments, Stripe 중 결제 수단 선택 가능하며, 환불 시 크레딧 차감
- 04데드 레터 처리를 지원하고 실패 시 크레딧을 자동 반환하는 생성 큐
- 05주문, 사용자, 생성 작업, 게시 중단 요청, 리딤 코드, 추천을 관리하는 관리자 콘솔
- 06SSR, sitemap, JSON-LD를 지원하는 영어·간체 중국어 이중 언어 페이지
활용 사례
- 유행하는 댄스나 필터 키워드에 맞춘 단기 운영 AI 동영상 사이트 출시
- 결제 기능을 처음부터 구축하지 않고 Cloudflare에서 유료 이미지-동영상 SaaS 시작
- 하나의 코드베이스를 공유하고 git merge로 upstream 수정 사항을 반영하는 키워드별 사이트 여러 개 운영
빠른 시작
- 1
템플릿 저장소를 클론합니다
git clone https://github.com/qianshuixia/shrimpreel.git moonhop && cd moonhop - 2
종속성을 설치합니다(npm 11.19 이상)
npm install - 3
.dev.vars.example을 .dev.vars로 복사하고 SESSION_SECRET을 설정한 다음, 마이그레이션을 적용하고 로컬 R2에 시드 데이터를 추가합니다
npm run seed:local - 4
개발 서버를 시작하고 http://127.0.0.1:3000을 엽니다
npm run dev -- --host 127.0.0.1
사용 전 알아둘 점
- Cloudflare Workers, D1, R2, KV, Queues를 기반으로 구축되어 있어 프로덕션에서 실행하려면 Cloudflare 계정이 필요합니다.
- 프로덕션에서 사용하려면 실제 결제 및 동영상 제공업체 계정이 필요합니다. 기본 모의 제공업체는 요금을 청구하지 않으며 새로운 콘텐츠도 생성하지 않습니다.
- README와 문서 대부분은 중국어로 작성되어 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- shrimpreel은(는) 무엇인가요?
- 유행 키워드마다 사이트 하나씩, 사진 한 장으로 AI 동영상을 만드는 SaaS를 구축하는 오픈소스 Cloudflare 기반 템플릿입니다. ShrimpReel은 사용자가 사진 한 장을 업로드하면 바이럴 템플릿을 적용한 AI 생성 동영상을 제공하는 웹사이트용 스타터 템플릿입니다. 유행 키워드마다 템플릿을 복사해 사용하도록 설계되어 있습니다. 새 repository를 만들고 사이트 설정을 변경한 다음, 직접 만든 콘텐츠와 미디어를 넣어 배포하면 됩니다. 전체 스택은 Cloudflare Workers, D1, R2, KV, Queues, Rate Limiting, Cron Triggers에서 실행되며, 애플리케이션에는 TanStack Start와 Hono를 사용합니다.
- shrimpreel은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- shrimpreel은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- shrimpreel은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. shrimpreel의 마지막 커밋은 2026년 11월 5일입니다.
- shrimpreel은(는) 어디에 사용할 수 있나요?
- 유행하는 댄스나 필터 키워드에 맞춘 단기 운영 AI 동영상 사이트 출시 결제 기능을 처음부터 구축하지 않고 Cloudflare에서 유료 이미지-동영상 SaaS 시작 하나의 코드베이스를 공유하고 git merge로 upstream 수정 사항을 반영하는 키워드별 사이트 여러 개 운영
- shrimpreel는 어떻게 설치하나요?
- 템플릿 저장소를 클론합니다: git clone https://github.com/qianshuixia/shrimpreel.git moonhop && cd moonhop 종속성을 설치합니다(npm 11.19 이상): npm install .dev.vars.example을 .dev.vars로 복사하고 SESSION_SECRET을 설정한 다음, 마이그레이션을 적용하고 로컬 R2에 시드 데이터를 추가합니다: npm run seed:local 개발 서버를 시작하고 http://127.0.0.1:3000을 엽니다: npm run dev -- --host 127.0.0.1
- shrimpreel은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/qianshuixia/shrimpreel
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
직접 운영하는 Cloudflare Workers, D1, R2 계정에서 실행되는 셀프 호스팅 종단 간 암호화 임시 파일 공유 서비스입니다.
AI 에이전트에 MCP, HTTP API 또는 TypeScript 라이브러리를 통해 통합 검색, 뉴스 검색, 페이지 추출 기능을 제공하고 공급자 장애 시 대체 경로를 지원하는 셀프 호스팅 검색 게이트웨이입니다.
ArtCraft는 2D 합성과 3D 장면 구성을 지원하는 AI 이미지·영상 제작용 데스크톱 IDE입니다.
자연어 어시스턴트가 텍스트·이미지·비디오 노드를 연결하는 워크플로를 구성하는 무한 캔버스 기반 오픈소스 AI 비디오 제작 작업 공간입니다.
Claude Code와 Cursor 같은 코딩 에이전트가 텍스트, 이미지, URL, 스크립트, 오디오를 완성된 AI 동영상으로 만들도록 돕는 오픈소스 Agent Skills입니다.