功能特性 🎯

• 完整的 MVC架构，代码 结构清晰，易于维护，支持 API 和 Web界面
• 支持视频文案 AI自动生成，也可以自定义文案
• 支持多种 高清视频 尺寸
  • 竖屏 9:16，1080x1920
  • 横屏 16:9，1920x1080
• 支持 批量视频生成，可以一次生成多个视频，然后选择一个最满意的
• 支持 视频片段时长 设置，方便调节素材切换频率
• 支持 中文 和 英文 视频文案
• 支持 多种语音 合成，可 实时试听 效果
• 支持 字幕生成，可以调整 字体、位置、颜色、大小，同时支持字幕描边设置
• 支持 背景音乐，随机或者指定音乐文件，可设置背景音乐音量
• 视频素材来源 高清，而且 无版权，也可以使用自己的 本地素材
• 支持 OpenAI、Moonshot、Azure、gpt4free、one-api、通义千问、Google Gemini、Ollama、DeepSeek、MiniMax、 文心一言, Pollinations、ModelScope 等多种模型接入
  • 中国用户建议使用 DeepSeek 或 Moonshot 作为大模型提供商（国内可直接访问，不需要VPN。注册就送额度，基本够用）

视频演示 📺

竖屏 9:16

▶️ 《如何增加生活的乐趣》	▶️ 《金钱的作用》 更真实的合成声音	▶️ 《生命的意义是什么》

横屏 16:9

▶️《生命的意义是什么》	▶️《为什么要运动》

配置要求 📦

• 建议最低 CPU 4核 或以上，内存 4G 或以上，显卡非必须
• Windows 10 或 MacOS 11.0 以上系统

快速开始 🚀

推荐使用方式

• Windows 用户：优先使用一键启动包，适合快速体验
• MacOS / Linux 用户：优先使用 uv sync --frozen 进行本地部署
• 想要隔离运行环境：优先使用 Docker 部署

在 Google Colab 中运行

免去本地环境配置，点击直接在 Google Colab 中快速体验 MoneyPrinterTurbo

Windows一键启动包

下载一键启动包，解压直接使用（路径不要有 中文、特殊字符、空格） 当前提供的安装包仍是 v1.2.6 的旧打包版本，建议下载后先执行 update.bat 更新到最新代码。

• 百度网盘（v1.2.6）: https://pan.baidu.com/s/1wg0UaIyXpO3SqIpaq790SQ?pwd=sbqx 提取码: sbqx
• Google Drive (v1.2.6): https://drive.google.com/file/d/1HsbzfT7XunkrCrHw5ncUjFX8XX4zAuUh/view?usp=sharing

下载后，建议先双击执行 update.bat 更新到最新代码，然后双击 start.bat 启动

启动后，会自动打开浏览器（如果打开是空白，建议换成 Chrome 或者 Edge 打开）

安装部署 📥

前提条件

• 尽量不要使用 中文路径，避免出现一些无法预料的问题
• 请确保你的 网络 是正常的，VPN需要打开全局流量模式

① 克隆代码

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

② 修改配置文件（可选，建议启动后也可以在 WebUI 里面配置）

• 将 config.example.toml 文件复制一份，命名为 config.toml
• 按照 config.toml 文件中的说明，配置好 pexels_api_keys 和 llm_provider，并根据 llm_provider 对应的服务商，配置相关的 API Key

Docker部署 🐳

① 启动Docker

如果未安装 Docker，请先安装 https://www.docker.com/products/docker-desktop/

如果是Windows系统，请参考微软的文档：

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 up

注意：最新版的docker安装时会自动以插件的形式安装docker compose，启动命令调整为docker compose up

② 访问Web界面

打开浏览器，访问 http://0.0.0.0:8501

③ 访问API文档

打开浏览器，访问 http://0.0.0.0:8080/docs 或者 http://0.0.0.0:8080/redoc

手动部署 📦

视频教程

• 完整的使用演示：https://v.douyin.com/iFhnwsKY/
• 如何在Windows上部署：https://v.douyin.com/iFyjoW3M

① 创建虚拟环境

推荐使用 uv 管理 Python 环境和依赖，默认使用 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 安装方式兼容使用

② 安装好 ImageMagick

• Windows:

  • 下载 https://imagemagick.org/script/download.php 选择Windows版本，切记一定要选择 静态库 版本，比如 ImageMagick-7.1.1-32-Q16-x64-static.exe
  • 安装下载好的 ImageMagick，注意不要修改安装路径
  • 修改 配置文件 config.toml 中的 imagemagick_path 为你的 实际安装路径

• MacOS:

  brew install imagemagick
  

• Ubuntu

  sudo apt-get install imagemagick
  

• CentOS

  sudo yum install ImageMagick
  

③ 启动Web界面 🌐

注意需要到 MoneyPrinterTurbo 项目 根目录 下执行以下命令

Windows

uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False

如果你已经手动激活了虚拟环境，也可以直接执行：

webui.bat

MacOS or Linux

uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False

如果你已经手动激活了虚拟环境，也可以直接执行：

sh webui.sh

启动后，会自动打开浏览器（如果打开是空白，建议换成 Chrome 或者 Edge 打开）

④ 启动API服务 🚀

uv run python main.py

如果你已经手动激活了虚拟环境，也可以直接执行：

python main.py

特别感谢 🙏

由于该项目的 部署 和 使用，对于一些小白用户来说，还是 有一定的门槛，在此特别感谢 录咖（AI智能 多媒体服务平台） 网站基于该项目，提供的免费AI视频生成器服务，可以不用部署，直接在线使用，非常方便。

• 中文版：https://reccloud.cn
• 英文版：https://reccloud.com

感谢赞助 🙏

感谢佐糖 https://picwish.cn 对该项目的支持和赞助，使得该项目能够持续的更新和维护。

佐糖专注于图像处理领域，提供丰富的图像处理工具，将复杂操作极致简化，真正实现让图像处理更简单。

启动后，可以查看 API文档 http://127.0.0.1:8080/docs 或者 http://127.0.0.1:8080/redoc 直接在线调试接口，快速体验。

语音合成 🗣

所有支持的声音列表，可以查看：声音列表

2024-04-16 v1.1.2 新增了9种Azure的语音合成声音，需要配置API KEY，该声音合成的更加真实。

字幕生成 📜

当前支持2种字幕生成方式：

• edge: 生成速度快，性能更好，对电脑配置没有要求，但是质量可能不稳定
• whisper: 生成速度慢，性能较差，对电脑配置有一定要求，但是质量更可靠。

可以修改 config.toml 配置文件中的 subtitle_provider 进行切换

建议使用 edge 模式，如果生成的字幕质量不好，再切换到 whisper 模式

注意：

1. whisper 模式下需要到 HuggingFace 下载一个模型文件，大约 3GB 左右，请确保网络通畅
2. 如果留空，表示不生成字幕。

由于国内无法访问 HuggingFace，可以使用以下方法下载 whisper-large-v3 的模型文件

下载地址：

• 百度网盘: https://pan.baidu.com/s/11h3Q6tsDtjQKTjUu3sc5cA?pwd=xjs9
• 夸克网盘：https://pan.quark.cn/s/3ee3d991d64b

模型下载后解压，整个目录放到 .\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 目录下。

当前项目里面放了一些默认的音乐，来自于 YouTube 视频，如有侵权，请删除。

字幕字体 🅰

用于视频字幕的渲染，位于项目的 resource/fonts 目录下，你也可以放进去自己的字体。

常见问题 🤔

❓RuntimeError: No ffmpeg exe could be found

通常情况下，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 为你的实际安装路径即可。

[app]
# 请根据你的实际路径设置，注意 Windows 路径分隔符为 \\
ffmpeg_path = "C:\\Users\\harry\\Downloads\\ffmpeg.exe"

❓ImageMagick的安全策略阻止了与临时文件@/tmp/tmpur5hyyto.txt相关的操作

可以在ImageMagick的配置文件policy.xml中找到这些策略。 这个文件通常位于 /etc/ImageMagick-X/ 或 ImageMagick 安装目录的类似位置。 修改包含pattern="@"的条目，将rights="none"更改为rights="read|write"以允许对文件的读写操作。

❓OSError: [Errno 24] Too many open files

这个问题是由于系统打开文件数限制导致的，可以通过修改系统的文件打开数限制来解决。

查看当前限制

ulimit -n

如果过低，可以调高一些，比如

ulimit -n 10240

❓Whisper 模型下载失败，出现如下错误

LocalEntryNotfoundEror: Cannot find an appropriate cached snapshotfolderfor the specified revision on the local disk and outgoing trafic has been disabled. To enablerepo look-ups and downloads online, pass 'local files only=False' as input.

或者

An error occured 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.

解决方法：点击查看如何从网盘手动下载模型

反馈建议 📢

• 可以提交 issue 或者 pull request。

许可证 📝

点击查看 LICENSE 文件

Star History

MoneyPrinterTurbo 快速上手指南

只需提供一个视频主题或关键词，MoneyPrinterTurbo 即可全自动生成文案、素材、字幕、背景音乐，并合成高清短视频。支持竖屏 (9:16) 和横屏 (16:9) 多种尺寸。

环境准备

系统要求

• 操作系统: Windows 10+ / MacOS 11.0+ / Linux
• 硬件配置: 建议 CPU 4 核及以上，内存 4G 及以上（显卡非必须）
• 网络环境: 需保持网络通畅。若使用 Docker 或手动部署，请确保能访问 GitHub 及外部 API；国内用户建议使用支持直连的大模型服务（如 DeepSeek、Moonshot）。

前置依赖

• Git: 用于克隆代码
• Python: 推荐版本 3.11
• ImageMagick: 用于图像处理（必须安装）
  • Windows: 下载并安装 静态库版本 (如 ImageMagick-7.x.x-Q16-x64-static.exe)，切勿修改安装路径。
  • MacOS: brew install imagemagick
  • Ubuntu/Debian: sudo apt-get install imagemagick
  • CentOS: sudo yum install ImageMagick

---

安装步骤

方式一：一键启动包（仅限 Windows，推荐新手）

1. 下载一键启动包（注意路径不要包含中文、空格或特殊字符）。
2. 双击运行 update.bat 更新到最新代码。
3. 双击运行 start.bat 启动，系统将自动打开浏览器。

方式二：Docker 部署（推荐隔离环境用户）

1. 确保已安装 Docker Desktop。
2. 克隆项目并启动：

   git clone https://github.com/harry0703/MoneyPrinterTurbo.git
   cd MoneyPrinterTurbo
   docker compose up
   

   (注：旧版 Docker 命令为 docker-compose up)
3. 访问 Web 界面：http://0.0.0.0:8501

方式三：手动部署（通用）

1. 克隆代码

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

2. 配置虚拟环境与依赖 推荐使用 uv 进行环境管理：

   uv python install 3.11
   uv sync --frozen
   

   (若不使用 uv，可使用标准 venv: python3.11 -m venv .venv -> source .venv/bin/activate -> pip install -r requirements.txt)

3. 配置文件设置

   • 复制配置模板：cp config.example.toml config.toml
   • 编辑 config.toml：
     • 填入 pexels_api_keys (视频素材源)
     • 选择 llm_provider 并填入对应的 API Key (国内推荐配置 DeepSeek 或 Moonshot)
     • 若为 Windows 且 ImageMagick 未自动识别，需手动指定 imagemagick_path

---

基本使用

1. 启动 Web 界面

在项目根目录下执行：

使用 uv (推荐):

uv run streamlit run ./webui/Main.py --browser.gatherUsageStats=False

或使用脚本:

• Windows: webui.bat
• Mac/Linux: sh webui.sh

启动后浏览器会自动打开界面（若显示空白，请尝试使用 Chrome 或 Edge）。

2. 生成视频

在 Web 界面中操作：

1. 输入主题: 在文本框输入视频关键词（例如：“如何增加生活的乐趣”）。
2. 选择参数:
   • 视频尺寸：竖屏 (9:16) 或 横屏 (16:9)
   • 语音选择：试听并选择合适的 AI 配音
   • 大模型：确认已配置的 LLM 服务商
3. 点击生成: 系统将自动执行文案创作、素材匹配、字幕合成及视频渲染。
4. 下载视频: 生成完成后预览并下载 MP4 文件。

3. 启动 API 服务（可选）

若需通过代码调用，可启动后端服务：

uv run python main.py

访问文档地址进行调试：http://127.0.0.1:8080/docs