sitor-ai/frametell

Frametell: turn your ideas and material into vivid explainer videos with an AI director agent. Local-first, any model.

Frametell – AI 기반 설명 영상 제작 도구

개요

macOS(Apple Silicon) 데스크톱 앱 및 CLI 도구로, 짧은 아이디어, 메모, PDF, 슬라이드 또는 이미지를 1080p 내레이션 영상으로 변환합니다.
디렉터 에이전트(LLM)를 사용하여 스토리보드를 작성하고, 대본을 쓰고, 음성을 생성하며, 선택한 비주얼 스타일로 각 페이지를 그리고, 마지막으로 영상을 렌더링합니다.
모든 처리는 로컬에서 실행되며, LLM 및 TTS 서비스만 사용자가 제공한 API 키를 통해 호출됩니다.

중요성

지식 크리에이터가 비디오 편집 소프트웨어를 배우지 않고도 완성도 높은 설명 영상을 제작할 수 있습니다.
렌더링 전에 스토리보드를 검토하고 편집할 기회를 제공하여 API 토큰 낭비를 줄입니다.
다양한 LLM 제공업체(Anthropic, OpenAI, Google Gemini, DeepSeek, OpenRouter 등) 및 ElevenLabs 또는 Volcengine TTS 음성 지원과 호환됩니다.

주요 기능(README에 설명된 대로)

스토리보드 생성 – LLM이 입력을 페이지 및 스토리 비트 시퀀스로 변환하며, 승인하거나 편집할 수 있습니다.
내레이션 및 음성 – 자동 대본 작성 및 선택적 음성 합성(영어는 ElevenLabs, 중국어는 Volcengine).
페이지 그리기 – 여러 내장 스타일(warm-story, study, chalkboard, whiteboard, tech-dark) 중 하나로 각 프레임을 생성합니다.
품질 검사 – 각 페이지에 대한 린트 및 스크린샷 미리보기, 렌더링 전 최종 비디오 검사.
로컬 실행 – 데이터와 API 키가 기기를 벗어나지 않으며, 무거운 작업(비디오 렌더링)은 번들된 FFmpeg와 헤드리스 Chromium/Edge 인스턴스로 수행됩니다.
교차 모델 지원 – OpenAI 또는 Anthropic 호환 엔드포인트를 플러그인할 수 있습니다.
내보내기 – 자막 및 게시 노트가 포함된 1080p MP4.

작동 방식(단계별)

시작하기

macOS(Apple Silicon) – 최신 릴리스에서 서명된 .dmg를 다운로드하여 설치한 후, 설정에서 LLM 및 ElevenLabs API 키를 추가합니다.
소스에서 – 저장소를 클론하고, Node 22+, pnpm, Chromium 기반 브라우저를 설치합니다. pnpm install && pnpm build를 실행하고, 필요한 환경 변수(ANTHROPIC_API_KEY, ELEVENLABS_API_KEY 등)를 설정한 후, node apps/cli/dist/cli.js serve로 웹 UI를 시작하거나 node apps/cli/dist/cli.js run notes.pdf --style warm-story --duration 60 --lang en으로 직접 비디오를 생성합니다.

커뮤니티 및 지원

라이선스

AGPL-3.0 – 무료로 사용, 수정, 실행할 수 있지만, 네트워크 배포 수정본도 오픈소스여야 합니다. 상업용 라이선스는 요청 시 제공됩니다.

Frametell은 짧은 설명 영상을 만드는 엔드투엔드 파이프라인을 자동화하는 진정한 AI 기반 도구로, 생성형 AI 및 멀티모달 콘텐츠 제작의 최전선에 있습니다.