linyqh/NarratoAI

어떤 프로젝트인가요?

핵심 기능

• 01LLM으로 영상 콘텐츠를 바탕으로 내레이션 대본을 생성합니다.
• 02영상을 자동으로 편집하고 소스 영상을 병합합니다.
• 03음성 복제를 포함한 여러 TTS 엔진으로 음성 해설을 생성합니다.
• 04원클릭 음성 텍스트 변환으로 자막을 생성합니다.
• 05CapCut (剪映)으로 초안을 내보내 추가 편집을 지원합니다.
• 06Windows, macOS 또는 Docker에서 로컬 Streamlit 웹 UI로 실행됩니다.

활용 사례

• 영화 및 TV 영상 클립의 해설이나 요약 영상을 제작합니다.
• 숏드라마 영상을 리믹스해 새로운 내레이션 에피소드를 만듭니다.
• 소셜 플랫폼용 음성 해설·자막 영상을 일괄 제작합니다.

빠른 시작

1. 1

   저장소를 클론합니다

   git clone https://github.com/linyqh/NarratoAI.git
2. 2

   프로젝트 디렉터리로 이동합니다

   cd NarratoAI
3. 3

   Docker Compose로 배포합니다

   docker compose up -d
4. 4

   브라우저에서 http://localhost:8501을 엽니다

사용 전 알아둘 점

• !스크립트 및 내레이션 기능을 사용하려면 먼저 config.toml에서 본인의 LLM API 키를 설정해야 합니다.
• !로컬에서 실행하려면 Python 3.12 이상이 필요합니다.
• !일부 음성 복제 엔진(IndexTTS-1.5 MLX, IndexTTS-2 MLX)은 Apple Silicon Mac에서만 사용할 수 있으며, IndexTTS-2 Windows 패키지는 아직 업데이트되지 않았습니다.

토픽

자주 묻는 질문

NarratoAI은(는) 무엇인가요?

해설형 콘텐츠를 위해 내레이션 대본을 작성하고 음성 해설과 자막을 생성해 영상을 자동 편집하는 AI 도구입니다. NarratoAI는 내레이션이 포함된 영상 해설을 자동으로 제작하는 도구입니다. LLM으로 대본을 작성한 뒤, 영상 자르기부터 음성 해설 생성과 자막 제작까지 편집 작업 전반을 하나의 파이프라인에서 처리합니다.

NarratoAI은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

NarratoAI은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

NarratoAI은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. NarratoAI의 마지막 커밋은 2026년 10월 19일입니다.

NarratoAI은(는) 어디에 사용할 수 있나요?

영화 및 TV 영상 클립의 해설이나 요약 영상을 제작합니다. 숏드라마 영상을 리믹스해 새로운 내레이션 에피소드를 만듭니다. 소셜 플랫폼용 음성 해설·자막 영상을 일괄 제작합니다.

NarratoAI는 어떻게 설치하나요?

저장소를 클론합니다: git clone https://github.com/linyqh/NarratoAI.git 프로젝트 디렉터리로 이동합니다: cd NarratoAI Docker Compose로 배포합니다: docker compose up -d 브라우저에서 http://localhost:8501을 엽니다

NarratoAI은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/linyqh/NarratoAI