harry0703/MoneyPrinterTurbo

利用AI大模型,一键生成高清短视频 Generate short videos with one click using AI LLM.

GitHub에서 열기 ↗ aiautomationchatgptmoviepypythonshortvideotiktok
96,646
GitHub 스타
14,246
포크
Python
언어
MIT
라이선스
2026.07.09
최근 푸시
2026.06.03
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
AI 기반 숏폼 비디오 자동 생성 도구가 필요하다면 MoneyPrinterTurbo는 강력한 후보입니다. 특히 콘텐츠 제작 자동화, 다중 플랫폼 게시, 다양한 AI 모델 연동을 원하는 경우 적극 도입을 고려할 만합니다.

강점

  • 주제나 키워드만 입력하면 AI가 자동으로 스크립트, 영상素材, 자막, 배경음악을 생성하여 고화질 숏폼 비디오를 만들어 줍니다.
  • Web UI, API, CLI 등 다양한 인터페이스를 제공하며, Docker 및 원클릭 패키지로 손쉽게 배포할 수 있습니다.
  • 다양한 LLM, TTS 엔진, 영상素材 소스(Pexels, Pixabay, Coverr)를 지원하고, TwelveLabs를 통한 고급 영상 AI 기능도 선택적으로 사용할 수 있습니다.

약점

  • 로컬 배포 시 Python 3.11, uv, Docker 등 사전 지식이 필요하여 초보자에게는 진입 장벽이 있을 수 있습니다.
  • faster-whisper를 사용한 자막 생성은 CPU에서 속도가 느리고, GPU가 없으면 배치 생성이나 고품질 자막 처리에 시간이 오래 걸릴 수 있습니다.
  • 일부 기능(예: Azure TTS V2, TwelveLabs, Upload-Post)은 별도의 유료 API 키나 계정이 필요합니다.

주의사항

  • 설치 경로에 한글, 특수문자, 공백이 포함되지 않도록 주의해야 합니다.
  • VPN 사용 시 글로벌 트래픽 모드를 활성화해야 네트워크 연결이 정상적으로 작동합니다.
  • YouTube 게시 시 AI 생성 콘텐츠로 자동 표시되므로, 플랫폼 정책을 사전에 확인하는 것이 좋습니다.

시작 가이드

  • README의 빠른 시작 가이드에 따라 Windows 원클릭 패키지 또는 Docker로 즉시 테스트해 보세요.
  • config.toml에서 Pexels API 키와 원하는 LLM 제공자를 설정한 후, Web UI에서 간단한 주제로 비디오를 생성해 보세요.
  • 필요에 따라 Azure TTS V2, TwelveLabs, Upload-Post 등 고급 기능을 활성화하고, 배치 생성 및 CLI 모드를 실험해 보세요.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

MoneyPrinterTurbo 💸

<div align="center"> <h1 align="center">MoneyPrinterTurbo 💸</h1>

<p align="center"> <a href="https://github.com/harry0703/MoneyPrinterTurbo/stargazers"><img src="https://img.shields.io/github/stars/harry0703/MoneyPrinterTurbo.svg?style=for-the-badge" alt="Stargazers"></a> <a href="https://github.com/harry0703/MoneyPrinterTurbo/issues"><img src="https://img.shields.io/github/issues/harry0703/MoneyPrinterTurbo.svg?style=for-the-badge" alt="Issues"></a> <a href="https://github.com/harry0703/MoneyPrinterTurbo/network/members"><img src="https://img.shields.io/github/forks/harry0703/MoneyPrinterTurbo.svg?style=for-the-badge" alt="Forks"></a> <a href="https://github.com/harry0703/MoneyPrinterTurbo/blob/main/LICENSE"><img src="https://img.shields.io/github/license/harry0703/MoneyPrinterTurbo.svg?style=for-the-badge" alt="License"></a> </p> <br> <h3>简体中文 | <a href="README-en.md">English</a> | <a href="README-ar.md">العربية</a></h3> <div align="center"> <a href="https://trendshift.io/repositories/8731" target="_blank"><img src="https://trendshift.io/api/badge/repositories/8731" alt="harry0703%2FMoneyPrinterTurbo | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </div>

<br> 비디오 주제 또는 키워드만 제공하면 비디오 스크립트, 비디오素材, 자막, 배경 음악을 완전 자동으로 생성한 후 고화질 숏폼 비디오로 합성합니다. <br>

<h4>Web 인터페이스</h4>

<h4>API 인터페이스</h4>

</div>

특별 감사 🙏

<table align="center"> <tr> <td align="center" width="160"> <a href="https://aihubmix.com/?aff=CEve"><strong>AIHubMix</strong></a> </td> <td align="left"> <sub><a href="https://aihubmix.com/?aff=CEve">AIHubMix</a>님의 후원에 감사드립니다. AIHubMix는 OpenAI, Claude, Gemini, DeepSeek, 智谱, 千问 등 글로벌 최고 최신 모델에 깊이 최적화되어 있으며, GPT-5.5, deepseek-v4-flash 등 700+ 모델(여러 무료 모델 포함)을 원스톱으로 빠르게 연동하고, 엔터프라이즈급 생산 안정성을 보장합니다.</sub> </td> </tr>

<tr> <td align="center" width="160"> <a href="https://www.volcengine.com/activity/codingplan?utmcampaign=hw&utmcontent=hw&utmmedium=devreltoolweb&utmsource=OWO&utmterm=MoneyPrinterTurbo"><img src="docs/sponsors/volcengine-logo.svg" alt="火山引擎" height="32"></a><br> <a href="https://www.volcengine.com/activity/ai618?utmcampaign=hw&utmcontent=hw&utmmedium=devreltoolweb&utmsource=OWO&utmterm=MoneyPrinterTurbo"><strong>方舟 Agent Plan</strong></a> </td> <td align="left"> <sub><a href="https://www.volcengine.com/activity/ai618?utmcampaign=hw&utmcontent=hw&utmmedium=devreltoolweb&utmsource=OWO&utmterm=MoneyPrinterTurbo">方舟 Agent Plan</a>님의 후원에 감사드립니다. 모델 자유, 도구 무제한, 최신 MiniMax-M3 및 GLM-5.1 지원, 주문 시 9.5% 할인! 주류 우수 국산 프로그래밍 모델을 모아 다중 생태계 호환, 도구 체인에 원활하게 통합, 바이트 리소스 보장 및 엔지니어링 역량에 의존하여 더 큰 용량, 더 빠르고, 더 안정적이며, 더 매끄럽게!</sub> </td> </tr> <tr> <td align="center" width="160"> <a href="https://www.ccsub.net/register?ref=VCVDAWWY"><img src="docs/sponsors/ccsub-logo.png" alt="CCSub" height="36"></a><br> <a href="https://www.ccsub.net/register?ref=VCVDAWWY"><strong>CCSub</strong></a> </td> <td align="left"> <sub><a href="https://www.ccsub.net/register?ref=VCVDAWWY">CCSub</a>님의 후원에 감사드립니다! CCSub는 안정적이고 저렴한 AI API 중계 플랫폼으로, Claude Code 공식 구독의 강력한 대체재입니다. 하나의 API Key로 Claude Opus 4.8, Sonnet 4.6, Haiku 4.5, GPT-5, Gemini 등 모델을 호출할 수 있으며, 가격은 공식 직연결의 약 1/3, 글로벌 직연결로 VPN 불필요. Claude Code, Codex, Cursor, Cline, Continue, Windsurf 등 모든 주류 AI 프로그래밍 도구와 호환됩니다. <a href="https://www.ccsub.net/register?ref=VCVDAWWY">www.ccsub.net</a>에서 가입 시 $5 체험 크레딧 증정.</sub> </td> </tr> <tr> <td align="center" width="160"> <a href="https://www.compshare.cn/coding-plan?ytag=GPUYY-gitMoneyPrinterTu"><img src="docs/sponsors/compshare-logo.png" alt="优云智算" height="34"></a><br> <a href="https://www.compshare.cn/coding-plan?ytag=GPUYY-gitMoneyPrinterTu"><strong>优云智算</strong></a> </td> <td align="left"> <sub><a href="https://www.compshare.cn/coding-plan?ytag=GPUYY-gitMoneyPrinterTu">优云智算</a>님의 후원에 감사드립니다! 优云智算는 UCloud 산하 AI 클라우드 플랫폼으로, 국내외 주류 모델의 API 서비스를 원스톱으로 제공하며, 하나의 Key로 모든 모델을 호출할 수 있습니다. 고가성비 국산 모델 CodingPlan 패키지(GLM5.2, Deepseek-v4 등)를主打하며, 공식 전달의 안정적인 해외 모델 채널도 제공하여 다양한 시나리오 개발 요구를 충족합니다. Claude Code, Codex 등 주류 AI 프로그래밍 도구 및 일반 API 호출과 이미 호환되며, 엔터프라이즈급 고동시성, 7×24 기술 지원 및 자체 청구서 발행을 지원합니다. <a href="https://www.compshare.cn/coding-plan?ytag=GPUYY-git_MoneyPrinterTu">클릭하여 가입</a> 시 최대 ¥10 무료 체험금 획득 가능.</sub> </td> </tr> <tr> <td align="center" width="160"> <a href="https://reccloud.cn"><img src="docs/sponsors/reccloud-logo.svg" alt="录咖" height="36"></a><br> <a href="https://reccloud.cn"><strong>录咖 AI</strong></a> </td> <td align="left"> <sub>이 프로젝트의 배포사용이 일부 초보 사용자에게는 일정한 진입 장벽이 있으므로, <a href="https://reccloud.cn">录咖(AI智能 멀티미디어 서비스 플랫폼)</a> 사이트가 이 프로젝트를 기반으로 제공하는 무료 <code>AI 비디오 생성기</code> 서비스에 특별히 감사드립니다. 배포 없이 온라인에서 직접 사용할 수 있어 매우 편리합니다.</sub> </td> </tr> <tr> <td align="center" width="160"> <a href="https://picwish.cn"><img src="docs/sponsors/picwish-logo.svg" alt="佐糖" height="36"></a><br> <a href="https://picwish.cn"><strong>佐糖</strong></a> </td> <td align="left"> <sub><a href="https://picwish.cn">佐糖</a>님의 지원과 후원에 감사드립니다. 덕분에 이 프로젝트가 지속적으로 업데이트되고 유지될 수 있습니다. 佐糖는 이미지 처리 분야에 특화되어 있으며, 풍부한 이미지 처리 도구를 제공하여 복잡한 작업을 극도로 단순화하여 이미지 처리를 더 쉽게 만듭니다.</sub> </td> </tr> </table>

기능 특징 🎯

  • [x] 완전한 MVC 아키텍처, 코드 구조 명확, 유지보수 용이, APIWeb 인터페이스 지원
  • [x] 비디오 스크립트 AI 자동 생성 지원, 사용자 정의 스크립트도 가능
  • [x] 여러 고화질 비디오 크기 지원
  • [x] 세로 9:16, 1080x1920
  • [x] 가로 16:9, 1920x1080
  • [x] 배치 비디오 생성 지원, 한 번에 여러 비디오 생성 후 가장 만족스러운 것 선택 가능
  • [x] 비디오 클립 길이 설정 지원,素材 전환 빈도 조절 용이
  • [x] 중국어영어 비디오 스크립트 지원
  • [x] 다양한 음성 합성 지원, 실시간 미리 듣기 가능
  • [x] 자막 생성 지원, 글꼴, 위치, 색상, 크기 조절 가능, 자막 테두리 설정 지원
  • [x] 배경 음악 지원, 무작위 또는 특정 음악 파일 지정 가능, 배경 음악 볼륨 설정 가능
  • [x] 비디오素材 출처 고화질, 저작권 없음, 자체 로컬素材 사용 가능
  • [x] 여러素材 소스 지원: Pexels, Pixabay, Coverr
  • [x] 선택적 TwelveLabs 비디오 AI 연동: Marengo 다중 모달 벡터로 주제별素材 키워드 의미 재정렬, Pegasus로素材 콘텐츠 QA/설명(TwelveLabs API key)
  • [x] OpenAI, AIHubMix, AIML API, EvoLink, Moonshot, Azure, gpt4free, one-api, 通义千问, Google Gemini, Ollama, DeepSeek, MiniMax, 文心一言, Pollinations, ModelScope 등 다양한 모델 연동 지원
  • [x] 원클릭 크로스 플랫폼 게시 지원, 생성 완료 후 자동으로 TikTok, InstagramYouTube Shorts에 업로드 (Upload-Post 계정 필요; YouTube 게시 시 AI 생성 콘텐츠 자동 표시); config.toml에서 uploadpostplatforms, uploadpostyoutubeprivacystatus 등 매개변수 설정

비디오 데모 📺

세로 9:16

<table> <thead> <tr> <th align="center"><g-emoji class="g-emoji" alias="arrowforward">▶️</g-emoji> 《삶의 즐거움을 높이는 방법》</th> <th align="center"><g-emoji class="g-emoji" alias="arrowforward">▶️</g-emoji> 《돈의 역할》<br>더 사실적인 합성 음성</th> <th align="center"><g-emoji class="g-emoji" alias="arrow_forward">▶️</g-emoji> 《인생의 의미는 무엇인가》</th> </tr> </thead> <tbody> <tr> <td align="center"><video src="https://github.com/harry0703/MoneyPrinterTurbo/assets/4928832/a84d33d5-27a2-4aba-8fd0-9fb2bd91c6a6"></video></td> <td align="center"><video src="https://github.com/harry0703/MoneyPrinterTurbo/assets/4928832/af2f3b0b-002e-49fe-b161-18ba91c055e8"></video></td> <td align="center"><video src="https://github.com/harry0703/MoneyPrinterTurbo/assets/4928832/112c9564-d52b-4472-99ad-970b75f66476"></video></td> </tr> </tbody> </table>

가로 16:9

<table> <thead> <tr> <th align="center"><g-emoji class="g-emoji" alias="arrowforward">▶️</g-emoji>《인생의 의미는 무엇인가》</th> <th align="center"><g-emoji class="g-emoji" alias="arrowforward">▶️</g-emoji>《운동해야 하는 이유》</th> </tr> </thead> <tbody> <tr> <td align="center"><video src="https://github.com/harry0703/MoneyPrinterTurbo/assets/4928832/346ebb15-c55f-47a9-a653-114f08bb8073"></video></td> <td align="center"><video src="https://github.com/harry0703/MoneyPrinterTurbo/assets/4928832/271f2fae-8283-44a0-8aa0-0ed8f9a6fa87"></video></td> </tr> </tbody> </table>

구성 요구 사항 📦

  • 권장 시스템: Windows 10 또는 MacOS 11.0 이상, 또는 주류 Linux 배포판
  • GPU는 필수가 아니지만, 로컬 전사, 더 빠른 비디오 처리 또는 더 원활한 배치 생성 환경을 원한다면 VRAM이 있는 개별 그래픽 카드를 권장합니다.
항목 최소 구성 권장 구성 이상적 구성
CPU 4코어 6~8코어 8코어 이상
RAM 4 GB 8 GB 16 GB 이상
GPU 필수 아님 4 GB VRAM 이상 8 GB VRAM 이상
  • 주로 클라우드 LLM, 클라우드 TTS 및 온라인素材 소스에 의존하는 경우 CPU와 메모리가 GPU보다 중요합니다.
  • faster-whisper, 배치 생성 또는 더 무거운 로컬 처리 파이프라인을 활성화하면 GPU가 속도를 크게 향상시킵니다.

빠른 시작 🚀

권장 사용 방식

  • Windows 사용자: 빠른 체험을 위해 원클릭 시작 패키지 우선 사용
  • MacOS / Linux 사용자: uv sync --frozen으로 로컬 배포 우선
  • 격리된 실행 환경 원함: Docker 배포 우선

Google Colab에서 실행

로컬 환경 구성 불필요, 클릭하여 Google Colab에서 MoneyPrinterTurbo를 빠르게 체험하세요.

Windows 원클릭 시작 패키지

원클릭 시작 패키지를 다운로드하여 압축 풀고 바로 사용 (경로에 중국어, 특수 문자, 공백 없어야 함)

  • GitHub Release: https://github.com/harry0703/MoneyPrinterTurbo/releases/latest

다운로드 후, 더블 클릭하여 update.bat를 실행해 최신 코드로 업데이트한 후, start.bat를 더블 클릭하여 시작하는 것을 권장합니다.

시작 후 자동으로 브라우저가 열립니다 (빈 페이지로 열리면 Chrome 또는 Edge로 열어보세요).

설치 배포 📥

전제 조건

  • 중국어 경로는 사용하지 마세요. 예측할 수 없는 문제가 발생할 수 있습니다.
  • 네트워크가 정상인지 확인하세요. VPN은 글로벌 트래픽 모드를 켜야 합니다.

① 코드 클론

git clone https://github.com/harry0703/MoneyPrinterTurbo.git

② 구성 파일 수정 (선택 사항, 시작 후 WebUI에서도 구성 가능)

  • config.example.toml 파일을 복사하여 config.toml로 이름 변경
  • config.toml 파일의 설명에 따라 pexelsapikeysllmprovider를 구성하고, llmprovider에 해당하는 서비스 제공업체의 API Key를 구성
  • 권장 대형 모델 플랫폼을 사용하려면 llm_provideraihubmix로 설정하고 해당 API Key를 입력

Docker 배포 🐳

① Docker 시작

Docker가 설치되지 않은 경우 먼저 설치: https://www.docker.com/products/docker-desktop/

Windows 시스템의 경우 Microsoft 문서 참조:

  1. https://learn.microsoft.com/zh-cn/windows/wsl/install
  2. https://learn.microsoft.com/zh-cn/windows/wsl/tutorials/wsl-containers
cd MoneyPrinterTurbo
docker compose -f docker-compose.release.yml up

기본적으로 docker-compose.release.yml 사용을 권장합니다. GitHub Container Registry의 사전 빌드 이미지 ghcr.io/harry0703/moneyprinterturbo:latest를 직접 가져옵니다.

로컬에서 이미지를 다시 빌드해야 하는 경우 docker compose up을 계속 사용할 수 있습니다.

참고: 처음 시작하기 전에 프로젝트 루트 디렉토리에 config.toml이 있는지 확인하세요. config.example.toml에서 복사할 수 있습니다.

② Web 인터페이스 접속

브라우저를 열고 http://127.0.0.1:8501 에 접속

③ API 문서 접속

브라우저를 열고 http://127.0.0.1:8080/docs 또는 http://127.0.0.1:8080/redoc 에 접속

수동 배포 📦

비디오 튜토리얼

  • 전체 사용 데모: https://v.douyin.com/iFhnwsKY/
  • Windows에서 배포하는 방법: https://v.douyin.com/iFyjoW3M

① 가상 환경 생성

Python 환경 및 종속성 관리를 위해 uv 사용을 권장합니다. 기본 Python 3.11 사용

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

uv를 사용하지 않으려면 venv + pip를 계속 사용할 수 있습니다.

python3.11 -m venv.venv
source.venv/bin/activate
pip install -r requirements.txt

설명:

  • pyproject.toml은 주요 종속성 정의 파일
  • uv.lock은 잠금 파일, 기본적으로 uv sync --frozen 실행 권장
  • requirements.txt는 기존 pip 설치 방식과의 호환성을 위해 유지

② Web 인터페이스 시작 🌐

MoneyPrinterTurbo 프로젝트 루트 디렉토리에서 다음 명령을 실행해야 합니다.

Windows

CMD에서도 webui.bat를 실행할 수 있습니다. webui.bat는 우선 프로젝트 .venv 또는 원클릭 패키지 내장 Python을 사용합니다. 프로젝트 Python을 찾을 수 없지만 uv가 설치된 경우 자동으로 uv run streamlit으로 전환합니다. 로컬 네트워크 내 다른 장치가 WebUI에 접근하도록 허용하려면 먼저 set MPTWEBUIHOST=0.0.0.0을 실행한 후 webui.bat를 실행하세요.

MacOS 또는 Linux
uv run streamlit run./webui/Main.py --browser.gatherUsageStats=False --server.showEmailPrompt=False

가상 환경을 수동으로 활성화한 경우 다음을 직접 실행할 수 있습니다:

sh webui.sh

시작 후 자동으로 브라우저가 열립니다 (빈 페이지로 열리면 Chrome 또는 Edge로 열어보세요).

③ API 서비스 시작 🚀

uv run python main.py

가상 환경을 수동으로 활성화한 경우 다음을 직접 실행할 수 있습니다:

python main.py

④ 순수 명령줄 방식 (브라우저 없음) ⌨️

브라우저나 포트 포워딩을 사용할 수 없는 경우 명령줄에서 직접 비디오를 생성할 수 있습니다:

uv run python cli.py --video-subject "돈의 역할"

로컬素材를 지정하고 특정 단계까지만 실행할 수도 있습니다:

uv run python cli.py \
  --video-subject "돈의 역할" \
  --video-source local \
  --video-materials "1.mp4,2.mp4" \
  --stop-at video

음성 합성 🗣

지원되는 모든 음성 목록은 음성 목록에서 확인할 수 있습니다.

기본 TTS 서비스는 Edge TTS (무료, API Key 불필요)입니다. WebUI에서는 "Azure TTS V1"로 표시되며, 둘은 동일한 무료 서비스를 가리킵니다. config.toml에서 voice_name을 설정하거나 WebUI의 음성 드롭다운 상자에서 직접 선택할 수 있습니다.

설명: WebUI의 "Azure TTS V1" (Edge TTS, 무료)과 "Azure TTS V2" (유료 Azure Speech SDK)는 두 가지 다른 옵션이며, V2만 Azure API Key 구성이 필요합니다.

더 높은 품질의 Azure TTS V2 음성을 사용하려면 config.toml에서 Azure Speech 자격 증명을 구성해야 합니다:

[azure]
speech_key = "your-azure-speech-key"
speech_region = "eastus"

Azure TTS V2는 Azure Speech Services 구독이 필요합니다. v1.1.2에서 추가된 9가지 Azure 음성은 전체적으로 Edge TTS보다 더 자연스럽습니다.

자막 생성 📜

현재 2가지 자막 생성 방식을 지원합니다:

  • edge: Edge TTS가 반환하는 타임스탬프를 사용하여 자막 정렬. 속도가 빠르고 GPU가 필요 없으며 일반 기기에서도 실행 가능; 그러나 복잡한 문장의 타임스탬프가 때때로 정확하지 않을 수 있습니다.
  • whisper: 로컬 faster-whisper를 사용하여 생성된 오디오를 전사하고 더 세분화된 타임스탬프를 생성. 속도가 느림 (CPU에서 일반적으로 몇 초에서 약 1분 소요, 모델 크기에 따라 다름), 모델 다운로드 필요 (large-v3-turbo 약 250 MB, large-v3 약 3 GB), 그러나 TTS 제공업체의 타임스탬프에 의존하지 않으며 자막 정확도가 일반적으로 더 좋습니다.

원본 저장소: harry0703/MoneyPrinterTurbo

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.