본문으로 건너뛰기
오픈소스 전체 목록

MoneyPrinterTurbo

  • 추천0
  • GitHub 별144K
  • 영상라이선스MIT

주제나 키워드만 넣으면 대본 · 자료 영상 · 자막 · 음성 · 배경음악까지 만들어 쇼츠를 뽑아 주는 올인원 AI 영상 생성기. MIT

원본:harry0703/MoneyPrinterTurbo

요약

주제나 키워드만 넣으면 대본 · 자료 영상 · 자막 · 음성 · 배경음악까지 만들어 쇼츠를 뽑아 주는 올인원 AI 영상 생성기. MIT

설명

MoneyPrinterTurbo 💸

올인원 AI 쇼츠 영상 생성기

영상 주제나 키워드를 입력하면 MoneyPrinterTurbo가 대본을 쓰고, 자료 영상을 맞추고, 자막과 배경음악을 만들어 HD 쇼츠 영상까지 완성해 줍니다.

버전 플랫폼 Python 다운로드 수

화면 미리보기 🖥️

웹 화면(WebUI)

웹 화면 스크린샷

API

API 문서 스크린샷


주요 기능 🎯

만드는 방식

  • AI 에이전트, 웹 화면, API, 명령줄(CLI) 중 원하는 방식으로 빠르게 만들거나 자동화해서 생산할 수 있습니다.
  • 주제에서 대본, 내레이션, 자료 영상, 자막, 음악, 편집까지 자동으로 이어지면서도 각 단계를 직접 조절할 수 있습니다.
  • 여러 결과물을 한 번에 만들고, 작업 기록을 보고, 생성 설정과 API 키를 가져오거나 내보낼 수 있습니다.
  • 대본 생성, 내레이션, 자료 내려받기, 클립 처리, 최종 렌더링까지 진행 상황을 볼 수 있습니다.

대본과 모델 공급자

  • ChatGPT 구독을 OpenAI - Codex로 연결해 기기 코드 로그인과 모델 선택기로 쓸 수 있습니다.
  • 공식 앱 인증과 계정별 모델이 필요하면 ChatGPT Native OAuth를 직접 선택합니다(계정 · 워크스페이스 자격과 로컬 브라우저 환경이 필요).
  • AI로 다국어 영상 대본을 만들거나 고쳐 쓰고, 완성된 대본을 직접 넣을 수도 있습니다.
  • Kimi / Moonshot AI, OpenAI, Anthropic Claude, Google Gemini, DeepSeek, 알리바바 클라우드 Qwen, Microsoft Azure OpenAI, 바이트댄스 VolcEngine Ark, xAI Grok, MiniMax, Muse Spark, iFlytek Spark, Xiaomi MiMo 같은 주요 공급자를 지원합니다.
  • OpenRouter, Ollama, LiteLLM, OneAPI, Groq, Pollinations AI 등 호환 게이트웨이나 로컬 실행 환경도 연결할 수 있습니다.

영상과 이미지 자료

  • 내 이미지와 영상을 올리거나, Pexels(무료) · Pixabay(무료) · Coverr에서 HD 스톡 영상을 가져옵니다.
  • Metaso MiniMax H3로 768P 또는 2K 원본 영상을 만듭니다. 4~15초 길이, 9:16 · 16:9 · 1:1 비율을 지원합니다.
  • Volcano Engine Ark Seedance 연동으로 대본 문단별로 어울리는 장면을 생성합니다.
  • WaveSpeed AI, OFox(Seedance · Wan 등), MuAPI(3~12초 비동기 텍스트-영상), useapi.net(Veo 3.1 · Kling · Seedance 등)으로 AI 영상 자료를 만들 수 있습니다.
  • OpenAI 호환 텍스트-이미지 서비스, 맞춤 이미지 게이트웨이, 저장소에 들어 있는 로컬 SDXL 이미지 서버를 연결하고, 정지 화면 또는 천천히 확대되는 움직임을 고를 수 있습니다.
  • 클립 길이 · 재생 속도 · 전환 효과를 조절하고, 화면 채우기(잘라내기) 또는 레터박스 맞춤, 무작위 또는 순서대로 자료 배치를 고릅니다.
  • 선택 사항으로 TwelveLabs로 스톡 영상 검색어를 영상 주제에 맞게 다시 정렬할 수 있습니다.

내레이션 · 자막 · 배경음악

  • 자동 내레이션, 올린 오디오, 내레이션 없음 중에서 고르고, 목소리 샘플과 전체 내레이션 미리 듣기를 지원합니다.
  • **Edge TTS(무료 · API 키 불필요)**를 비롯해 Azure Speech, SiliconFlow, Google Gemini, Xiaomi MiMo, MiniMax, ElevenLabs, Chatterbox, Kokoro, Fish Audio, ModelBest VoxCPM 등 다양한 음성 서비스를 쓸 수 있습니다.
  • ModelBest VoxCPM은 참고 오디오로 목소리를 복제하고, Edge TTS는 [pause: 2s] 같은 태그로 쉬는 구간을 조절합니다.
  • TTS 시간 정보 또는 로컬 Whisper 받아쓰기로 자막을 만들고, 문장 또는 단어별 표시, 팝업 스프링 애니메이션, 글꼴 · 위치 · 색 · 크기 · 외곽선 · 배경 스타일을 설정합니다.
  • 무작위 음악, 미리 듣는 기본 곡, 내 음악 파일을 쓰고, Sonilo나 ElevenLabs Video-to-Music으로 영상에 맞는 음악을 만들 수 있으며 음량을 따로 조절합니다.

출력과 게시

  • 세로 9:16 (1080×1920), 가로 16:9 (1920×1080), 정사각형 1:1 (1080×1080) 영상을 내보냅니다.
  • 완성한 영상을 TikTok, Instagram, YouTube Shorts에 바로 올릴 수 있습니다.
  • LLM으로 게시용 제목 · 설명 · 해시태그를 만들고, YouTube 공개 범위와 아동용 여부를 설정합니다.
  • 별도의 로컬 영상 프로젝트 CLI로 장면을 고치고 버전을 비교하며, 바뀌지 않은 렌더 결과를 재사용합니다.

시스템 요구 사항 📦

  • 권장 환경: Windows 10 이상, macOS 11 이상, 주요 Linux 배포판.
  • 로컬 배포에는 Python 3.11 이상이 필요하고 3.11을 권장합니다.
  • GPU는 필수가 아니지만, 로컬 받아쓰기와 영상 처리를 빠르게 하려면 권장합니다.
항목최소권장최적
CPU4코어6~8코어8코어 이상
RAM4 GB8 GB16 GB 이상
GPU불필요VRAM 4 GB 이상VRAM 8 GB 이상
  • 클라우드 LLM, 클라우드 TTS, 온라인 자료를 주로 쓴다면 GPU보다 CPU와 RAM이 더 중요합니다.
  • faster-whisper, 대량 생성, 무거운 로컬 처리를 쓴다면 GPU가 처리량을 크게 높여 줍니다.

빠른 시작 🚀

추천 경로

  • 직접 설치하고 설정하기 싫다면: AI 에이전트로 영상을 만드세요.
  • 이미 Python이 있다면: 공식 패키지를 pip로 설치하세요.
  • Windows 사용자: 한 번에 설치 묶음이 가장 빠른 체험 방법입니다.
  • 소스 배포나 개발: uv로 환경과 의존성을 관리하세요.
  • 더 분리된 환경을 원하면: Docker 배포를 쓰세요.

AI 에이전트로 영상 만들기

Skill 문서를 읽고 로컬 터미널을 다룰 수 있는 AI 에이전트에게 아래 프롬프트를 보내면, 에이전트가 MoneyPrinterTurbo를 설치 · 설정하고 영상을 만든 뒤 파일 경로를 알려 줍니다. 아직 설정되지 않은 필수 API 키만 물어봅니다. 현재 macOS와 Windows를 지원합니다.

Use this Skill: https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/SKILL.md
Create a video with the topic "How AI is changing everyday life."

Google Colab에서 실행

로컬 환경을 만들지 않고 Colab 노트북으로 바로 써 볼 수 있습니다.

Windows

GitHub 릴리스에서 최신 Windows 한 번에 설치 묶음을 받아 그대로 압축을 풉니다. Assets의 .7z 파일을 받으세요. 자동 생성되는 Source code 압축 파일에는 소스만 들어 있어 start.bat과 update.bat이 없습니다. 먼저 update.bat을 더블클릭해 최신 코드로 맞춘 뒤 start.bat을 실행하세요. 브라우저가 자동으로 열리며, 빈 화면이면 Chrome이나 Edge를 권장합니다.

macOS / Linux

아래 로컬 설치나 Docker 안내를 따르세요.

설치와 배포 📥

공식 패키지를 pip로 설치

공식 PyPI 패키지는 mpt이며 harry0703이 관리합니다. PyPI의 MoneyPrinterTurbo 패키지는 제3자가 관리합니다. 저장소를 받을 필요가 없고 Python 3.11 이상이 필요합니다.

가상환경을 만들어 켠 뒤(macOS / Linux는 python3 -m venv .venv 후 source .venv/bin/activate, Windows PowerShell은 python -m venv .venv 후 .venv\Scripts\Activate.ps1) 설치하고 실행합니다.

python -m pip install mpt
mpt webui

웹 화면이 브라우저에서 자동으로 열립니다. 브라우저 없이 포트만 정하려면 mpt webui --port 8503 --headless를 쓰고, 명령줄 생성은 mpt cli --help를 보세요. 처음 실행하면 config.toml이 만들어지며, 온라인 모델 · 자료 · 음성 서비스에 필요한 API 키는 웹 화면의 기본 설정에 넣습니다. 설정과 결과 파일의 기본 저장 위치는 다음과 같습니다.

시스템데이터 폴더
macOS~/Library/Application Support/MoneyPrinterTurbo
Windows%LOCALAPPDATA%\MoneyPrinterTurbo
Linux~/.local/share/MoneyPrinterTurbo 또는 $XDG_DATA_HOME/MoneyPrinterTurbo

실행 전에 MPT_HOME을 지정하면 다른 폴더를 쓸 수 있고, 만든 영상은 그 폴더의 storage/tasks에 있습니다. 업그레이드는 가상환경을 켠 뒤 python -m pip install --upgrade mpt를 실행하세요.

소스 배포 전 준비

  • 로컬 배포에는 Python 3.11 이상이 필요합니다.
  • Windows에서는 프로젝트 경로에 한글 · 특수문자 · 공백이 없게 하세요.
  • 처음 실행하면 config.example.toml에서 config.toml을 자동으로 만듭니다. 클라우드 LLM, 온라인 자료, AI 영상 서비스를 쓰기 전에 웹 화면의 기본 설정에 API 키를 넣으세요.

Docker 배포 🐳

Docker가 없다면 Docker Desktop을 먼저 설치합니다. 처음 시작하기 전에 MoneyPrinterTurbo 폴더에서 config.example.toml을 config.toml로 복사해 컨테이너에 연결합니다.

cd MoneyPrinterTurbo
docker compose -f docker-compose.release.yml up

기본 권장은 GitHub Container Registry의 미리 만든 이미지(ghcr.io/harry0703/moneyprinterturbo:latest)를 받는 docker-compose.release.yml입니다. 이미지를 직접 빌드하려면 docker compose up을 쓰세요. 웹 화면은 http://127.0.0.1:8501, API 문서는 http://127.0.0.1:8080/docs 에서 열립니다.

수동 배포 📦

uv로 Python 환경과 의존성을 관리합니다(Python 3.11 이상).

git clone https://github.com/harry0703/MoneyPrinterTurbo.git
cd MoneyPrinterTurbo
uv python install 3.11
uv sync --frozen

웹 화면은 Windows에서 .\webui.bat, macOS · Linux에서 sh webui.sh로 실행하고, API 서비스는 uv run python main.py로 실행합니다. 같은 네트워크의 다른 기기에서 접속하려면 MPT_WEBUI_HOST=0.0.0.0을 지정하세요.

브라우저를 쓸 수 없다면 명령줄만으로 영상을 만들 수 있습니다.

uv run python cli.py --video-subject "How AI is changing everyday life"

여러 작업을 차례로 돌리려면 JSON 배열이나 JSONL 목록 파일을 넘깁니다(최대 100개 작업, 1 MiB).

uv run python cli.py --batch-file ./tasks.json --stop-at video

내레이션 · 자막 · 배경음악 🎙️

음성 합성

웹 화면의 Azure TTS V1은 Edge TTS로 동작해 API 키 없이 무료로 쓸 수 있습니다. Azure TTS V2, SiliconFlow, Google Gemini, Xiaomi MiMo, MiniMax, ElevenLabs, 직접 호스팅하는 Chatterbox · Kokoro, Fish Audio, ModelBest VoxCPM TTS와 무음 모드도 지원합니다. 웹 화면에서 공급자와 목소리를 고르고 안내에 따라 필요한 인증 정보를 넣으세요. 사용할 수 있는 Edge TTS 목소리는 목소리 목록에 있습니다.

자막 생성

  • edge: TTS 시간 정보를 써서 GPU 없이 빠르게 만드는 기본 방식.
  • whisper: 더 정확한 자막이 필요할 때 로컬 faster-whisper 받아쓰기를 씁니다. 처음 쓸 때 모델을 내려받습니다.

config.toml의 subtitle_provider로 방식을 바꿉니다. Whisper는 기본으로 약 3 GB의 large-v3 모델을 쓰며, 더 작고 빠른 약 1.6 GB의 large-v3-turbo를 쓰려면 다음처럼 설정합니다.

[app]
subtitle_provider = "whisper"

[whisper]
model_size = "large-v3-turbo"

자동 내려받기가 실패하면 Hugging Face에서 whisper-large-v3를 직접 받아 .\MoneyPrinterTurbo\models\whisper-large-v3 폴더에 두세요.

배경음악 · 자막 글꼴

배경음악은 프로젝트의 resource/songs 폴더에, 자막 글꼴은 resource/fonts 폴더에 있으며 직접 추가할 수도 있습니다. 기본 음악 중에는 유튜브 영상에서 가져온 것이 있어, 저작권 문제가 있다면 삭제해야 합니다.

자주 묻는 질문 🤔

RuntimeError: No ffmpeg exe could be found

보통 ffmpeg는 자동으로 내려받아 인식됩니다. 환경 문제로 자동 내려받기가 안 되면 이 오류가 납니다. gyan.dev에서 FFmpeg를 받아 풀고 config.toml의 ffmpeg_path에 실제 경로를 적으세요.

[app]
ffmpeg_path = "C:\\Users\\harry\\Downloads\\ffmpeg.exe"

OSError: [Errno 24] Too many open files

시스템의 열린 파일 수 제한 때문입니다. ulimit -n으로 확인하고, 낮으면 ulimit -n 10240처럼 늘리세요.

Whisper 모델 내려받기 실패

Hugging Face에서 모델을 직접 받아 models 폴더에 두는 방법은 위 「자막 생성」 절을 보세요.

더 알아보기

원문 README에는 위 내용 외에 후원사 소개, 만든 사람의 다른 프로젝트(MangoDisk), 세로 · 가로 예시 영상 갤러리, 편집 가능한 로컬 영상 프로젝트 안내가 있습니다. 전체는 저장소 README를 보세요.

라이선스

MIT 라이선스입니다. 자세한 내용은 LICENSE를 보세요.


저장소: harry0703/MoneyPrinterTurbo

평점

–평가 0개 기준
5점
0
4점
0
3점
0
2점
0
1점
0