whatisgithub

What is cutclaw?

gvclab/cutclaw — explained in plain English

Analysis updated 2026-05-18

831PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

An AI tool that automatically edits raw video footage and music into a finished montage from a plain text instruction.

Mindmap

mindmap
  root((cutclaw))
    What it does
      AI video editing
      Text instruction to montage
    Tech stack
      Python
      LiteLLM
      Streamlit
    Use cases
      Auto edit to the beat
      Auto crop for social media
      Multi agent editing pipeline
    Audience
      Content creators
      Video editors

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

Turn raw footage and a music track into a beat-synced montage automatically

USE CASE 2

Auto-crop clips to fit different social media aspect ratios

USE CASE 3

Generate a video edit from a plain text style instruction like 'fast-paced montage'

What is it built with?

PythonLiteLLMStreamlit

How does it compare?

gvclab/cutclawywnd1144/gopay_plus_automaticdjango/django-localflavor
Stars831918919
LanguagePythonPythonPython
Last pushed2026-06-23
MaintenanceActive
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencegeneralgeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an LLM API key via LiteLLM for the AI editing agents.

So what is it?

CutClaw is an AI-powered video editing tool that takes hours of raw footage and a music track and automatically assembles them into a polished montage. Instead of manually scrubbing through footage and cutting clips to match the beat, you give CutClaw your video files and an instruction in plain text, something like "fast-paced character montage" or "slow emotional narrative", and it handles the rest. The system works through a multi-agent pipeline, which means several AI modules work together in stages: first, it analyzes and "deconstructs" all the raw video and audio into labeled, searchable clips, next, a planning agent decides which shots to use and in what order, then another agent picks the exact timestamps for each cut and validates the result before rendering the final video. Music synchronization is central to how cuts are timed, the tool extracts the beats and energy patterns from the audio track and uses them to decide where cuts should land. There is also a smart auto-cropping feature that detects the main subject in each clip and adjusts the frame to fit different aspect ratios (useful for social media formats). You run it either through a web interface (a Streamlit app in your browser) or via command line. It is built in Python and powered by LiteLLM (a layer that lets you connect different AI language models). The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me set up CutClaw's Streamlit interface to edit a batch of clips
Prompt 2
Explain how CutClaw's multi-agent pipeline decides which shots to use
Prompt 3
Show me how to run CutClaw from the command line with a music sync instruction
Prompt 4
How does CutClaw's auto-cropping feature detect the main subject in a clip?

Frequently asked questions

What is cutclaw?

An AI tool that automatically edits raw video footage and music into a finished montage from a plain text instruction.

What language is cutclaw written in?

Mainly Python. The stack also includes Python, LiteLLM, Streamlit.

How hard is cutclaw to set up?

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

Who is cutclaw for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.