Repolode
qianshuixia

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. 1

    템플릿 저장소를 클론합니다

    git clone https://github.com/qianshuixia/shrimpreel.git moonhop && cd moonhop
  2. 2

    종속성을 설치합니다(npm 11.19 이상)

    npm install
  3. 3

    .dev.vars.example을 .dev.vars로 복사하고 SESSION_SECRET을 설정한 다음, 마이그레이션을 적용하고 로컬 R2에 시드 데이터를 추가합니다

    npm run seed:local
  4. 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 통계는 매일 갱신됩니다.

관련 프로젝트