ChaitanyaEswarRajeshJakki/gemini-youtube-automation

A fully autonomous AI Agent/Python pipeline that utilizes Large Language Models (LLMs) like Gemini to generate content, produce videos, and automatically upload educational videos to YouTube.

What it solves

이 프로젝트는 교육용 YouTube 콘텐츠의 제작 및 게시 전체 과정을 자동화합니다. 수동 스크립트 작성, 영상 편집, 내레이션, 업로드가 필요 없으며, 채널이 매일 완전 자동으로 운영될 수 있습니다.

How it works

시스템은 GitHub Actions에서 스케줄된 파이프라인으로 동작합니다. 다음 단계로 진행됩니다:

  1. Planning: content_plan.json 파일을 읽어 다음 대기 중인 레슨을 식별합니다.
  2. Scripting: Gemini 2.5 Flash가 다중 슬라이드 스크립트, YouTube Shorts용 짧은 버전, 필요한 메타데이터(제목 및 해시태그)를 생성합니다.
  3. Production: 봇은 gTTS를 사용해 내레이션을 만들고, Pexels API를 통해 관련 배경 이미지를 가져와 MoviePy와 PIL로 배경 음악이 포함된 긴 형식(16:9) 및 짧은 형식(9:16) 영상을 렌더링합니다.
  4. Distribution: 최종 영상과 자동 생성된 썸네일을 YouTube Data API v3를 통해 YouTube에 업로드합니다.
  5. Maintenance: 레슨이 완료되었음을 표시하기 위해 콘텐츠 플랜을 저장소에 업데이트하고 변경 사항을 GitHub에 커밋합니다.

Who it’s for

수동 제작 비용 없이 자율적인 교육 채널을 구축하고자 하는 콘텐츠 제작자와 개발자를 위한 프로젝트입니다.

Highlights

  • Zero-touch operation: GitHub Actions cron 스케줄을 통한 완전 자동 실행.
  • Dual-format output: 하나의 레슨에서 표준 긴 형식 영상과 YouTube Short를 동시에 생성.
  • Dynamic visuals: 슬라이드 주제에 맞는 Pexels 스톡 이미지를 자동으로 매칭.
  • Self-updating: 저장소에 직접 커밋하여 콘텐츠 큐를 자체 관리.