以下是翻译后的 Markdown 格式内容:
harry0703 MoneyPrinterTurbo
MoneyPrinterTurbo 💸 简体中文 | English
只需提供一个视频 主题 或 关键词,就可以全自动生成视频文案、视频素材、视频字幕、视频背景音乐,然后合成一个高清的短视频。
- Web 界面
- API 界面
- 🎯 完整的 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
- ▶️ 《如何增加生活的乐趣》
- ▶️ 《金钱的作用》更真实的合成声音
- ▶️ 《生命的意义是什么》
- demo-portrait-1.mp4
- default.mp4
- demo-portrait-2.mp4
横屏 16:9
- ▶️ 《生命的意义是什么》
- ▶️ 《为什么要运动》
- demo-landscape.mp4
- demo-landscape-2.mp4
配置要求 📦
建议系统:Windows 10 或 MacOS 11.0 以上,或主流 Linux 发行版
GPU 不是必需项,但如果你希望本地转录、更快的视频处理或更顺畅的批量生成体验,建议使用带显存的独立显卡。
| 项目 | 最低配置 | 推荐配置 | 理想配置 | |------|----------|----------|----------| | CPU | 4 核 | 6 到 8 核 | 8 核及以上 | | RAM | 4 GB | 8 GB | 16 GB 及以上 | | GPU | 非必须 | 4 GB 显存及以上 | 8 GB 显存及以上 |
- 如果你主要依赖云端 LLM、云端 TTS 和在线素材源,CPU 与内存比 GPU 更重要
- 如果你启用 faster-whisper、批量生成或更重的本地处理链路,GPU 会明显提升速度
快速开始 🚀
推荐使用方式
- 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 系统,请参考微软的文档:
- https://learn.microsoft.com/zh-cn/windows/wsl/install
- 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 --frozenrequirements.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 模式。
注意:whisper 模式下需要到 HuggingFace 下载一个模型文件,大约 3GB 左右,请确保网络通畅。如果留空,表示不生成字幕。
由于国内无法访问 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
│ 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 i