MoneyPrinterTurbo: 免费AI视频生成器 — 安装指南 + Bug修复Setup Guide, Bug Fixes & Honest Review

MoneyPrinterTurbo 是什么？安装前必读What Is MoneyPrinterTurbo? Read Before Installing

MoneyPrinterTurbo 是一个开源的 AI 工具，可以根据一句话自动生成视频。你给它一个主题（例如"关于黑洞的5个冷知识"），它会自动生成完整视频——包括文案、配音、画面、字幕和背景音乐——完全不需要你动手剪辑。 MoneyPrinterTurbo is an open-source AI tool that automatically generates videos from a single sentence. You give it a topic (e.g. "Top 5 facts about black holes") and it produces a complete video — script, voiceover, visuals, subtitles, and background music — without you touching a timeline.

由国内开发者 harry0703 创建，因"第一个真正一键式 AI 视频生成流水线"在 GitHub 上爆火。 It was built by a Chinese developer (harry0703) and gained massive traction on GitHub for being the first truly one-click AI video pipeline that runs locally.

效果一览Results At A Glance

我用提示词 "东京必去的3个地方" 进行了测试。以下是 AI 生成视频与手动剪辑的对比： I tested it with the prompt "Top 3 things to do in Tokyo". Here's what came out, side by side with a manually-edited video for comparison:

AI 生成（MPT）— 约 60 秒完成 AI-Generated (MPT) — ~60s to produce

手动剪辑 — 约 30 分钟完成 Manually Edited — ~30min to produce

要钱吗？Is It Free?

简单回答：完全免费，零 API Key 也可用。前提是使用 v1.1.0 + g4f 配置（见下方指南）。 The short answer: yes, completely free. Zero API keys required. If you use v1.1.0 + the g4f config shown below.

真实安装指南 (Bug修复 + 避坑)Real Setup Guide — Bug Fixes & Workarounds

每个教程都说"又快又简单"。以下是真正有效的步骤，包括所有别人跳过不谈的部分。每步标注了适用范围： Every tutorial says "quick and easy." Here's what actually works. Each step tagged so you know what affects you:

📖 需要独立的安装教程？MoneyPrinterTurbo 安装指南（10分钟完整版） 📖 Want a standalone tutorial? MoneyPrinterTurbo Setup Guide (10-Minute Complete)

🎬 装好了？怎么用 MoneyPrinterTurbo 做出第一个视频 → 🎬 Already installed? How to use MPT and make your first video →

GLOBAL 全球通用，谁都会遇到Happens to everyone, everywhere  |  REGIONAL 仅限中国/受限网络用户China / restricted-network users only

1. GLOBAL 选对版本Pick the RIGHT version
   最新版（v1.2.9）没有 Web 界面，只有 API。新手必须用旧版： The latest release (v1.2.9) is API-only — no Web UI. Beginners must use the old version:
   git clone --branch v1.1.0 --depth 1 https://github.com/harry0703/MoneyPrinterTurbo.git
cd MoneyPrinterTurbo
   REGIONAL 开启 VPN — GitHub 连接经常被重置。--depth 1 减少下载量规避中断。VPN ON for git clone — GitHub connections reset frequently through GFW. --depth 1 minimizes the pain.
2. GLOBAL 安装依赖Install dependencies
   需要 Python 3.10+。建议使用镜像源加速： Python 3.10+ required. Use a mirror for speed:
   pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
   GLOBAL 如果报错 "moviepy.editor not found"：pip install moviepy==1.0.3 — v2.0.0 破坏了 MPT v1.1.0 依赖的 API。If you get "moviepy.editor not found": pip install moviepy==1.0.3 — v2.0.0 broke the API MPT v1.1.0 depends on.
   REGIONAL 关闭 VPN — 阿里云镜像在国内直连更快。VPN OFF for pip — Aliyun mirror is faster from within China.
3. GLOBAL 30 秒配好配置Configure in 30 seconds
   复制 config.example.toml → config.toml。只改一行： Copy config.example.toml → config.toml. Change ONE line:
   llm_provider = "g4f"
   搞定。g4f = 免费 AI 写文案。Edge TTS = 免费配音。不要 API Key。不用注册 Azure。不用绑定信用卡。 That's it. g4f = free AI. Edge TTS = free voiceover. No API keys. No credit card. Works anywhere.
4. GLOBAL 先启动后端Launch the BACKEND first
   打开 PowerShell 窗口 #1：Open PowerShell #1:
   cd D:\Projects\MoneyPrinterTurbo
python main.py
   看到 "start server, docs: http://127.0.0.1:8080/docs" 就对了。这个窗口不要关。 Wait for "start server, docs: http://127.0.0.1:8080/docs". Do NOT close this window.
   macOS/Linux：用终端代替 PowerShell，路径用 / 不用 \。macOS/Linux: use Terminal instead of PowerShell, paths use / not \.
5. GLOBAL 再启动前端Launch the FRONTEND
   打开 PowerShell 窗口 #2：Open PowerShell #2:
   cd D:\Projects\MoneyPrinterTurbo
streamlit run .\webui\Main.py
   浏览器自动打开 http://localhost:8501。输入主题，点生成。 Browser opens at http://localhost:8501. Type a topic, click Generate.
   REGIONAL 如果卡在"下载素材"那一步，开启 VPN — Pexels 在国内被墙。VPN ON if it hangs at "downloading materials" — Pexels is blocked in China.

资源链接Resources & Links

• GitHub 仓库GitHub Repository
  源代码、Issue、社区讨论Source code, issues, and community discussions →
• v1.1.0 发行版（推荐）v1.1.0 Release (Recommended)
  最后一个有 Web 界面的版本——新手用这个The last version with a Web UI — use this if you want a GUI →
• 官方英文 READMEOfficial English README
  安装参考（但建议用上面的指南，少走弯路）Installation reference (but follow our guide above for fewer headaches) →
• Pexels
  免费素材库——下载慢就注册个 API KeyFree stock footage — register for an API key if downloads are slow →

常见问题MoneyPrinterTurbo FAQ — Setup, Errors & Free Usage

MoneyPrinterTurbo 常见错误 & 修复MoneyPrinterTurbo Bugs & Troubleshooting

我在 Windows 11（中国网络环境）上花了 ~4 小时才让 MPT v1.1.0 生成出一个视频。每一步都踩了坑。以下按类别整理了全部 18 个 bug——含症状、根因、修复代码。 I spent ~4 hours getting MPT v1.1.0 to generate one video on Windows 11 (China). Every single step hit an issue. Below are all 18 bugs — with symptoms, root causes, and fix code — organized by category.

git clone --branch v1.1.0 --depth 1 https://github.com/harry0703/MoneyPrinterTurbo.git

pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

pip install edge-tts --upgrade

git checkout v1.1.0

pip install moviepy==1.0.3

temp_audiofile_path  →  temp_audiofile

temp_audiofile=output_dir
→ temp_audiofile=os.path.join(output_dir, "temp_audio.m4a")

def mktimestamp(seconds: float) -> str:
    hrs = int(seconds // 3600)
    mins = int((seconds % 3600) // 60)
    secs = int(seconds % 60)
    millis = int((seconds % 1) * 1000)
    return f"{hrs:02d}:{mins:02d}:{secs:02d}.{millis:03d}"

# Line 1017:
sub_maker.subs  →  sub_maker.cues

# Line 1087: replace zip(sub_maker.offset, sub_maker.subs)
# with iteration over sub_maker.cues, using
# .content for text and .start/.end.total_seconds() for timestamps

def get_audio_duration(sub_maker):
    if not sub_maker.cues:
        return 0.0
    return sub_maker.cues[-1].end.total_seconds()

# Old:
sub_maker.create_sub((chunk["offset"], chunk["duration"]), chunk["text"])
# New:
sub_maker.feed(chunk)

# Old:
elif chunk["type"] == "WordBoundary":
# New:
elif chunk["type"] in ("WordBoundary", "SentenceBoundary"):

https://dashscope.console.aliyun.com/

taskkill /F /IM ffmpeg.exe

About MoneyPrinterTurbo

MoneyPrinterTurbo 由国内开发者 harry0703 创建并开源，是目前 GitHub 上最受欢迎的 AI 视频生成工具之一——截至 2026 年 5 月已获得 72,000+ Stars 和 10,000+ Forks，长期位列 GitHub Trending 前列。 MoneyPrinterTurbo was created and open-sourced by developer harry0703. It is one of the most popular AI video generation tools on GitHub — with 72,000+ stars and 10,000+ forks as of May 2026, consistently ranking on GitHub Trending.

项目采用 MIT 开源许可证——可自由商用、修改和分发，无任何限制。技术栈基于 Python，核心流水线整合了 LLM（文案生成）、TTS（配音）、Pexels（素材搜索）和 moviepy + FFmpeg（视频合成）。 Licensed under MIT — free for commercial use, modification, and redistribution with no restrictions. The tech stack is Python-based, integrating LLM (script generation), TTS (voiceover), Pexels (stock footage), and moviepy + FFmpeg (video composition).

• GitHub: harry0703/MoneyPrinterTurbo
  源码、Issue 追踪、社区贡献Source code, issue tracker, community contributions →
• MIT License
  完整许可条款Full license text →