performance-marketing

agentic-video-editor: Turn Footage into Ready‑to‑Run Ads Fast

Name: agentic-video-editor: Turn Footage into Ready‑to‑Run Ads Fast
Author: poseljacob

An AI‑driven video editor that converts raw clips and a brief into polished ads using Google Gemini and FFmpeg. Ideal for performance‑marketing founders seeking rapid, high‑quality video creation.

From the repo · “AI-powered video editor that turns raw footage and a creative brief into a polished ad using an ensemble of AI agents (Google Gemini + FFmpeg)”

502 stars+2★ this week63 forksPythonGuide quality 8/10 · reviewed Oct 22Updated 4/14/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 agentic-video-editor: Turn Footage into Ready‑to‑Run Ads Fast works

Codeflow

Free to inspect

Agentic-video-editor: Turn Footage into Ready‑to‑Run Ads Fast 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 6 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 licenseLast update 6 mo ago

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.

Quick Actions

Details

Creator

poseljacob

Language

Python

Do this with a working workflow

Pages we wrote and tested that put a skill like this to work — importable n8n templates, outcome guides and Claude Desktop configs.

Outcome guide

Automated marketing performance reports

The workflow reads your performance metrics and writes the narrative for you — this week at a glance, what moved and why, what’s next — then sends it on schedule.