naqashafzal/AI-Content-Studio

A 100% free & open-source AI Content Automation Tool that writes scripts, generates voiceovers, creates videos, and uploads them automatically — hands-free YouTube growth powered by AI.

🎬 AI Content Studio – 차세대 (v2.0)

개요 – 비디오, 팟캐스트 및 숏폼 클립을 자동으로 생성할 수 있는 오픈소스 데스크톱/웹 애플리케이션입니다. AI 에이전트(조사, 스크립트 작성, 품질 검사 등)와 미디어 처리 파이프라인을 연결하여 트렌드 주제에서 캡션, 브랜딩 및 선택적 B-roll이 포함된 완성된 라우드니스 정규화 비디오까지 수동 편집 없이 생성할 수 있습니다.

핵심 기능

기능	제공 내용
자율 AI 디렉터	주제를 조사하고, 스크립트를 작성하고, 사실 정확성과 내러티브 흐름을 확인하고, 고가의 미디어가 생성되기 전에 낮은 점수의 장면을 다시 쓸 수 있는 감독형 멀티 에이전트 시스템(`StrategyAgent`, `TrendDiscoveryAgent`, `ResearchAgent`, `CreativeDirectorAgent`, `QualityAssuranceAgent`, `LearningAgent`).
대화형 스토리보드	장면 카드에 내레이션, 시각적 프롬프트, 프레이밍 노트 및 오디오 큐가 표시됩니다. 마음에 드는 장면을 잠그고 자연어 지시로 단일 샷 재생성을 디렉터에게 요청할 수 있습니다.
Magic AI Clipper 2.0	긴 YouTube 비디오, 팟캐스트 또는 스트림을 세로형 숏츠로 변환합니다. Whisper 전사, 오디오 볼륨 피크 및 OpenCV 색상 히스토그램 컷을 융합하여 "바이럴 순간"을 찾고, 활성 화자를 추적하고, 스톡 B-roll을 주입하고, 노래방 스타일 캡션을 번인합니다.
스타일 복제 엔진	참조 비디오(예: MrBeast 또는 Vox 클립)를 업로드합니다. 시스템은 샷 길이, 컷 빈도 및 캡션 애니메이션을 분석한 다음 새 콘텐츠에 적용할 수 있는 재사용 가능한 스타일 프로필을 만듭니다.
비선형 타임라인 및 리플 편집기	텍스트 기반 편집: 대본에서 단어를 삭제하면 기본 비디오/오디오가 자동으로 트리밍됩니다. AI 어시스턴트는 "페이스 올리기" 또는 "이 섹션 음소거"와 같은 평이한 영어 명령도 허용합니다.
오디오 마스터링 및 우르두어 지원	YouTube/TikTok 표준을 위한 FFmpeg EBU-R128 라우드니스 정규화와 TTS용 우르두어 및 로마자 우르두어 텍스트를 올바르게 발음하는 음성 엔진.
탄력적인 SQLite 큐	작업은 단계별로 저장되므로(`research → storyboard → qa_review …`) 충돌이나 재시작으로 진행 상황이 손실되지 않습니다.
멀티 모델 게이트웨이	Google Gemini, OpenAI 호환 서비스 또는 로컬 Ollama 모델과 통신할 수 있는 통합 API 레이어로 자동 장애 조치를 지원합니다.
자동 조종 캠페인	백그라운드 봇이 트렌드를 지속적으로 스캔하고 콘텐츠 생성을 예약할 수 있어 24/7 채널 운영에 유용합니다.
유틸리티 도구 상자	독립형 캡션 버너, 화면 비율 변환기(9:16, 16:9, 1:1) 및 사전 설정 음성이 포함된 TTS 생성기.

아키텍처 개요

프론트엔드 – Next.js (React) + Turbopack, 바닐라 CSS + 글래스모피즘 UI, 에이전트 로그 및 타임라인 동기화를 위한 실시간 WebSocket 업데이트.
백엔드 – FastAPI + Uvicorn (Python 3.10+). SQLite + SQLAlchemy가 작업 큐와 체크포인트를 저장합니다.
미디어 처리 – 모든 비디오/오디오 작업에 FFmpeg, 소스 미디어 다운로드에 yt-dlp, 전사에 OpenAI Whisper(오프라인), 자막 생성에 pysubs2, 화자 추적 및 히스토그램 기반 컷 감지에 OpenCV.
AI 오케스트레이션 – 선택한 LLM 공급자(Gemini, OpenAI, Ollama)로 프롬프트를 라우팅하고 응답을 에이전트에 반환하는 경량 "게이트웨이".

빠른 시작

클론 및 설치

git clone https://github.com/naqashafzal/AI-Content-Studio.git
cd AI-Content-Studio
# Python 환경
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
# 프론트엔드 종속성
cd web && npm install && cd ..

실행 – Windows에서는 제공된 start.bat이 모든 작업을 수행합니다(Python/Node/FFmpeg 확인, localhost:8008에서 API 시작, localhost:3000에서 UI 시작). 다른 OS에서는 별도의 터미널에서 두 서버를 시작할 수 있습니다:
```
# 백엔드
python server/main.py   # FastAPI
# 프론트엔드 (/web 내)
npm run dev
```
http://localhost:3000을 열고 UI에 따라 새 캠페인을 만들고 트렌드를 선택한 다음 자율 에이전트가 비디오를 구축하는 것을 지켜보세요.

누가 혜택을 받을까요?

콘텐츠 제작자 – 비디오 편집 도구를 배우지 않고 숏폼 비디오 제작을 확장하려는 분.
마케터/에이전시 – 특정 시각적 스타일과 일치하는 신속한 브랜드 비디오 광고가 필요한 분.
교육자/설명 비디오 제작자 – 스크립트에서 내레이션 비디오까지 핸즈프리 파이프라인을 찾는 분.
개발자 – 멀티 에이전트 오케스트레이션, 멀티모달 미디어 분석 또는 제공된 API 위에 구축하는 데 관심이 있는 분.

제한 사항 및 주의 사항

시스템은 외부 LLM API(Gemini, OpenAI, Ollama)에 의존합니다. 선택한 공급자의 유효한 API 키가 필요합니다.
"자동 조종" 트렌드 스캐너는 단순한 스크레이퍼입니다. 소스 데이터가 노이즈가 많으면 틈새 주제를 놓치거나 저품질 아이디어를 생성할 수 있습니다.
모든 무거운 미디어 작업(FFmpeg 트랜스코딩, Whisper 전사)은 로컬에서 실행되므로 고해상도 비디오에는 적절한 CPU/GPU와 충분한 디스크 공간이 필요합니다.

커뮤니티 및 지원

이 프로젝트는 MIT 라이선스로 공개 개발됩니다. 저자는 튜토리얼과 업데이트를 위해 Patreon, Instagram 및 YouTube 채널을 제공합니다. 전체 테스트 스위트(pytest)는 19/19 통과를 보고하며, 저장소에는 큐 복구 및 비밀 처리 스크립트가 포함되어 있습니다.

결론 – AI Content Studio는 멀티 에이전트 AI 계획과 강력한 비디오 처리 파이프라인을 결합한 상당히 완전하고 프로덕션 준비가 된 스택으로, 비기술적 제작자가 최소한의 수동 작업으로 세련된 숏폼 비디오를 생성할 수 있게 해줍니다.