liyupi/ai-promo-video-maker

一句话让 AI 帮你做产品宣传片！把产品名或网址告诉 Cursor、Claude Code、Codex 等 AI 编程工具，它会自己调研产品、画出多种风格样图让你挑选、截取 4K 真实页面、按音乐节拍卡点剪辑、生成 AI 旁白并逐句转写校验、自动审图，最后交付一支 4K 商业宣传视频和可在线播放的网页版。App、网站、SaaS、开源项目、课程、AI 模型都能做，你只需确认需求、试听配乐。不用学剪辑软件，也不用花钱找外包。基于 Remotion + ElevenLabs，可直接克隆使用，也能一键安装为 Agent Skill。

ai‑promo‑video‑maker – AI‑driven product promo video generator

One‑sentence description – Tell an LLM what you want to promote and it will research, ask follow‑up questions, capture screenshots, compose music, generate voice‑overs, edit, and deliver a 4K commercial video.

What it is

A self‑contained workflow that turns a short textual brief into a finished promotional video. The core logic lives in AGENTS.md, a detailed specification that an AI‑coding assistant (Claude, Cursor, Codex, etc.) can read and execute. The repo ships a Remotion video‑project template plus a collection of helper scripts (Python, Node, Playwright, FFmpeg) that automate:

Product research and style suggestion
Generation of sample key‑frames for each style
4K screenshot capture of the product’s UI
Music selection/composition (ElevenLabs or free Mixkit library)
Voice‑over synthesis (ElevenLabs optional)
Scene assembly, timing checks, and final rendering
Multi‑step validation (subtitle readability, brand‑name spelling, audio‑mix levels)

The tool can be used by cloning the repo or installed as a Vercel “Skill” so any project can invoke it with a single command like “make a promo video for this repo”.

Key features (as described in the README)

Natural‑language entry – a single sentence is enough to start the whole pipeline.
AI‑guided style exploration – the system proposes 3‑4 distinct visual styles, renders a sample frame for each, and lets the user pick or mix them.
Automated 4K UI capture – Playwright‑driven screenshots of any web page (including login‑protected pages) at 3840×2160.
Audio generation – optional ElevenLabs TTS & music‑by‑AI; fallback to free, commercial‑safe Mixkit tracks.
Rigorous timing & audio checks – subtitle‑readability thresholds, automatic re‑render of only changed parts on revisions.
Remotion‑based rendering – leverages the open‑source Remotion framework for programmatic video creation.
Skill integration – can be added to Claude Code, Cursor, Codex, etc. via npx skills add for on‑the‑fly use inside any codebase.
Extensive documentation – AGENTS.md (workflow spec), references/ (pitfalls, case studies), and sample output directories.

Quick start (from the README)

Prerequisites – Node ≥ 18, Python ≥ 3.9, FFmpeg, and a browser engine for Playwright.

Clone & install

git clone https://github.com/liyupi/ai-promo-video-maker.git
cd ai-promo-video-maker
pip install -r template/requirements.txt
playwright install chromium

Run the health‑check script (optional) to verify the environment:
```
python3 template/scripts/doctor.py
```
Open the folder in an AI‑coding assistant (Cursor, Claude Code, etc.) and issue a natural‑language command such as:
```
给我的开源项目做一支 1 分钟的介绍视频，仓库地址是 https://github.com/xxx/yyy
```
The AI will:
- Research the product
- Propose style frames for you to choose
- Capture screenshots, generate music/voice, assemble scenes
- Render a 4K video into outputs/<project‑name>/

Skill installation (optional)

npx skills add liyupi/ai-promo-video-maker -g

After that, any project can trigger the skill with the same natural‑language prompt; the output will be placed in a 宣传片/ folder.

Configuration notes

ElevenLabs – add an API key in .env (or set ELEVENLABS_API_KEY) to enable AI‑generated narration and custom music.
Fallback – without ElevenLabs the system uses free Mixkit tracks and on‑screen subtitles instead of voice‑over.
Supported models – the README recommends Claude Opus 5.5 or newer for best results because the workflow needs long‑context reasoning and aesthetic judgment.

License

MIT (see LICENSE).

Who might use it

Indie developers who want a polished promo video without hiring a studio.
Open‑source maintainers looking for a quick showcase of their project.
Marketing teams that need a fast, repeatable way to generate product‑specific videos for social platforms (e.g., TikTok, YouTube Shorts).

Bottom line

ai-promo-video-maker is a fully‑functional, open‑source pipeline that combines LLM‑driven planning with automated video production tools to turn a brief description of any software product into a ready‑to‑publish 4K promotional video.