Colafornia/short-video-generator-AI

short-video-generator-AI

개요 – 오픈소스 Python 도구로, 전체 길이의 YouTube(또는 로컬) 동영상을 하나 이상의 세로형 숏 클립(9:16, 1:1 등)으로 변환합니다. 자동 전사, AI 기반 하이라이트 선택, 선택적 AI 생성 훅, 간단한 비디오 렌더링을 결합합니다. 전체 파이프라인은 LLM 호출을 제외하고 로컬에서 실행되며, OpenAI, Gemini 또는 MuAPI를 사용할 수 있습니다.

주요 기능

• 원라인 CLI – python main.py <YouTube-URL>로 게시 가능한 숏을 생성합니다.
• 웹 UI – 작은 로컬 웹 페이지(shorts-generator-ui.html)에서 여러 동영상을 큐에 넣고 플래그를 시각적으로 조정할 수 있습니다.
• 하이라이트 감지 – 트랜스크립트는 언어 모델에 의해 "바이럴" 신호(감정적 피크, 인용구, 실용적인 팁 등)에 따라 0-100점으로 점수화됩니다.
• AI 생성 훅 – 같은 LLM이 만든 선택적 짧은 인트로로 주의를 끕니다.
• 멀티 프로바이더 LLM 지원 – OpenAI, Gemini 또는 MuAPI; .env 파일에서 LLM_PROVIDER와 해당 API 키를 설정하기만 하면 됩니다.
• 로컬 Whisper 전사 – CPU 또는 CUDA에서 faster-whisper 모델(tiny → large-v3)을 사용합니다.
• 구성 가능한 출력 – 클립 수(--n), 종횡비, 해상도, 언어, 훅 포함 여부.

작동 방식

1. 다운로드 – 소스 동영상(YouTube 또는 로컬 경로)을 가져옵니다.
2. 전사 – faster-whisper로 타임스탬프가 있는 텍스트 파일을 생성합니다.
3. 콘텐츠 유형 분류 – 선택한 LLM을 사용하여(팟캐스트, 인터뷰, 튜토리얼 등) 하이라이트 프롬프트를 조정합니다.
4. 트랜스크립트 세그먼트 점수화 – "바이럴 프레임워크"(훅, 감정적 피크, 폭로 등)를 사용하여 순위가 매겨진 후보를 반환합니다.
5. 중복 제거 – 겹치는 후보를 제거하고 점수가 높은 것만 유지합니다.
6. 상위 N개 클립 선택 – --n으로 지정된 수만큼 선택합니다.
7. 렌더링 – 각 클립을 세로로 렌더링하고, 선택적으로 AI 생성 훅을 앞에 추가하고, output/ 폴더에 저장합니다.

일반적인 워크플로

# 클론 및 설정
git clone https://github.com/Colafornia/short-video-generator-AI.git
cd short-video-generator-AI
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# LLM 키로 .env 생성
cat > .env <<EOF
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-…
LOCAL_WHISPER_MODEL=base
EOF

# YouTube 동영상에서 3개의 숏 생성
python main.py "https://www.youtube.com/watch?v=abc123" --n 3 --ratio 9:16

웹 UI를 사용하려면 python3 server.py를 실행하고 web/ 폴더를 제공한 다음 http://localhost:8000/shorts-generator-ui.html을 엽니다.

사용 대상

• 상용 숏 비디오 생성기(예: OpusClip, Vidyo.ai)의 무료 대안을 원하는 콘텐츠 제작자.
• 기존 장편 동영상을 TikTok/YouTube-Shorts 형식으로 일괄 처리해야 하는 소규모 팀.
• 자체 파이프라인에 숏 클립 생성을 포함할 API 우선 방식을 원하는 개발자.

제한 사항

• 하이라이트 점수화와 훅 생성에 외부 LLM API에 의존합니다. OpenAI 또는 MuAPI에는 유료 키가 필요하며, Gemini의 무료 티어는 제한적입니다.
• 하이라이트 품질은 저장소 내 프롬프트 설계에 크게 의존하며, 틈새 "바이럴" 순간을 놓칠 수 있습니다.
• 비디오 렌더링은 내부적으로 ffmpeg 스타일 명령으로 수행되므로 성능은 하드웨어에 따라 달라집니다.
• 소스 동영상의 워터마크 제거 기능은 내장되어 있지 않으며, 원본 영상을 단순히 크롭합니다.

라이선스 – MIT(무료 사용, 수정, 재배포 가능).