MoneyPrinterTurbo

repository·main·Indexed 10 days ago

https://github.com/harry0703/moneyprinterturbo

An automated AI-driven pipeline for creating short-form videos from prompts, local assets, subtitles, and TTS. It handles scriptwriting, asset sourcing, voiceover, and final assembly with support for multiple LLM providers and cross-platform publishing to TikTok, Instagram, and YouTube Shorts. Available via WebUI, API, CLI, and AI Agent.

Tokens
14.1K
Snippets
38
Records
73
Agent score
100%

What's inside MoneyPrinterTurbo

  1. Overview of MoneyPrinterTurbo

    main

    MoneyPrinterTurbo is an all-in-one AI short video generation tool. By providing a video topic or keywords, the tool automatically generates video scripts, matches media assets, generates subtitles and background music, and synthesizes high-definition short videos.

    It offers four primary usage modes:

    • AI Agent
    • WebUI
    • API
    • CLI

    The project is designed with a layered architecture separating controllers, services, and models.

  2. Key features of MoneyPrinterTurbo

    main

    MoneyPrinterTurbo provides a comprehensive suite of video generation features:

    Scripting & Content

    • AI Script Generation: Automatically generates scripts based on topics, or allows for custom scripts.
    • Multi-language Support: Generates video scripts in multiple languages.

    Video Specifications

    • High-Definition Sizes: Supports both vertical (9:16, 1080x1920) and horizontal (16:9, 1920x1080) formats.
    • Batch Generation: Generate multiple videos at once to select the best result.
    • Segment Duration: Adjustable video clip duration to control media switching frequency.

    Audio & Subtitles

    • Voice Synthesis (TTS): Supports Edge TTS, Azure Speech, SiliconFlow, Google Gemini, Xiaomi MiMo, ElevenLabs, and Chatterbox with real-time preview.
    • Subtitles: Customizable fonts, positions, colors, sizes, strokes, and background styles.
    • Background Music: Random selection or specific music with adjustable volume.

    Media & Models

    • Asset Sourcing: Uses local assets or fetches free high-definition media from Pexels, Pixabay, and Coverr.
    • LLM Support: Compatible with major providers like Kimi/Moonshot AI, OpenAI, Google Gemini, DeepSeek, Alibaba Tongyi Qianwen, Microsoft Azure OpenAI, Volcengine Ark, and xAI Grok. It also supports gateways and local environments like Cloudflare AI Gateway, ModelScope, OneAPI, LiteLLM, and Ollama.

    Distribution

    • Cross-platform Publishing: One-click automatic upload to TikTok, Instagram, and YouTube Shorts.
  3. Configure Voice Synthesis Providers

    main

    MoneyPrinterTurbo supports multiple TTS (Text-to-Speech) providers. The default is Edge TTS (labeled as Azure TTS V1 in the WebUI), which is free and requires no API key.

    Supported providers include:

    • Edge TTS (Free)
    • Azure TTS V2 (Requires credentials)
    • SiliconFlow TTS
    • Google Gemini TTS
    • Xiaomi MiMo TTS
    • ElevenLabs TTS
    • Chatterbox TTS (Self-hosted)
    • No-voice mode

    Select your provider and voice in the WebUI. Cloud providers like Azure require you to enter your credentials in the settings.

  4. System Requirements and Hardware Configuration

    main

    MoneyPrinterTurbo is a cross-platform tool (Windows 10, macOS 11.0+, or mainstream Linux). While a GPU is not strictly required, it is highly recommended for local transcription (using faster-whisper), faster video processing, and smoother batch generation. If you rely primarily on cloud-based LLMs, cloud TTS, and online assets, CPU and RAM are more critical than the GPU.

    | Item | Minimum | Recommended | Ideal |
    | ---- | -------- | ----------- | ----- |
    | CPU  | 4 cores  | 6 to 8 cores| 8+ cores |
    | RAM  | 4 GB     | 8 GB        | 16 GB+ |
    | GPU  | Not required | 4 GB VRAM+ | 8 GB VRAM+ |
  5. Launch the WebUI and API Service

    main

    After installation, you can run the different interfaces of the project.

    Launch WebUI

    Windows:

    .\webui.bat

    To allow LAN access, run set MPT_WEBUI_HOST=0.0.0.0 before executing the batch file.

    macOS/Linux:

    sh webui.sh

    To allow LAN access, run: MPT_WEBUI_HOST=0.0.0.0 sh webui.sh.

    Launch API Service

    Run the following command in the project root:

    uv run python main.py

    Accessing Services

    • WebUI: http://127.0.0.1:8501
    • API Docs (Swagger/Redoc): http://127.0.0.1:8080/docs or http://127.0.0.1:8080/redoc
    # Windows LAN access
    set MPT_WEBUI_HOST=0.0.0.0
    .\webui.bat
    
    # macOS/Linux LAN access
    MPT_WEBUI_HOST=0.0.0.0 sh webui.sh
  6. Manual Installation and Setup

    main

    For manual deployment, Python 3.11 or higher is required. It is recommended to use uv for environment management.

    Using uv (Recommended):

    1. Clone the repository.
    2. Install Python 3.11 via uv.
    3. Sync dependencies using uv sync --frozen.

    Using venv and pip:

    1. Create a virtual environment.
    2. Activate it.
    3. Install requirements via pip install -r requirements.txt.
    # Using uv
    git clone https://github.com/harry0703/MoneyPrinterTurbo.git
    cd MoneyPrinterTurbo
    uv python install 3.11
    uv sync --frozen
    
    # Using venv + pip
    python3.11 -m venv .venv
    source .venv/bin/activate
    pip install -r requirements.txt
  7. Install uv for MoneyPrinterTurbo

    main

    MoneyPrinterTurbo requires uv for dependency and environment management. If uv is missing, install it using the following commands based on your operating system.

    # macOS
    curl -LsSf https://astral.sh/uv/install.sh | sh
    # Windows PowerShell
    powershell -ExecutionPolicy ByPass -c "irm https://install.ps1 | iex"
  8. Quick Start: Running in Google Colab

    main

    To bypass local environment configuration and experience MoneyPrinterTurbo immediately, you can run the project in a Google Colab notebook.

    https://colab.research.google.com/github/harry0703/MoneyPrinterTurbo/blob/main/docs/MoneyPrinterTurbo.ipynb
  9. Deploy MoneyPrinterTurbo via Docker

    main

    To deploy using Docker, use the provided docker-compose.release.yml which pulls the pre-built image ghcr.io/harry0703/moneyprinterturbo:latest.

    Before starting, copy config.example.toml to config.toml to ensure the container can mount your configuration.

    Accessing the services:

    cd MoneyPrinterTurbo
    docker compose -f docker-compose.release.yml up
  10. Quick Start: Run in Google Colab

    main

    To try MoneyPrinterTurbo without setting up a local environment, you can run it directly in Google Colab using the official notebook.

    https://colab.research.google.com/github/harry0703/MoneyPrinterTurbo/blob/main/docs/MoneyPrinterTurbo.ipynb
  11. Quick Start: Windows Installation (One-Click Package)

    main

    For the fastest local trial on Windows, use the one-click package:

    1. Download the latest Windows one-click package from the GitHub Releases.
    2. Extract the package.
    3. Recommended: Double-click update.bat first to ensure you are running the latest code.
    4. Double-click start.bat to launch the application.
    5. The browser should open automatically. If it opens a blank page, use Chrome or Edge.
  12. Quick Start: Generate Videos with an AI Agent

    main

    If your AI Agent can read Skill documents and operate a local terminal, you can automate the installation, configuration, and video generation process. This workflow currently supports macOS and Windows. The Agent will install MoneyPrinterTurbo and only ask for required API keys that are not already configured.

    Provide the following prompt to your AI Agent:

    Use this Skill: https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/SKILL.md
    Create a video with the topic "How AI is changing everyday life."