performance-marketing

Polished Ads with agentic-video-editor

Name: Polished Ads with agentic-video-editor
Author: poseljacob

Get polished video ads from raw footage with agentic-video-editor, ideal, using AI agents.

468 stars60 forksPythonGuide quality 9/10Updated 8/5/2026100% free · open source

What it does

The agentic-video-editor turns raw footage and a creative brief into a polished ad using an ensemble of AI agents, including Google Gemini and FFmpeg.

When to use it

•When creating social media ads and need a quick, automated editing solution
•When experimenting with AI-generated video content for brand awareness campaigns
•When outsourcing video editing tasks to free up in-house resources for high-level creative decisions

Ready-to-paste prompt

python main.py --input-footage=/Users/username/Videos/raw_footage.mp4 --creative-brief=/Users/username/Documents/creative_brief.txt --output=/Users/username/Desktop/output.mp4

Heads up: First-time users need a Google Cloud account with the Google Gemini API enabled and a valid API key, which must be set as an environment variable (`GOOGLE_GEMINI_API_KEY`) before running the editor

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/agentic-video-editor && curl -fsSL https://workflowstacks.com/api/skills/agentic-video-editor/claude-skill -o ~/.claude/skills/agentic-video-editor/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Polished Ads with agentic-video-editor works

Codeflow

Free to inspect

Polished Ads with agentic-video-editor is a large Python project (~16k lines across 68 code files, plus 8 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit 5 months ago, MIT license, has a test suite.

Size

Large codebase

~16k lines · 68 code files · ~2 h to skim

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Python

Needs API keys (.env)

Python 54%JavaScript 24%TypeScript 12%HTML 10%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
src/main.py
Where the program starts running
3
pyproject.toml
Dependencies and the commands it exposes
4
.env.example
The API keys and settings you must provide
5
src/__init__.py
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic84 files

pipelines/Workflows / pipelines1 files

styles/Themes & styling1 files

tests/Tests — proof it works8 files

.claude/Editor / agent settings4 files

READMEHas testsDocumentedNo CIMIT licenseUpdated 5 mo ago