Automated Video Generator

Quick Start — 5 Minutes to Your First Video

Choose the path that fits your setup. The agentic pipeline is the recommended way — zero API keys, fully offline.

🪟 Windows Desktop App (2 minutes)

Download the latest Windows installer
Double-click the .exe file
The app launches the web portal at http://localhost:3001
Paste a script → Click Generate Video → Done

No Node.js, Python, or terminal needed. Everything is bundled.

🤖 Agentic Pipeline — Any Platform (1 minute)

# Clone (one-time)
git clone https://github.com/itsPremkumar/Automated-Video-Generator.git
cd Automated-Video-Generator
npm install

# Generate your first video — no API keys needed
npm run agentic -- --topic "5 benefits of drinking water" --orientation portrait

Output lands in workspace/jobs/job_<id>/render/job_<id>.mp4.

📜 One-Click Launcher — Windows (3 minutes)

.\Start-Automated-Video-Generator.bat

Or use PowerShell:

.\Start-Automated-Video-Generator.ps1

What it does automatically:

Installs Node.js and Python if missing (via winget)
Creates .env from .env.example
Installs all dependencies
Starts the portal at http://localhost:3001

🛠️ Manual Setup — All Platforms (5 minutes)

# 1. Clone
git clone https://github.com/itsPremkumar/Automated-Video-Generator.git
cd Automated-Video-Generator

# 2. Install
npm install
pip install -r requirements.txt
cp .env.example .env

# 3. Add an API key (optional — Openverse works without one)
# Edit .env and set PEXELS_API_KEY=your_key

# 4. Start
npm run dev

Open http://localhost:3001/ → Paste a script → Generate.

🐳 Docker (3 minutes)

docker run -p 3001:3001 \
  -v "$(pwd)/input:/app/input" \
  -v "$(pwd)/output:/app/output" \
  ghcr.io/itspremkumar/automated-video-generator

📦 npm / MCP Server (1 minute)

npx automated-video-generator

Connect Claude Desktop or Claude Code for AI-driven video creation.

Next Steps

See the full CLI Reference for all 50+ commands and flags
Enable GPU acceleration: npm run agentic -- --topic "..." --gpu
Dry-run to preview: npm run agentic -- --topic "..." --dry-run
Batch generate: npm run agentic:generate -- --topics "Topic A,Topic B"
Clean temp workspaces: npm run agentic:clean

⚡ Generate Your First Video

Via Web Portal

Open http://localhost:3001
Save your PEXELS_API_KEY (or skip — Openverse works without one)
Paste this script:

Did you know that honey never spoils? Archaeologists have found pots of honey in ancient Egyptian tombs that are over 3,000 years old and still perfectly edible. The secret lies in honey's unique chemical composition — it's naturally acidic and low in moisture, creating an environment where bacteria simply cannot survive.

Click Generate Video
Wait for the progress to reach 100%
Watch or download your MP4

Via CLI

Create input/scripts/input-scripts.json:

[
  {
    "id": "quickstart-demo",
    "title": "My First Video",
    "orientation": "portrait",
    "language": "english",
    "script": "This is my first automated video. It was generated from a simple text script using free and open-source tools."
  }
]

Run:

npm run generate

Find your video in output/quickstart-demo/final.mp4.

Next Steps

This site is open source. Improve this page.