Partnering Automation

ShortsAgent

Upload a video → get viral-ready clips, auto-cropped & scored

1
Download the Python agent file from this repository
Click the button below — it's the brain that does all the work
⬇ Download combined_agent.py
2
Save it to a folder on your computer
Example: C:\Users\You\ShortsAgent\ or ~/ShortsAgent/
3
Put your video in that same folder
The video file and combined_agent.py must be side by side in the same folder
4
Open Command Prompt and go to that folder
Type cd C:\Users\You\ShortsAgent and press Enter
5
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

🔑 Get yours free at aistudio.google.com

3

⏱ 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: