Shorts Agent — Clip Automation

Download the Python agent file from this repository

Click the button below — it's the brain that does all the work

Save it to a folder on your computer

Example: C:\Users\You\ShortsAgent\ or ~/ShortsAgent/

Put your video in that same folder

The video file and combined_agent.py must be side by side in the same folder

Open Command Prompt and go to that folder

Type cd C:\Users\You\ShortsAgent and press Enter

Fill in your API key and clip count below, then copy the command and paste it in your terminal

The agent will run and your Shorts-ready clips will appear in the same folder

// config

Gemini API Key required

🔑 Get yours free at aistudio.google.com

Number of clips to make 1 – 10

⏱ Each clip is 30 seconds, vertical (1080×1920)

// what this agent does

01 Scores audio energy + scene changes across your video

02 Asks Gemini AI to pick the best moments for viral clips

03 Cuts, crops to 1080×1920, adds hook text & mixes mood-matched music

04 Generates YouTube Shorts metadata (title, hashtags, hook) — copy-paste ready

⚙ Runs locally via Python + ffmpeg — this page just launches the agent

// upload video

🎬

Drop your video here or click to browse

MP4, MOV, AVI · max 4 GB

🔑 Key: 📎 Clips: