franklin-tech-engi/video-editor-agent

Analysis updated 2026-05-18

★ 0PythonAudience · vibe coderComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((video-editor-agent))
    What it does
      Chains video editing tools
      Automates cutting and voiceover
      Organizes assets by folder
    Tech stack
      FFmpeg
      Remotion
      ElevenLabs
      fal.ai
      Claude Code
    Use cases
      Cut and assemble raw footage
      Add AI generated voiceover
      Prep clips for manual polish
    Audience
      Video editors
      Chinese-speaking creators
    Setup
      One setup script
      Needs ElevenLabs API key
      Needs FFmpeg and uv

mindmap root((video-editor-agent)) What it does Chains video editing tools Automates cutting and voiceover Organizes assets by folder Tech stack FFmpeg Remotion ElevenLabs fal.ai Claude Code Use cases Cut and assemble raw footage Add AI generated voiceover Prep clips for manual polish Audience Video editors Chinese-speaking creators Setup One setup script Needs ElevenLabs API key Needs FFmpeg and uv

What do people build with it?

USE CASE 1

Automate cutting and assembling raw video footage into segments.

USE CASE 2

Generate AI voiceover for a video using ElevenLabs.

USE CASE 3

Convert footage to vertical 9:16 format for short-form content.

What is it built with?

PythonFFmpegRemotionElevenLabsfal.aiClaude Code

How does it compare?

	franklin-tech-engi/video-editor-agent	0xallam/my-recipe	0xhassaan/nn-from-scratch
Stars	0	—	0
Language	Python	Python	Python
Last pushed	—	2022-11-22	—
Maintenance	—	Dormant	—
Setup difficulty	moderate	moderate	moderate
Complexity	3/5	2/5	4/5
Audience	vibe coder	general	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs FFmpeg, the uv tool, Claude Code, and an ElevenLabs API key for voiceover features.

The README does not state a license, so terms of reuse are unclear.

In plain English

video-editor-agent is a workbench for editing video with help from AI tools, built for a Chinese-speaking audience since its documentation is written in Chinese. It chains together several tools into one pipeline: FFmpeg handles precise cutting and joining of clips, Remotion handles programmable overlays and templates, ElevenLabs generates voiceover and narration, fal.ai generates AI media assets, and the final polish is left to manual editing in tools like Descript or CapCut. Setup is a single shell script that checks for and installs FFmpeg, the uv Python tool, and Claude Code, then creates the project's folders and a configuration file, and runs a health check. The script can be run again safely since it skips anything already installed. To actually use it, you set an ElevenLabs API key as an environment variable if you want voiceover, then start the Claude Code assistant and follow its prompts. The project organizes files into folders: raw footage and recordings, FFmpeg-cut segments, ElevenLabs voiceover audio, fal.ai generated media, the final output videos, the Remotion composition project, and any helper scripts. ElevenLabs is connected through the Model Context Protocol using a package called elevenlabs-mcp, while fal.ai is used through a separate skill rather than MCP, and FFmpeg and Remotion are used directly as command line tools. The README also includes a short cheat sheet of common FFmpeg commands for this workflow, covering cutting a clip by timestamp, converting video to a vertical 9:16 format, detecting silence to find places to cut, normalizing loudness, and concatenating clips together.

Copy-paste prompts

Prompt 1

Walk me through running the setup.sh script for video-editor-agent and what it installs.

Prompt 2

Explain how the ElevenLabs MCP connection works in this project and what API key I need.

Prompt 3

Show me the FFmpeg commands from this repo for detecting silence and normalizing loudness.

Prompt 4

Help me organize a new video project using this repo's raw, segments, and output folder structure.

Frequently asked questions

What is video-editor-agent?

A Chinese-language AI video editing workbench chaining FFmpeg, Remotion, ElevenLabs, and fal.ai for cutting, overlays, voiceover, and generated media.

What language is video-editor-agent written in?

Mainly Python. The stack also includes Python, FFmpeg, Remotion.

What license does video-editor-agent use?

The README does not state a license, so terms of reuse are unclear.

How hard is video-editor-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is video-editor-agent for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.