AkshitIreddy/AI-Powered-Video-Tutorial-Generator

Create and edit AI video tutorials with illustrated lessons, expressive presenters, distinct voices, and a native timeline. Windows desktop app with local models and cloud providers.

TL;DR

AI 기반 비디오 튜토리얼 생성기는 Windows 전용 데스크톱 앱으로, 질문, 주제 또는 소스 자료를 완전히 편집 가능한 비디오 수업으로 변환할 수 있습니다. 연구, 스크립트 작성, 스토리보드 생성, 내레이션, 일러스트레이션, 발표자 애니메이션 및 최종 내보내기까지, 하나의 그래픽 워크스페이스에서 처리합니다. 이 도구는 필요한 Python, Node, Chromium, FFmpeg 런타임을 함께 제공하며, 로컬에서 AI 모델을 실행(ComfyUI/SDXL을 통해)하거나 클라우드 제공업체를 호출하여 텍스트, 연구 및 이미지 생성을 수행할 수 있습니다.

무엇을 하는가 (비전문가를 위한 설명)

아이디어부터 시작 – 질문, 주제, 또는 소스 텍스트를 입력합니다.
수업 계획하기 – 대상 청중, 길이, 시각 스타일, AI "프로필"을 선택합니다. 앱은 목표, 증거, 개요, 스크립트를 생성하여 각 단계를 검토할 수 있게 합니다.
발표자 선택하기 – 최대 4명의 만화/현실적/동물형 호스트를 선택할 수 있습니다. 내장 갤러리 사용 또는 자체 포트레이트 업로드 가능. 선택적으로 로컬 "SoulX" 모델로 애니메이션 생성.
미디어 생성하기 – 앱은 다음을 수행할 수 있습니다:
- 클라우드 LLM(예: Groq, Gemini, Mistral 등)을 통해 텍스트 작성 및 연구
- 로컬 Stable Diffusion-XL(ComfyUI) 또는 클라우드 이미지 서비스로 일러스트 생성
- 내레이션 및 자막 합성
- 애니메이션 발표자 클립 및 전체 장면 비디오 렌더링
타임라인에서 편집하기 – 비디오 프레임, 파형, 자막, 미디어를 함께 볼 수 있습니다. 변경 사항은 리비전을 생성하고, 의존하는 부분만 재생성합니다.
내보내기 – 비디오 파일과 함께 자막, 전사본, 참고문헌, 챕터, 썸네일, 그리고 전체 프로젝트 상태를 포함한 포터블한 "*.alytutorial" 아카이브를 출력합니다.

모든 프로젝트 파일은 컴퓨터에만 보관되며, 필수 온라인 계정은 없습니다.

누구를 위한가

사용자 유형	왜 중요한가
교육자 / 트레이너	비디오 편집 팀 없이도 빠르게 완성도 높은 비디오 수업을 제작할 수 있습니다.
교육 설계자	미디어 생성 전에 목표, 증거, 인용을 명확히 정의하도록 유도하는 안내된 계획 워크플로우를 제공합니다.
콘텐츠 크리에이터	발표자 아바타를 재사용하고, 스타일을 교체하며 최종 편집을 완전히 제어할 수 있습니다.
개발자 / 고급 사용자	오픈소스 코드, Tauri-React UI, Rust 코어, 확장 또는 교체 가능한 Python 파이프라인을 제공합니다.

작동 방식 (고수준 아키텍처)

프론트엔드 – Tauri 창(Chromium 기반) 내에서 실행되는 React + TypeScript UI.
Rust 코어 – 프로젝트 메타데이터, 다운로드, 자격 증명 저장, 워커 프로세스 감시를 담당. 타입 지정된 IPC 명령을 통해 UI와 통신.
Python 파이프라인 – 프로젝트 SQLite 데이터베이스에 쓰는 유일한 구성 요소. 연구, LLM 프롬프팅, 리비전 추적, QA 검사, 내보내기 로직을 실행.
미디어 워커 –
- ComfyUI/SDXL – 로컬 이미지 생성 (약 10GB 모델 팩).
- SoulX-FlashHead Pro – 발표자 애니메이션 (8개의 사전 승인된 아바타).
- FFmpeg – 비디오/오디오 조합.
클라우드 제공업체 (옵션) – 텍스트/연구용 LLM 및 추가 일러스트 또는 라이선스된 스톡 미디어용 이미지 API. 사용자는 자체 API 키 제공 (BYOK).

모든 무거운 바이너리는 Windows 설치 프로그램에 포함되어 있어, 최종 사용자는 Python, Node, 기타 런타임을 수동으로 설치할 필요가 없습니다.

시작하기 (사용자 관점)

최신 릴리스(v1.8.1)에서 설치 프로그램을 다운로드합니다.
설치 프로그램 실행 – 앱과 선택적 모델 팩 (~25GB)을 설치합니다.
시작 메뉴에서 AI Video Tutorial Generator를 실행합니다.
온보딩 워크플로우를 따라,
- 로컬 이미지 생성을 원하면 ComfyUI/SDXL 모델 팩을 다운로드합니다.
- 사용할 클라우드 API 키를 설정합니다.
새 프로젝트를 만들고 주제를 입력한 후 AI가 수업 계획을 생성하도록 합니다.
각 단계를 검토하고 스크립트나 스토리보드를 조정한 후 Generate를 눌러 미디어를 생성합니다.
필요에 따라 타임라인을 편집한 후 내보냅니다.

강점과 제한 사항

강점	제한 사항
아이디어에서 내보내기까지의 종단 간 워크플로우를 하나의 데스크톱 앱에서 제공합니다.	Windows 전용; macOS/Linux 빌드는 아직 없음.
로컬 (API 요금 없음) 및 클라우드 AI 옵션을 모두 제공하여 프라이버시 또는 비용 측면에서 유연성을 제공합니다.	로컬 생성에는 중급 이상의 GPU(≥12GB VRAM)와 약 10GB 모델 다운로드가 필요합니다.
리비전 인식 파이프라인 – 변경된 자산만 재생성합니다.	발표자 애니메이션은 8개 아바타에 대해 즉시 작동하지만, 커스텀 아바타는 미리보기 단계가 필요하며 실패할 수 있습니다.
포터블 프로젝트 아카이브(.alytutorial)는 모든 자산과 출처를 함께 유지합니다.	협업 또는 클라우드 동기화 기능이 내장되어 있지 않음; 공유는 수동 파일 전송 필요.
오픈소스(MIT 라이선스), Rust, Python, TypeScript 구성 요소 간 명확한 분리 제공.	설치 프로그램은 Authenticode 서명되지 않아 Windows에서 "알 수 없는 발행자" 경고가 표시됨.

기여 방법 (개발자 시각)

리포지토리 복제 후 Windows PowerShell 부트스트랩 스크립트(bootstrap.ps1)를 따릅니다.
스택은 Node 24, pnpm 10, Python 3.12, Rust 1.96, Tauri 프레임워크를 사용합니다.
pnpm dev를 실행하여 파이프라인 워커와 함께 전체 데스크톱 앱을 시작합니다.
테스트에는 린팅, 타입 체크, 유닛/종단 간 테스트, 결정론적 렌더링 테스트 포함. GPU 또는 제공업체의 실시간 테스트는 수동으로 실행해야 합니다.
새 버전을 배포하려면 node scripts/set-release-version.mjs로 버전을 업데이트하고 태그를 지정한 후 GitHub Actions 워크플로우가 Windows 설치 프로그램을 빌드하고 서명하도록 합니다.

결론

AI 기반 비디오 튜토리얼 생성기는 LLM 기반 연구, 로컬 확산 이미지 생성, 애니메이션 발표자 아바타를 통합하여 편집 가능한 비디오 수업을 생성하는 진정한 풀스택 데스크톱 애플리케이션입니다. 교육자와 크리에이터를 위한 자체 완결형 Windows 도구이며, 로컬 및 클라우드 AI 옵션을 제공하며, 개발자가 파이프라인을 확장하거나 커스터마이징할 수 있는 오픈소스 코드베이스를 제공합니다.

위 정보는 리포지토리의 README에서 직접 가져왔으며, 외부 주장은 추가되지 않았습니다.