MoneyPrinterTurbo

KO | EN

gitlite — search

#javascript #python #typescript #llm #android #machine-learning #deep-learning #docker #nodejs #awesome #awesome-list #security #ios #open-source

MoneyPrinterTurbo

(★ 104,509)

AI 대형 언어 모델과 자동화 워크플로우를 활용해 주제나 키워드 하나로 고화질 숏폼 영상을 원클릭으로 생성합니다. Generate HD short videos from a topic or keyword with an automated AI workflow.

MoneyPrinterTurbo 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MoneyPrinterTurbo 💸

### 원스톱 AI 숏폼 비디오 생성 도구

비디오 **주제**나 **키워드**만 입력하면 자동으로 비디오 스크립트를 작성하고, 소재를 매칭하며, 자막과 배경 음악을 생성한 뒤 고화질 숏폼 비디오를 합성해 줍니다.

[![Version](https://img.shields.io/github/v/release/harry0703/MoneyPrinterTurbo?color=blue&label=version)](https://github.com/harry0703/MoneyPrinterTurbo/releases)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/harry0703/MoneyPrinterTurbo/releases/latest)
[![Python](https://img.shields.io/badge/python-3.11%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
[![Downloads](https://img.shields.io/github/downloads/harry0703/MoneyPrinterTurbo/total)](https://github.com/harry0703/MoneyPrinterTurbo/releases/latest)

[간체중국어](README.md) | [English](README-en.md) | [버전 배포](https://github.com/harry0703/MoneyPrinterTurbo/releases) | [문제 피드백](https://github.com/harry0703/MoneyPrinterTurbo/issues)

</div>

## 인터페이스 미리보기 🖥️

<h4 align="center">WebUI</h4>

![](https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/webui.jpg)

![](https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/api.jpg)

## 특별히 감사한 분들 ❤️

본 프로젝트를 후원해 주신 [Kimi](https://platform.kimi.com/?aff=MoneyPrinterTurbo)에 감사드립니다! [Kimi K3](https://www.kimi.com/blog/kimi-k3?aff=MoneyPrinterTurbo)는 Moonshot AI의 지금까지 가장 강력한 모델이자 세계 최초의 오픈소스 3T급 모델로, 네이티브 시각 기능과 100만 Token 컨텍스트를 갖추고 있어 지식 노동, 추론 및 장기 주기 작업에서 최첨단 성능을 발휘합니다. MoneyPrinterTurbo에서 K3는 비디오 제작을 직접 구동하여 비디오 카피를 작성할 뿐만 아니라 소재 검색 키워드를 추출하고 완성된 영상 화면을 결정합니다. 콘텐츠를 더 정확하게 이해할수록 매칭되는 소재가 주제에 더 부합하게 됩니다.

**MoneyPrinterTurbo에 Kimi가 연동되었습니다. Kimi 오픈 플랫폼([중국어 사이트](https://platform.kimi.com/?aff=MoneyPrinterTurbo)｜[Global](https://platform.kimi.ai/?aff=MoneyPrinterTurbo))에서 API를 체험하거나 [Kimi Code 구독](https://www.kimi.com/code?aff=MoneyPrinterTurbo)에 대해 알아보세요.**

<table align="center">
 <tr>
 <td align="center" width="120">
 <a href="https://www.volcengine.com/activity/ai618?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=MoneyPrinterTurbo"><img src="docs/sponsors/volcengine-logo.svg" alt="바이트볼케이노" height="32"></a> 
 <a href="https://www.volcengine.com/activity/ai618?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=MoneyPrinterTurbo">바이트볼케이노 (火山引擎)</a>
 </td>
 <td align="left">
 바이트볼케이노의 본 프로젝트 후원에 감사드립니다! 【전용 이벤트 혜택】 19위안 Tokens 패키지! 바이트 자체 개발 Doubao 모델 + 풀버전 오픈소스 SOTA 모델을 누려보세요. 텍스트, VLM, 이미지 생성까지 모든 모달리티를 원스톱으로 제공합니다: Seed-2.1, Seedream-5.0, GLM-5.2, DeepSeek, Qwen 등. 프로그래밍뿐만 아니라 Agent의 복잡하고 긴 작업까지 해결합니다 --&gt; <a href="https://www.volcengine.com/activity/ai618?utm_campaign=hw&utm_content=hw&utm_medium=devrel_tool_web&utm_source=OWO&utm_term=MoneyPrinterTurbo">가입 즉시 2,500만 Tokens 지급, 지금 바로 이동</a>
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://www.ccsub.net/register?ref=VCVDAWWY"><img src="docs/sponsors/ccsub-logo.png" alt="CCSub" height="36"></a> 
 <a href="https://www.ccsub.net/register?ref=VCVDAWWY">CCSub</a>
 </td>
 <td align="left">
 <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 체험 크레딧을 드립니다.
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://cubence.com/signup?code=SCE1CJPE&source=mpt"><img src="docs/sponsors/cubence-logo.png" alt="Cubence" height="40"></a> 
 <a href="https://cubence.com/signup?code=SCE1CJPE&source=mpt">Cubence</a>
 </td>
 <td align="left">
 <a href="https://cubence.com/signup?code=SCE1CJPE&source=mpt">Cubence</a>의 본 프로젝트 지원에 감사드립니다. Cubence는 AI 모델 API 연동 서비스에 특화된 플랫폼으로, 개발자와 팀에 안정적이고 편리한 모델 호출 경험을 제공하는 데 전념하고 있습니다. 2025년 9월 출시 이후 Cubence는 Claude Code, Codex, Gemini 등 다양한 AI 모델 및 개발 도구 관련 API 연동 시나리오를 지원하며, 다중 모델 기능을 통합 관리하고 호출해야 하는 사용자에게 적합합니다. Cubence는 본 오픈소스 프로젝트 사용자에게 전용 할인 코드를 제공합니다: <a href="https://cubence.com/signup?code=SCE1CJPE&source=mpt"><code>MPT</code></a>. 최초 구매 시 이 할인 코드를 사용하시면 <a href="https://cubence.com/signup?code=SCE1CJPE&source=mpt">10% 할인을 받으실 수 있습니다</a>.
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://www.quya.org/?promo=AFF1"><img src="docs/sponsors/0029-logo.jpg" alt="0029 윈치아오" height="56"></a> 
 <a href="https://www.quya.org/?promo=AFF1">0029 윈치아오 (云桥)</a>
 </td>
 <td align="left">
 <a href="https://www.quya.org/?promo=AFF1">0029.org 윈치아오</a>의 본 프로젝트 후원에 감사드립니다! 0029.org 윈치아오는 Claude Code, Codex 및 Gemini 최신 모델을 통합한 원스톱 중계 플랫폼으로, 안정적이고 효율적이며 가성비 높은 AI 중계 서비스를 제공합니다. 유연한 월간 패키지/종량제 플랜을 제공하며 국내 직접 연결로 우회 도구 없이 초고속 응답을 지원합니다. 개인 및 기업 연동을 지원하며, 가격은 공식 대비 최저 0.12배입니다. <a href="https://www.quya.org/?promo=AFF1">지금 바로 방문</a>하세요.
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://ergouapi.com/r/gh-moneyprinterturbo"><img src="docs/sponsors/ergou-api-logo.png" alt="얼거우 API" height="56"></a> 
 <a href="https://ergouapi.com/r/gh-moneyprinterturbo">얼거우 API (二狗 API)</a>
 </td>
 <td align="left">
 <a href="https://ergouapi.com/r/gh-moneyprinterturbo">얼거우 API</a>의 본 프로젝트 후원에 감사드립니다! 얼거우와 함께라면 안심할 수 있습니다. 얼거우 API 중계소는 전체 사이트 0.1x~0.2x 초저배율을 제공하며, Claude / GPT / Gemini 등 국내외 다양한 100% 순혈 대형 모델 인터페이스를 제공합니다. 최고급 IPLC 회선 + 주거용 듀얼 ISP 이중화로 전국 범위의 안정적이고 낮은 지연 시간의 접속을 보장합니다. 개발자와 스튜디오 여러분의 <a href="https://ergouapi.com/r/gh-moneyprinterturbo">가입 및 이용</a>을 환영합니다.
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://reccloud.cn"><img src="docs/sponsors/reccloud-logo.svg" alt="RecCloud" height="36"></a> 
 <a href="https://reccloud.cn">RecCloud AI</a>
 </td>
 <td align="left">
 본 프로젝트의 배포와 사용이 일부 초보 사용자에게는 어느 정도 진입 장벽이 될 수 있으므로, 본 프로젝트를 기반으로 무료 <code>AI 비디오 생성기</code> 서비스를 제공하여 별도의 배포 없이 바로 온라인에서 사용할 수 있도록 해주신 <a href="https://reccloud.cn">RecCloud (AI 스마트 멀티미디어 서비스 플랫폼)</a> 웹사이트에 특별히 감사를 표합니다. 매우 편리합니다.
 </td>
 </tr>
 <tr>
 <td align="center" width="120">
 <a href="https://picwish.cn"><img src="docs/sponsors/picwish-logo.svg" alt="PicWish" height="36"></a> 
 <a href="https://picwish.cn">PicWish (佐糖)</a>
 </td>
 <td align="left">
 본 프로젝트가 지속적으로 업데이트되고 유지보수될 수 있도록 지원하고 후원해 주신 <a href="https://picwish.cn">PicWish</a>에 감사드립니다. PicWish는 이미지 처리 분야에 특화되어 있으며, 풍부한 이미지 처리 도구를 제공하여 복잡한 조작을 극도로 단순화하고 이미지 처리를 진정으로 더 쉽게 만들어 줍니다.
 </td>
 </tr>
</table>

## 기능 및 특징 🎯

- [x] **AI Agent**, **WebUI**, **API**, **CLI** 네 가지 사용 방식 제공, 코드는 컨트롤러, 서비스, 모델 등의 역할에 따라 계층화됨
- [x] **AI 자동 비디오 스크립트 생성** 지원, 커스텀 스크립트 사용 가능
- [x] 다양한 **고화질 비디오** 해상도 지원
  - [x] 세로 화면 9:16, `1080x1920`
  - [x] 가로 화면 16:9, `1920x1080`
- [x] **배치 비디오 생성** 지원, 한 번에 여러 비디오를 생성한 후 가장 마음에 드는 비디오를 선택 가능
- [x] **비디오 클립 재생 시간** 설정 지원, 소재 전환 빈도 조절 용이
- [x] **다국어 비디오 스크립트** 생성 지원
- [x] **Edge TTS**, **Azure Speech**, **SiliconFlow**, **Google Gemini**, **샤오미 MiMo**, **ElevenLabs**, **Chatterbox** 음성 합성 지원, 실시간 미리 듣기 가능
- [x] **자막 생성** 지원, 폰트, 위치, 색상, 크기, 외곽선 및 배경 스타일 조절 가능
- [x] **배경 음악** 지원, 무작위 선택 또는 지정된 음악 사용 가능, 볼륨 조절 가능
- [x] 자체 **로컬 소재** 사용 지원, **Pexels**, **Pixabay**, **Coverr**에서 무료로 사용할 수 있는 고화질 소재 가져오기 가능
- [x] **Kimi / Moonshot AI**, **OpenAI**, **Google Gemini**, **DeepSeek**, **알리바바 통이첸웬 (通义千问)**, **Microsoft Azure OpenAI**, **바이트볼케이노 Ark**, **xAI Grok**, **MiniMax**, **샤오미 MiMo** 등 주류 모델 서비스 지원, **Cloudflare AI Gateway**, **ModelScope (魔搭)**, **AIHubMix**, **AIML API**, **EvoLink**, **Ollama**, **OneAPI**, **LiteLLM**, **Groq**, **Pollinations AI** 등 통합 게이트웨이, 어그리게이션 플랫폼 및 로컬 실행 환경과 호환
- [x] 원클릭 **크로스 플랫폼 게시** 지원, 생성 완료 후 **TikTok**, **Instagram**, **YouTube Shorts**에 자동 업로드 가능

## 작품 전시 🎬

아래 예시는 모두 MoneyPrinterTurbo로 실제로 생성되었습니다.

### 세로 화면 9:16

<table width="100%">
<tr>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=03-zh-portrait-city-morning.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/03-zh-portrait-city-morning.jpg" width="180" alt="城市醒来的时刻"></a> 도심이 깨어나는 순간 중국어 · 14초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=05-zh-portrait-clean-energy.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/05-zh-portrait-clean-energy.jpg" width="180" alt="清洁能源的未来"></a> 청정에너지의 미래 중국어 · 24초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=07-zh-portrait-space-exploration.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/07-zh-portrait-space-exploration.jpg" width="180" alt="为什么我们仍要探索太空"></a> 우리가 여전히 우주를 탐사해야 하는 이유 중국어 · 27초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=17-zh-portrait-seed-journey.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/17-zh-portrait-seed-journey.jpg" width="180" alt="一粒种子的旅程"></a> 씨앗 하나의 여정 중국어 · 44초</td>
</tr>
<tr>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=09-en-portrait-future-robotics.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/09-en-portrait-future-robotics.jpg" width="180" alt="The Future of Everyday Robotics"></a> The Future of Everyday Robotics English · 21 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=11-en-portrait-small-habits.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/11-en-portrait-small-habits.jpg" width="180" alt="Small Habits, Lasting Change"></a> Small Habits, Lasting Change English · 19 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=13-en-portrait-creative-work.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/13-en-portrait-creative-work.jpg" width="180" alt="Making Space for Creative Work"></a> Making Space for Creative Work English · 20 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=15-en-portrait-coffee-science.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/15-en-portrait-coffee-science.jpg" width="180" alt="The Science Inside Coffee"></a> The Science Inside Coffee English · 23 sec</td>
</tr>
</table>

### 가로 화면 16:9

<table width="100%">
<tr>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=02-zh-landscape-deep-ocean.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/02-zh-landscape-deep-ocean.jpg" width="280" alt="深海里的微光"></a> 심해 속 미세한 빛 중국어 · 23초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=04-zh-landscape-reading-power.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/04-zh-landscape-reading-power.jpg" width="280" alt="阅读如何塑造我们"></a> 독서가 우리를 형성하는 방식 중국어 · 23초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=06-zh-landscape-pour-over-coffee.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/06-zh-landscape-pour-over-coffee.jpg" width="280" alt="一杯手冲咖啡的细节"></a> 핸드드립 커피 한 잔의 디테일 중국어 · 23초</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=08-zh-landscape-spring-journey.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/08-zh-landscape-spring-journey.jpg" width="280" alt="春天适合出发"></a> D여행을 떠나기 좋은 봄 중국어 · 14초</td>
</tr>
<tr>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=10-en-landscape-ocean-conservation.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/10-en-landscape-ocean-conservation.jpg" width="280" alt="Why Ocean Conservation Matters"></a> Why Ocean Conservation Matters English · 25 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=14-en-landscape-sustainable-cities.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/14-en-landscape-sustainable-cities.jpg" width="280" alt="Designing More Sustainable Cities"></a> Designing More Sustainable Cities English · 27 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=16-en-landscape-mountain-perspective.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/16-en-landscape-mountain-perspective.jpg" width="280" alt="What Mountains Teach Us"></a> What Mountains Teach Us English · 18 sec</td>
<td align="center" width="25%"><a href="https://harry0703.github.io/mpt-assets/?video=18-en-landscape-history-of-flight.mp4"><img src="https://github.com/harry0703/mpt-assets/releases/download/assets/18-en-landscape-history-of-flight.jpg" width="280" alt="A Brief History of Human Flight"></a> A Brief History of Human Flight English · 59 sec</td>
</tr>
</table>

## 시스템 요구 사항 📦

- 권장 시스템: Windows 10, macOS 11.0 이상, 및 주요 Linux 배포판
- 로컬 배포에는 Python 3.11 이상이 필요하며, Python 3.11 권장
- GPU는 필수가 아니지만, 로컬 전사, 더 빠른 비디오 처리 또는 더 원활한 배치 생성 경험을 원하시는 경우 VRAM이 탑재된 외장 그래픽 카드를 권장합니다.

| 항목 | 최소 사양 | 권장 사양       | 이상적 사양     |
| ---- | --------- | --------------- | --------------- |
| CPU  | 4코어     | 6 ~ 8코어       | 8코어 이상      |
| RAM  | 4 GB      | 8 GB            | 16 GB 이상      |
| GPU  | 선택 사항 | 4 GB VRAM 이상  | 8 GB VRAM 이상  |

- 주로 클라우드 LLM, 클라우드 TTS 및 온라인 소재 소스에 의존하는 경우, GPU보다 CPU와 메모리가 더 중요합니다.
- `faster-whisper`, 배치 생성 또는 더 무거운 로컬 처리 파이프라인을 활성화하는 경우 GPU가 속도를 크게 향상시킵니다.

## 빠른 시작 🚀

### 권장 사용 방식

- 수동 설치 및 구성을 원하지 않는 경우: AI Agent를 사용하여 직접 비디오 생성
- Windows 사용자: 원클릭 실행 패키지 우선 사용 (빠른 체험에 적합)
- macOS / Linux 사용자: `uv`를 사용한 로컬 배포 우선 권장
- 실행 환경을 격리하고 싶은 경우: Docker 배포 우선 권장

### AI Agent를 이용한 비디오 생성

사용 중인 AI Agent가 Skill 문서를 읽고 로컬 터미널을 조작할 수 있는 경우, 아래 문구를 직접 전송하세요. Agent가 자동으로 설치, 구성 및 비디오 생성을 완료합니다. 필수 API Key가 누락된 경우에만 사용자에게 문의하며, 완료되면 생성된 비디오 파일 경로를 반환합니다. 현재 macOS와 Windows를 지원합니다.

```text
使用这个 Skill：https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/SKILL.md
帮我生成一个主题为“人工智能如何改变普通人的日常生活”的视频。
```

### Google Colab에서 실행하기

로컬 환경 설정 없이 아래 버튼을 클릭하여 Google Colab에서 MoneyPrinterTurbo를 빠르게 체험해 보세요.

[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/harry0703/MoneyPrinterTurbo/blob/main/docs/MoneyPrinterTurbo.ipynb)

### Windows 원클릭 실행 패키지

원클릭 실행 패키지를 다운로드한 후 압축을 해제하여 바로 사용하세요 (경로에 **중국어**, **특수문자**, **공백**이 없어야 합니다).

- GitHub Releases: https://github.com/harry0703/MoneyPrinterTurbo/releases/latest

다운로드 후 먼저 `update.bat`을 **더블 클릭하여 실행**하여 **최신 코드**로 업데이트한 다음, `start.bat`을 더블 클릭하여 실행하는 것을 권장합니다.

실행 후 브라우저가 자동으로 열립니다 (열린 화면이 공백인 경우 **Chrome** 또는 **Edge**로 변경하여 여는 것을 권장합니다).

## 설치 및 배포 📥

### 사전 조건

- 로컬 배포에는 Python 3.11 이상이 필요합니다.
- Windows 사용자는 중국어, 특수문자 또는 공백이 포함된 프로젝트 경로를 피하는 것을 권장합니다.

#### ① 코드 복제 (Clone)

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

#### ② 프로젝트 구성 (선택 사항)

최초 실행 시 프로젝트는 `config.example.toml`을 기반으로 `config.toml`을 자동 생성합니다. 대규모 언어 모델(LLM) Provider, 소재 소스 및 관련 API Key는 WebUI의 기본 설정에서 직접 구성할 수 있습니다.

### 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

```shell
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.example.toml`을 `config.toml`로 복사하여 컨테이너 마운트에 사용하세요.

#### ② WebUI 접속

브라우저를 열고 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

#### ① 가상 환경 생성

[uv](https://docs.astral.sh/uv/)를 사용하여 Python 환경 및 종속성을 관리하는 것을 권장합니다. 프로젝트는 Python 3.11 이상을 지원하며, 아래 예시에서는 Python 3.11을 사용합니다.

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

일시적으로 `uv`를 사용하지 않는 경우 `venv + pip`를 계속 사용할 수도 있습니다.

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

설명:

- `pyproject.toml`은 주 종속성 정의 파일입니다.
- `uv.lock`은 잠금 파일이며 기본적으로 `uv sync --frozen`을 실행하는 것을 권장합니다.
- `requirements.txt`는 기존 `pip` 설치 방식과의 호환성을 위해 유지됩니다.

#### ② WebUI 실행 🌐

MoneyPrinterTurbo 프로젝트 `루트 디렉터리`로 이동하여 다음 명령어를 실행해야 합니다.

###### Windows

```powershell
.\webui.bat
```

CMD에서도 `webui.bat`을 실행할 수 있습니다.
`webui.bat`은 프로젝트 `.venv` 또는 원클릭 패키지 내장 Python을 우선 사용합니다. 프로젝트 Python을 찾지 못했지만 `uv`가 설치되어 있는 경우 자동으로 `uv run streamlit`으로 전환됩니다.
로컬 네트워크 내 다른 기기의 WebUI 접속을 허용해야 하는 경우 `set MPT_WEBUI_HOST=0.0.0.0`을 먼저 실행한 후 `webui.bat`을 실행하세요.

###### macOS 또는 Linux

```shell
sh webui.sh
```

스크립트는 프로젝트 가상 환경 또는 `uv`를 자동으로 사용하며 사용 가능한 로컬 포트를 선택합니다. 로컬 네트워크 내 다른 기기의 접속을 허용해야 하는 경우 다음을 실행할 수 있습니다:

```shell
MPT_WEBUI_HOST=0.0.0.0 sh webui.sh
```

실행 후 브라우저가 자동으로 열립니다 (열린 화면이 공백인 경우 **Chrome** 또는 **Edge**로 변경하여 여는 것을 권장합니다).

#### ③ API 서비스 실행 🚀

```shell
uv run python main.py
```

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

```shell
python main.py
```

#### ④ 순수 커맨드라인 방식 (브라우저 없음) ⌨️

브라우저나 포트 포워딩을 사용할 수 없는 경우 커맨드라인에서 직접 비디오를 생성할 수 있습니다. 가장 간단한 전체 비디오 생성 명령어는 다음과 같습니다:

```shell
uv run python cli.py --video-subject "人工智能如何改变日常生活"
```

전체 명령어, 매개변수 설명 및 사용 방법을 확인하려면 다음을 실행하세요:

```shell
uv run python cli.py --help
```

## 음성 합성 🗣

기본적으로 무료인 **Edge TTS**를 사용하며, WebUI에는 **Azure TTS V1**으로 표시됩니다. 프로젝트는 **Azure TTS V2**, **SiliconFlow TTS**, **Google Gemini TTS**, **샤오미 MiMo TTS**, **ElevenLabs TTS**, 자체 호스팅 **Chatterbox TTS** 및 더빙 없음 모드를 동시에 지원합니다.

WebUI에서 Provider와 음성을 직접 선택하고 인터페이스 프롬프트에 따라 필요한 자격 증명을 입력할 수 있습니다. Edge TTS는 API Key가 필요하지 않으며, [Azure TTS V2](https://portal.azure.com/) 및 기타 클라우드 서비스는 해당 플랫폼의 자격 증명이 필요합니다. Edge TTS 음성 목록은 [음성 목록](./docs/voice-list.txt)을 참고하세요.

## 자막 생성 📜

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

- **edge**: TTS 타임스탬프를 사용하여 자막을 생성하며 속도가 빠르고 GPU가 필요하지 않으며 기본적으로 이 모드가 사용됩니다.
- **whisper**: 로컬 `faster-whisper`를 사용하여 오디오를 전사하며 더 정확한 자막 타임라인이 필요한 시나리오에 적합합니다. 최초 사용 시 모델 다운로드가 필요합니다.

`config.toml`에서 `subtitle_provider`를 수정하여 모드를 전환할 수 있습니다. Whisper는 기본적으로 약 3 GB 크기의 `large-v3`를 사용합니다. 더 작고 빠른 모델이 필요한 경우 약 1.6 GB 크기의 `large-v3-turbo`를 사용할 수 있습니다:

```toml
[app]
subtitle_provider = "whisper"

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

> Whisper를 최초 사용할 때 프로그램은 Hugging Face에서 모델을 자동으로 다운로드합니다. 현재 네트워크에서 자동 다운로드가 불가능한 경우 [Hugging Face](https://huggingface.co/Systran/faster-whisper-large-v3)에서 `whisper-large-v3`를 수동으로 다운로드할 수 있습니다.

다운로드 및 압축 해제 후 전체 디렉터리를 `.\MoneyPrinterTurbo\models`에 넣으세요. 최종 경로는 `.\MoneyPrinterTurbo\models\whisper-large-v3`여야 합니다:

```
MoneyPrinterTurbo
  ├─models
  │   └─whisper-large-v3
  │          config.json
  │          model.bin
  │          preprocessor_config.json
  │          tokenizer.json
  │          vocabulary.json
```

## 배경 음악 🎵

비디오에 사용되는 배경 음악은 프로젝트의 `resource/songs` 디렉터리에 위치합니다.

## 자막 폰트 🅰

비디오 자막 렌더링에 사용되며 프로젝트의 `resource/fonts` 디렉터리에 위치합니다. 자신만의 폰트를 넣을 수도 있습니다.

## 자주 묻는 질문 (FAQ) 🤔

<details>
<summary>TikTok, Instagram 또는 YouTube Shorts에 게시하는 방법은 무엇인가요?</summary>

[Upload-Post](https://upload-post.com/) 계정을 등록하고 API Key를 얻은 다음, `config.toml`의 `[app]` 아래에 다음 설정을 추가하세요:

```toml
[app]
upload_post_enabled = true
upload_post_api_key = "your-api-key"
upload_post_username = "your-username"
upload_post_platforms = ["tiktok", "instagram", "youtube"]
upload_post_auto_upload = true
upload_post_youtube_privacy_status = "public"
```

설정을 저장하고 프로젝트를 재시작하세요. 비디오 생성이 완료되면 프로그램이 구성된 플랫폼에 자동으로 게시합니다. YouTube 공개 상태는 `public`, `unlisted` 또는 `private`으로 설정할 수 있습니다.

</details>

<details>
<summary>RuntimeError: No ffmpeg exe could be found</summary>

일반적으로 ffmpeg는 자동으로 다운로드되며 자동으로 감지됩니다.
그러나 환경에 문제가 있어 자동으로 다운로드할 수 없는 경우 다음과 같은 오류가 발생할 수 있습니다:

```
RuntimeError: No ffmpeg exe could be found.
Install ffmpeg on your system, or set the IMAGEIO_FFMPEG_EXE environment variable.
```

이 경우 https://www.gyan.dev/ffmpeg/builds/에서 ffmpeg를 다운로드하고 압축을 해제한 후 `ffmpeg_path`를 실제 설치 경로로 설정하면 됩니다.

```toml
[app]
# 실제 경로에 맞게 설정해 주세요. Windows 경로 구분자는 \\입니다.
ffmpeg_path = "C:\\Users\\harry\\Downloads\\ffmpeg.exe"
```

</details>

<details>
<summary>OSError: [Errno 24] Too many open files</summary>

이 문제는 시스템의 열린 파일 수 제한으로 인해 발생하며, 시스템의 파일 열기 제한을 수정하여 해결할 수 있습니다.

현재 제한 확인

```shell
ulimit -n
```

너무 낮은 경우 값을 높여줍니다 (예:).

```shell
ulimit -n 10240
```

</details>

<details>
<summary>Whisper 모델 다운로드 실패</summary>

```
LocalEntryNotFoundError: Cannot find an appropriate cached snapshot folder for the specified revision on the local disk and
outgoing traffic has been disabled.
To enable repo look-ups and downloads online, pass 'local_files_only=False' as input.
```

또는

```
An error occurred while synchronizing the model Systran/faster-whisper-large-v3 from the Hugging Face Hub:
An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the
specified revision on the local disk. Please check your internet connection and try again.
Trying to load the model directly from the local cache, if it exists.
```

해결 방법: [Hugging Face에서 모델을 수동으로 다운로드하는 방법 보기](#%E5%AD%97%E5%B9%95%E7%94%9F%E6%88%90-)

</details>

## 피드백 및 제안 📢

- [issue](https://github.com/harry0703/MoneyPrinterTurbo/issues) 또는 [pull request](https://github.com/harry0703/MoneyPrinterTurbo/pulls)를 제출해 주세요.

## 라이선스 📝

클릭하여 [`LICENSE`](LICENSE) 파일 확인

## Star History

MoneyPrinterTurbo

MoneyPrinterTurbo 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

MoneyPrinterTurbo

MoneyPrinterTurbo 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README