Moneyprinterturbo

SETUP GUIDE – VERIFIED MAY 28, 2026

MoneyPrinterTurbo, Hermes Agent,

Telegram, and Remotion

A practical installation and configuration guide for the MoneyPrinterTurbo GitHub project, with supporting instructions for Hermes Agent on Windows and macOS, Telegram access, and Remotion basics.

Before You Start

MoneyPrinterTurbo is the main tool in this guide. It is an AI-assisted short-video generator: you give it a topic, text, or script; it uses an LLM plus stock media, text-to-speech, subtitles, and video processing to generate a publishable video draft. Important: this tool can help automate video production, but it does not guarantee income. Use it as a production workflow, not as a literal money-making promise. Also check copyright, stock-media terms, platform policies, and disclosure requirements before uploading videos commercially.

Tool Use it for Required accounts or keys

MoneyPrinterTurbo Generating AI short videos from

topics, scripts, and stock video assets.

Pexels or Pixabay key, plus an LLM

provider key such as OpenAI, Gemini,

DeepSeek, Qwen, Ollama, LiteLLM, or

another supported provider.

Hermes Agent A persistent AI agent that can run

from CLI or messaging apps and can

operate tools, memory, and scheduled tasks.

Provider setup through Nous Portal,

OpenRouter, OpenAI, Anthropic,

Ollama, or another supported provider.

Telegram bot Talking to Hermes Agent from your

phone or group chat.

BotFather token and your numeric

Telegram user ID.

Remotion Building videos programmatically

with React, then rendering MP4/WebM outputs.

Node.js. Commercial users should

review Remotion license requirements.

Part 1 – Install MoneyPrinterTurbo

Recommended path by system

System Recommended setup

Windows

beginner Use the one-click package from the project README, run update.bat, then start.bat. This is easiest, but the bundled package may lag behind the latest code until updated.

Windows

advanced Use Docker Desktop with WSL2, or use the manual Python setup in PowerShell. macOS Use the manual uv setup. Docker is also fine if you want isolation. Linux/VPS Use Docker for the simplest service deployment, or uv for direct local control.

Prerequisites

Git.
Python 3.11 if using manual setup.

uv for the current recommended Python dependency setup.

Docker Desktop if using Docker.

ImageMagick. On Windows, you must set imagemagick_path in config.toml. A stock video API key: Pexels or Pixabay. An LLM key or endpoint. First-time users can start with OpenAI-compatible, Gemini, DeepSeek, Qwen, Ollama, or LiteLLM depending on what they already have.

Option A – Windows one-click package

1. Open the MoneyPrinterTurbo README and download the Windows one-click package link listed

there.

1. Extract the package to a simple path, for example C:\Tools\MoneyPrinterTurbo.
2. Double-click update.bat first so the older bundled package updates to the current code.
3. Double-click start.bat.
4. If the browser opens blank, try Chrome or Edge and visit http://127.0.0.1:8501.

Option B – Docker deployment

Docker is the cleanest repeatable deployment because the Python environment is isolated. On Windows,

install WSL2 and Docker Desktop first.

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

cp config.example.toml config.toml

# Edit config.toml before generating real videos.
docker compose up

Then open

Web UI: http://127.0.0.1:8501

API docs: http://127.0.0.1:8080/docs

Alternative API docs: http://127.0.0.1:8080/redoc

Option C – Manual setup with uv

This path follows the current README recommendation for macOS, Linux, and advanced Windows users.

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

cp config.example.toml config.toml uv python install 3.11 uv sync –frozen Manual setup without uv Use this only if you cannot use uv. The project now treats pyproject.toml and uv.lock as the main dependency manifests; requirements.txt is the legacy fallback. python3.11 -m venv .venv

source .venv/bin/activate
pip install -r requirements.txt

Install ImageMagick

System Command or action

Windows Download the static Windows installer from ImageMagick. Install it, then set

imagemagick_path in config.toml, for example C:\\Program

Files\\ImageMagick-7.1.1-Q16\\magick.exe.

macOS brew install imagemagick

Ubuntu/Debian sudo apt-get install imagemagick

CentOS/RHEL sudo yum install ImageMagick

Part 2 – Configure MoneyPrinterTurbo

Create your config

cd MoneyPrinterTurbo

cp config.example.toml config.toml Open config.toml in a text editor. Do not commit this file to a public repository after adding keys.

Minimum working configuration

Setting What to enter

video_source Use "pexels" or "pixabay". pexels_api_keys or pixabay_api_keys Enter one or more API keys in a TOML array, for example ["key1","key2"]. llm_provider Pick the provider you will actually configure: openai, gemini, deepseek, qwen, ollama, litellm, and others are listed in the example config. Provider key and model Set the matching key and model name, such as openai_api_key plus openai_model_name, or gemini_api_key plus gemini_model_name. subtitle_provider Use "edge" for faster subtitles. Use "whisper" only if you are ready to download and run a larger Whisper model. imagemagick_path Required on Windows if auto-detection fails. macOS/Linux usually auto- detect after installation.

Example OpenAI-compatible setup

video_source = "pexels"

pexels_api_keys = ["YOUR_PEXELS_KEY"]

llm_provider = "openai"

openai_api_key = "YOUR_API_KEY"

openai_base_url = "" openai_model_name = "gpt-4o-mini" subtitle_provider = "edge"

Run the web UI

cd MoneyPrinterTurbo

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

If you activated a virtual environment manually, the helper scripts are also available: webui.bat # Windows

sh webui.sh # macOS or Linux

Run the API server

cd MoneyPrinterTurbo

uv run python main.py Then open http://127.0.0.1:8080/docs and use the interactive API docs to test endpoints.

Common problems

Symptom Likely fix

No stock videos found Check video_source and the matching Pexels/Pixabay API key array. Make sure keys are quoted. LLM errors Confirm llm_provider, API key, base URL, and model name belong to the same provider.

ImageMagick error on

Windows

Install the static ImageMagick build and set imagemagick_path to the real magick.exe path. FFmpeg not found The project usually downloads/detects FFmpeg automatically. If it fails, install FFmpeg manually and set the path described in config.toml. Whisper subtitles are slow Use subtitle_provider = "edge" unless you specifically need Whisper accuracy and have enough disk/compute.

Part 3 – Install Hermes Agent

Hermes Agent is a separate Nous Research project. It is useful here because you can run an always-on

personal agent from CLI or Telegram and ask it to manage workflows, call APIs, monitor jobs, or run shell commands. It is not built into MoneyPrinterTurbo by default.

macOS install

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-

agent/main/scripts/install.sh | bash

source ~/.zshrc
hermes setup

During setup, choose your model provider. The fastest official path is Nous Portal:

hermes setup --portal

After setup, test the CLI

hermes
# or
hermes --tui

Windows install – recommended WSL2 path

1. Install WSL2 with Ubuntu from Microsoft instructions.
2. Open Ubuntu, not PowerShell, for this path.
3. Run the Linux/macOS installer inside Ubuntu:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-

agent/main/scripts/install.sh | bash

source ~/.bashrc
hermes setup

Windows install – native PowerShell early beta

Native Windows support exists, but the project labels it early beta. Use WSL2 if you want the most tested Windows route.

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-

agent/main/scripts/install.ps1)

hermes setup

Basic Hermes configuration

hermes model # choose or switch provider/model
hermes tools # configure enabled tools
hermes config show # inspect configuration
hermes doctor # diagnose setup problems
hermes update # update to latest version
Hermes stores secrets and tokens separately from normal settings:

Secrets: ~/.hermes/.env Normal config: ~/.hermes/config.yaml

Part 4 – Connect Hermes Agent to Telegram

Create the Telegram bot

1. Open Telegram and message @BotFather.
2. Run /newbot.
3. Choose a display name and bot username.
4. Copy the bot token. Treat it like a password.
5. Message @userinfobot or @get_id_bot and copy your numeric Telegram user ID.

Configure Telegram through the wizard

hermes gateway setup

Select Telegram, paste the BotFather token, and enter your allowed Telegram user ID. Start with a private DM before adding groups.

Manual Telegram configuration

If you need to configure by hand, add values to ~/.hermes/.env

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Start and verify the gateway

hermes gateway # run in foreground
# or, after installing a service:
hermes gateway start
hermes gateway status

Send your bot a Telegram message such as /status or Hello. If it replies, the bridge works. Keep the gateway running

System Commands

macOS hermes gateway install, then hermes gateway start. Logs are at

~/.hermes/logs/gateway.log.

Linux or WSL2

hermes gateway install, then hermes gateway start. For a VPS that must

survive logout/reboot, review the system service option. Native

Windows

Use foreground mode first. Because native Windows support is early beta, use WSL2 for a more predictable always-on gateway.

Security rules

Do not use GATEWAY_ALLOW_ALL_USERS=true for a bot that can run terminal commands. Always set TELEGRAM_ALLOWED_USERS for private use. For groups, explicitly decide which users or chats can invoke the bot. If group messages do not reach the bot, check BotFather privacy mode and whether the bot has the needed group permissions.

Optional workflow: ask Telegram/Hermes to control MoneyPrinterTurbo

There is no official one-click MoneyPrinterTurbo-to-Hermes integration. A practical workflow is:

1. Run MoneyPrinterTurbo API locally or on a VPS.
2. Verify http://127.0.0.1:8080/docs works.
3. Ask Hermes in Telegram to call the API, monitor task status, and send you the final video file path or

download link.

1. If Hermes runs inside Docker or another sandbox, make sure the generated video output path is

readable by the Hermes gateway process before trying to send it through Telegram.

Part 5 – What Remotion Is and How to Use It Remotion is a React-based framework for making videos with code. Instead of editing every frame manually in a traditional video editor, you write React components, pass data into them, preview the timeline in a browser, and render a real MP4 or another output format.

When Remotion helps

Reusable branded video templates. Videos generated from APIs, spreadsheets, product catalogs, or social posts. Automated captions, lower thirds, charts, screenshots, and motion graphics. Large batches of personalized videos.

Create a Remotion project

npx create-video@latest --yes --blank my-video
cd my-video
npm i
npm run dev

The Remotion docs recommend the Hello World template for first-time users. The blank template is useful if you already know React. Render a video

npx remotion render

For explicit entry point, composition ID, and output file

npx remotion render src/index.ts MyComposition out/video.mp4

Pass data into a render Remotion supports props. On Windows, prefer a JSON file instead of inline JSON because shell quoting often strips quotes.

npx remotion render src/index.ts MyComposition out/video.mp4 --props=./props.json

How Remotion relates to MoneyPrinterTurbo

MoneyPrinterTurbo is the ready-made AI short-video generator. Remotion is a lower-level programmable video framework. Use MoneyPrinterTurbo when you want a working AI video workflow quickly. Use Remotion when you want custom video templates, stricter branding, data-driven rendering, or a product that generates videos at scale.

Suggested End-to-End Setup

1. Install MoneyPrinterTurbo locally with uv or Docker.
2. Configure Pexels/Pixabay and one LLM provider in config.toml.
3. Run the web UI and generate one short test video.
4. Run the API server and confirm /docs opens.
5. Install Hermes Agent and complete hermes setup or hermes setup –portal.
6. Configure Telegram with hermes gateway setup.
7. Ask Hermes from Telegram to check the MoneyPrinterTurbo server, create a test prompt, and report

when the output video is ready.

1. Use Remotion only when you need custom, code-driven video templates beyond the default

MoneyPrinterTurbo workflow.

Source Links

MoneyPrinterTurbo GitHub README: https://github.com/harry0703/MoneyPrinterTurbo/blob/main/README- en.md

MoneyPrinterTurbo example config

https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/config.example.toml

Hermes Agent GitHub README: https://github.com/NousResearch/hermes-agent
Hermes quickstart: https://github.com/NousResearch/hermes-agent/blob/main/website/docs/getting-

started/quickstart.md

Hermes messaging gateway docs: https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-

guide/messaging/index.md

Hermes Telegram docs: https://github.com/NousResearch/hermes-agent/blob/main/website/docs/user-

guide/messaging/telegram.md Remotion homepage: https://www.remotion.dev/ Remotion installation docs: https://www.remotion.dev/docs/

Remotion render CLI docs: https://www.remotion.dev/docs/cli/render