快速开始 🚀

安装部署 📥

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

① 创建虚拟环境

推荐使用 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 安装方式兼容使用

② 启动Web界面 🌐

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

###### Windows

.\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 or 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

视频演示 📺

推荐使用方式

• 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 打开）

配置要求 📦

• 建议系统：Windows 10 或 MacOS 11.0 以上，或主流 Linux 发行版
• GPU 不是必需项，但如果你希望本地转录、更快的视频处理或更顺畅的批量生成体验，建议使用带显存的独立显卡

• 如果你主要依赖云端 LLM、云端 TTS 和在线素材源，CPU 与内存比 GPU 更重要
• 如果你启用 faster-whisper、批量生成或更重的本地处理链路，GPU 会明显提升速度

请根据你的实际路径设置，注意 Windows 路径分隔符为 \\

ffmpeg_path = "C:\\Users\\harry\\Downloads\\ffmpeg.exe" ```

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

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.

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

常见问题 🤔