explaingit

moh4696/freecut

Analysis updated 2026-05-18

60PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A free, open-source AI video editor controlled by chatting with Claude Code or Codex: drop raw footage in a folder, describe the edit, and get final.mp4 back with no paid API keys required.

Mindmap

mindmap
  root((freecut))
    What it does
      Chat-driven editing
      Filler word removal
      Subtitle burning
      Color grading
    Transcription
      Whisper local free
      VibeVoice diarization
      ElevenLabs paid
    Pipeline
      Transcribe clips
      Pack to text
      LLM edits and approves
      Render and self-eval
    Setup
      Clone and uv sync
      Install ffmpeg
      No API key needed
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Edit a talking-head video by chatting with Claude Code to cut filler words, dead air, and bad takes automatically

USE CASE 2

Produce a tutorial or launch video with subtitles, color grading, and smooth audio fades without touching a timeline editor

USE CASE 3

Transcribe and edit interview footage with multiple speakers using a local GPU and VibeVoice diarization

USE CASE 4

Set up a reusable AI video editing skill in Claude Code that persists project memory across sessions

What is it built with?

PythonffmpegWhisperClaude Codemlx-whisperfaster-whisper

How does it compare?

moh4696/freecut0xh4ku/manga-pdf-to-epubayyouboss0011/sherlockmaps
Stars606060
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencevibe codergeneraldata

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires ffmpeg installed on your system, multi-speaker diarization needs a CUDA GPU or a remote VibeVoice endpoint.

MIT license -- use, modify, and distribute freely including for commercial purposes, as long as you keep the copyright notice.

In plain English

freecut is a fork of an open-source project called video-use that lets you edit video files by chatting with an AI coding assistant like Claude Code or Codex. The original project required a paid ElevenLabs speech transcription API key. freecut removes that requirement by replacing the transcription layer with free alternatives that run locally on your machine. The editing process works like this: you point the tool at a folder of raw video clips, open your AI assistant in that folder, and describe what you want. The assistant reads the transcripts, builds an edit list, waits for your approval, then calls ffmpeg to produce a final video file called final.mp4. It never watches the actual video frames directly. Instead it reads a compact text transcript of every word spoken, with timestamps, so it can make precise cuts based on speech boundaries without processing thousands of video frames. The default transcription backend is Whisper, a free, open-source speech-to-text model from OpenAI that runs entirely on your own computer with no API key needed. For videos with multiple speakers, an optional backend called VibeVoice-ASR can identify who is talking when, but this requires a machine with an NVIDIA GPU and is not available on most Macs. The original ElevenLabs backend is still supported if you already have a key. Beyond cutting, freecut can remove filler words and dead air, apply color grading, add subtitles, and burn in animation overlays. After each render it checks its own output at every cut point before showing you the result, and it saves notes about your project so a later session can pick up where you left off. Installation takes a few minutes: clone the repo, install Python dependencies with uv or pip, install a Whisper package, and ensure ffmpeg is on your system. No API keys are required for the default local-Whisper setup.

Copy-paste prompts

Prompt 1
Set up freecut in Claude Code for me: read install.md, install mlx-whisper on Apple Silicon, register the skill, and tell me when it's ready to accept footage
Prompt 2
I have 10 raw talking-head clips in ~/Videos/launch/. Edit them into a 2-minute launch video, cut filler words and dead air, add 2-word uppercase subtitles, and output final.mp4
Prompt 3
How does freecut represent a video transcript for the LLM and why does it use a text file instead of processing video frames?
Prompt 4
I want multi-speaker diarization with freecut using VibeVoice. What do I need to set up and what endpoint format does the backend expect?
Prompt 5
Explain freecut's self-eval loop: what does it check at each cut boundary before showing me the preview, and how many times will it retry a bad cut?

Frequently asked questions

What is freecut?

A free, open-source AI video editor controlled by chatting with Claude Code or Codex: drop raw footage in a folder, describe the edit, and get final.mp4 back with no paid API keys required.

What language is freecut written in?

Mainly Python. The stack also includes Python, ffmpeg, Whisper.

What license does freecut use?

MIT license -- use, modify, and distribute freely including for commercial purposes, as long as you keep the copyright notice.

How hard is freecut to set up?

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

Who is freecut for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub moh4696 on gitmyhub

Verify against the repo before relying on details.