leamsigc/ShortsGenerator

Automate the creation of Shorts content locally with a couple simple steps.

ShortsGenerator – 자동화된 YouTube Shorts 제작 도구

기능 설명

  • 텍스트 프롬프트에서 AI로 작성된 스크립트, 스톡 영상, 텍스트 음성 변환(TTS), 자막, 배경 음악 및 선택적 이미지 합성을 사용하여 짧은 형식의 비디오를 생성합니다.
  • Flask 백엔드와 통신하는 웹 UI(Nuxt 3)를 제공합니다. 백엔드는 전체 파이프라인을 실행하고 일련의 REST 엔드포인트를 노출합니다.
  • 비디오가 생성된 후 MagicSync 통합을 통해 여러 소셜 플랫폼(Instagram, TikTok, Facebook, LinkedIn, YouTube)에 게시를 예약할 수 있습니다.

주요 구성 요소

계층 기술 / 역할
백엔드 Python 3.11, Flask, ffmpeg, Torch(Qwen-3 TTS용), g4f/Gemini(스크립트 생성용). 스톡 비디오 검색(Pexels API), TTS(Supertonic, TikTok, KittenTTS, Qwen-3), 자막 렌더링, 비디오 합성 및 MagicSync API 호출을 처리합니다.
프론트엔드 Nuxt 3(Vue) UI, localhost:3000에서 실행됩니다. 주제를 입력하고, 생성된 스크립트를 편집하고, 음성, 자막, 화면 비율, 음악 등을 선택한 다음 문서화된 API를 통해 백엔드를 트리거할 수 있습니다.
AI 모델 • 스크립트: 무료 g4f(브라우저 쿠키 기반) 또는 Gemini(GOOGLE_API_KEY 사용).
• TTS: 로컬 Supertonic(10개 음성, 33개 언어), TikTok TTS(대체), KittenTTS, Qwen-3-TTS(9가지 사전 설정 음색, 음성 디자인, 음성 복제 지원 로컬 모델).
미디어 소스 Pexels의 스톡 클립, 사용자 제공 음악 파일, 비디오 시작 부분의 선택적 이미지 합성.
게시 예약 MagicSync – 여러 비즈니스 계정(API URL + 토큰)을 저장하고 게시 시 사용할 계정을 선택할 수 있습니다.

사용 방법

  1. 저장소를 클론하고 .env.example을 .env로 복사한 후 최소한 PEXELS_API_KEY와 IMAGEMAGICK_BINARY를 입력합니다.
  2. 백엔드(python Backend/main.py)와 Nuxt UI(cd UI && pnpm i && npx nuxt dev --tunnel)를 실행합니다. Docker도 docker compose up -d를 통해 지원됩니다.
  3. 웹 UI에서 비디오 주제를 입력하고, 스크립트를 생성하고, 수정하고, 음성과 자막 스타일을 선택하고, 선택적 이미지나 음악을 추가한 다음 생성을 클릭합니다.
  4. 비디오가 완성되면 썸네일을 추출하고 미리 본 다음 MagicSync를 통해 업로드를 예약할 수 있습니다.

주요 기능

  • 로컬 고품질 모델(Qwen-3) 및 대체 모델을 사용한 다중 음성 TTS.
  • 자동으로 생성되는 자막 템플릿(10가지 시각적 스타일).
  • 세로형 Shorts(9:16) 또는 기타 형식을 위한 화면 비율 유연성.
  • 하드웨어 가속 – GPU를 감지하여 더 빠른 인코딩을 위해 ffmpeg/Torch에 전달합니다.
  • 다중 비즈니스 MagicSync – 클라이언트별로 별도의 API 자격 증명을 저장하고 예약 시 올바른 자격 증명을 선택합니다.

유용한 대상

  • 비디오를 수동으로 편집하지 않고 YouTube Shorts를 대량 생산하려는 콘텐츠 제작자.
  • 여러 브랜드 계정을 관리하고 반복 가능한 파이프라인이 필요한 소규모 에이전시.
  • 엔드투엔드 짧은 형식 비디오 생성 스택의 오픈 소스 참조 구현을 찾는 개발자.

제한 사항

  • Python 3.11과 상당히 무거운 종속성 스택(Torch, Qwen-3 가중치 ≈ 3GB)이 필요합니다.
  • 일부 AI 서비스(Gemini, OpenAI)는 API 키가 필요하며, 무료 g4f 경로는 브라우저 쿠키에 의존합니다.
  • 게시 예약은 독점 MagicSync 서비스에서만 작동하며, 저장소는 일반적인 소셜 미디어 API를 제공하지 않습니다.

라이선스

  • 이 프로젝트는 LICENSE 파일에 있는 라이선스에 따라 배포됩니다(여기에 재현되지 않음).

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트