README.md

metadata

title: YouTube Script Extractor
emoji: 🎬
colorFrom: red
colorTo: yellow
sdk: docker
app_port: 7860

🎬 YouTube Script Extractor

YouTube 영상에서 스크립트를 추출하고, AI로 깔끔하게 정리하는 도구입니다.

✨ 주요 기능

• 자동 스크립트 추출 — YouTube URL만 입력하면 음성을 텍스트로 변환
• AI 마크다운 정리 — LLM이 스크립트를 구조화된 마크다운으로 정리
• 다국어 번역 — 14개 언어 지원 (한국어, 영어, 일본어 등)
• 키프레임 분석 (CV) — 영상의 핵심 장면을 추출하고 Vision AI로 분석
• Smart Mix — 파이프라인 단계별로 다른 LLM을 지정 가능
• 웹 UI + CLI — 브라우저 기반 UI와 커맨드라인 모두 지원

🤖 지원 LLM

모델	가격	Vision	비고
Ollama (로컬)	무료	❌	인터넷 불필요
Gemini 2.5 Flash-Lite	$0.10/1M토큰	✅	⭐ 최저가
Gemini 3.1 Flash-Lite	$0.25/1M토큰	✅	최신 모델
GPT-4o-mini	$0.15/1M토큰	✅	OpenAI
Claude Sonnet 4.6	$3/1M토큰	✅	고품질
Claude Opus 4.6	$5/1M토큰	✅	최고 품질

🚀 빠른 시작

1. 설치

git clone https://huggingface.co/spaces/YOUR_USERNAME/youtube-script-extractor
cd youtube-script-extractor

# ffmpeg 설치 (macOS)
brew install ffmpeg

# Python 의존성 설치
pip install -r requirements.txt

2. API 키 설정

cp .env.example .env
# .env 파일을 열어 사용할 LLM의 API 키를 입력하세요

3. 실행

# 웹 UI (추천)
chmod +x run
./run

# 또는 직접 실행
python3 web.py

브라우저에서 http://localhost:8000 접속

CLI 모드

./run "https://www.youtube.com/watch?v=VIDEO_ID"
./run "https://www.youtube.com/watch?v=VIDEO_ID" --mode local --format srt

⚙️ 설정

.env 파일에서 설정합니다:

# 필수: Whisper API용
OPENAI_API_KEY=sk-proj-...

# 선택: 사용하는 LLM만 설정
GOOGLE_API_KEY=...        # Gemini
ANTHROPIC_API_KEY=...     # Claude

# 기본 설정
DEFAULT_MODE=api          # api 또는 local
DEFAULT_MODEL=base        # Whisper 모델 (tiny/base/small/medium/large)
PORT=8000

📁 프로젝트 구조

├── run                 # 실행 스크립트 (설치 + 실행)
├── web.py              # FastAPI 웹 서버
├── cli.py              # CLI 인터페이스
├── transcriber.py      # 음성 추출 + STT + 키프레임 추출
├── formatter.py        # LLM 호출 + 마크다운 정리 + 번역
├── templates/
│   └── index.html      # 웹 UI
├── requirements.txt    # Python 의존성
├── .env.example        # 환경 변수 템플릿
└── output/             # 추출 결과물 (git 제외)

🔧 Smart Mix (단계별 LLM 선택)

웹 UI의 ⚙ 버튼으로 파이프라인 단계별 LLM을 설정할 수 있습니다:

• MD 정리 — 스크립트를 마크다운으로 구조화 (저렴한 모델 OK)
• 번역 — 다국어 번역 (저렴한 모델 OK)
• 키프레임 분석 — Vision AI로 화면 분석 (Vision 지원 모델 필요)

📋 요구사항

• Python 3.9+
• ffmpeg
• API 키 (사용하려는 LLM에 따라)

📄 License

MIT